@paragrav/rhf-utils 0.0.111 → 0.0.113

package/README.md

@@ -49,11 +49,12 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
     top: (
       // UseRhfUtilsFormChildrenProps
       {
-        formId, //     unique id string
-        formRef, //    ref
-        context, //    rhf UseFormReturn
-        options, //    RhfUtilsFormOptions
-        Controller, // strongly-typed controller
+        formId, //          unique id string
+        formRef, //         ref
+        context, //         rhf UseFormReturn
+        options, //         RhfUtilsFormOptions
+        Controller, //      strongly-typed controller
+        FormSubmitError, // strongly-typed error class
       },
     ) => {
       // navigation blocker (using custom option)
@@ -117,26 +118,24 @@ Currently, only `zod` is supported.
   }) => {
     onError(error);
   }}
-  // children/fields
+  // fields
   Children={({
     // UseRhfUtilsFormChildrenProps
-    formId, //     unique id string
-    formRef, //    ref
-    context, //    rhf UseFormReturn
-    options, //    RhfUtilsFormOptions
-    Controller, // strongly-typed controller
+    formId, //          unique id string
+    formRef, //         ref
+    context, //         rhf UseFormReturn
+    options, //         RhfUtilsFormOptions
+    Controller, //      strongly-typed controller
+    FormSubmitError, // strongly-typed error class
   }) => (
     <>
       <Controller
         name="email" // strongly-typed field name
         render={({ field, formState: { isSubmitting } }) => (
-          <input
-            autoFocus
-            label="Email"
-            autoComplete="email"
-            disabled={isSubmitting}
-            {...field}
-          />
+          <label>
+            Email
+            <input {...field} disabled={isSubmitting} />
+          </label>
         )}
       />
 
@@ -151,7 +150,9 @@ Currently, only `zod` is supported.
 If you prefer to define your `Children` component as standalone:
 
 ```tsx
-const Children: RhfUtilsUseFormChildrenZodFC<typeof schema> = () => {};
+const Children: RhfUtilsUseFormChildrenZodFC<typeof schema> = ({ ... }) => { };
+
+function Children({...}: RhfUtilsUseFormChildrenZodProps<typeof schema>) { }
 ```
 
 ## `RhfUtilsFormOptions`
@@ -185,6 +186,10 @@ type RhfUtilsFormOptions = {
 };
 ```
 
+If you need access to options deeper in component structure, use `useRhfUtilsContext` to receive `RhfUtilsContext` object, which includes `formId`, `formRef`, and `options` settings.
+
+Use `useRhfUtilsContextRequestSubmit` to get `requestSubmit` fn for current form ref in context. This is useful when you need to trigger form submission programatically.
+
 ## Extend `RhfUtilsFormOptions`
 
 Extend `RhfUtilsFormOptions` with custom options, which get passed to `Children` component in `options` prop.
@@ -221,7 +226,7 @@ To get accurate orphan analysis, you must either use `FormNonFieldErrorMarker` i
 Alternatively, you can use `FormErrorMessageByPath` to display error message to user:
 
 ```tsx
-<FormErrorMessageByPath path="phone" />
+<FormErrorMessageByPath path="street.address" />
 ```
 
 Example use case: Field array with minimum items. (When there are no items, the error is not associated with a field and is displayed separately.)
@@ -232,3 +237,28 @@ Orphans are optionally exposed in a few places.
 - And `useFlatFieldErrorsContext()` hook, which returns an object with divided into `all`, `root`, and `orphans` errors.
 
 `FlatFieldErrors` is a flattened, simplified version of RHF's `FieldErrors`. Keys represent field paths flattened to dot notation.
+
+## Form Groups
+
+Sometimes you need to group multiple forms together.
+
+Use case: disable parent form when any child is "busy"; disable all children when parent is "busy".
+
+Use `FormGroupContextProvider` to wrap your children and parent forms.
+
+```tsx
+<FormGroupContextProvider>
+  <ChildForm1 />
+  <ChildForm2 />
+  <ParentForm />
+</FormGroupContextProvider>
+```
+
+In your parent form, use the hook `useFormGroupParentTracker`, which returns `boolean` value indicating whether any child forms is busy.
+
+In children forms, there are two options. You can choose to consider form "busy" when:
+
+- `isSubmitting` is `true` by using `useFormGroupChildIsSubmittingTracker` hook
+- it is mounted by using `useFormGroupChildIsMountedTracker` hook
+
+Both hooks return `boolean` value indicating whether parent form is busy.

package/dist/esm/src/client/zod/context/RhfUtilsZodForm.mjs

@@ -0,0 +1,12 @@
+import { jsx as i } from "react/jsx-runtime";
+import e from "./useRhfUtilsClientForZodContext.mjs";
+function m({
+  schema: o,
+  ...t
+}) {
+  const { FormWithProviders: r } = e();
+  return /* @__PURE__ */ i(r, { schema: o, ...t });
+}
+export {
+  m as default
+};

package/dist/esm/src/client/zod/context/useRhfUtilsClientForZodContext.mjs

@@ -1,6 +1,6 @@
 import t from "../../../utils/createContext.mjs";
-const [, o, n] = t(), r = o;
+const [, e, r] = t();
 export {
-  n as _RhfUtilsClientForZodContextProvider,
-  r as default
+  r as _RhfUtilsClientForZodContextProvider,
+  e as default
 };

package/dist/esm/src/devtool/LazyDevTool.mjs

@@ -5,12 +5,12 @@ const a = e.lazy(
   () => import("@hookform/devtools").then((o) => ({
     default: o.DevTool
   }))
-), s = ({ isDevelopment: o, props: l }) => {
+), u = ({ isDevelopment: o, props: r }) => {
   if (!o)
     return null;
-  const { control: r } = n();
-  return /* @__PURE__ */ t(e.Suspense, { fallback: null, children: /* @__PURE__ */ t(a, { control: r, ...l }) });
-}, u = s;
+  const { control: l } = n();
+  return /* @__PURE__ */ t(e.Suspense, { fallback: null, children: /* @__PURE__ */ t(a, { control: l, ...r }) });
+};
 export {
   u as default
 };

package/dist/esm/src/errors/flat/FlatFieldErrorsList.mjs

@@ -1,17 +1,17 @@
-import { jsx as e } from "react/jsx-runtime";
+import { jsx as t } from "react/jsx-runtime";
 import l from "../../utils/isEmptyObject.mjs";
-const a = ({ errors: t }) => {
-  if (t && !l(t))
-    return /* @__PURE__ */ e("ul", { children: Object.values(t).map((r, i) => /* @__PURE__ */ e(
+const o = ({ errors: e }) => {
+  if (e && !l(e))
+    return /* @__PURE__ */ t("ul", { children: Object.values(e).map((i, r) => /* @__PURE__ */ t(
       "li",
       {
         role: "alert",
         "aria-live": "polite",
-        children: r.message
+        children: i.message
       },
-      i
+      r
     )) });
-}, m = a;
+};
 export {
-  m as default
+  o as default
 };

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

@@ -1,15 +1,18 @@
-import { get as f } from "react-hook-form";
+import { get as c } from "react-hook-form";
 import n from "./flattenFieldErrors.mjs";
-const p = (t) => {
-  const a = n(t), c = Object.keys(a);
+const u = (t) => {
+  const s = n(t), a = Object.keys(s);
   return Object.fromEntries(
-    c.reduce(
+    a.reduce(
       (e, o) => {
-        const r = o.replace(d, "");
+        const r = o.replace(
+          d,
+          ""
+        );
         if (r === o)
           return e;
-        const s = f(t, r, void 0);
-        return s && e.push([r, s]), e;
+        const f = c(t, r, void 0);
+        return f && e.push([r, f]), e;
       },
       []
       // entries
@@ -17,6 +20,6 @@ const p = (t) => {
   );
 }, d = /\.(?:type|message)\b$/;
 export {
-  p as default,
-  d as regexMaybeFieldErrorLeafNode
+  u as default,
+  d as regexMaybeFieldErrorLeafNodeSuffix
 };

package/dist/esm/src/errors/message/FormErrorMessage.mjs

@@ -1,14 +1,14 @@
-import { jsx as e } from "react/jsx-runtime";
+import { jsx as o } from "react/jsx-runtime";
 import "react";
-const s = ({ message: r, className: o }) => /* @__PURE__ */ e(
+const i = ({ message: r, className: e }) => /* @__PURE__ */ o(
   "p",
   {
     role: "alert",
     "aria-live": "polite",
-    className: o,
+    className: e,
     children: r
   }
-), i = s;
+);
 export {
   i as default
 };

package/dist/esm/src/errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs

@@ -1,4 +1,4 @@
-const r = "data-paragrav-rhf-utils-nonfield-error-marker-path", t = r;
+const r = "data-paragrav-rhf-utils-nonfield-error-marker-path";
 export {
-  t as default
+  r as default
 };

package/dist/esm/src/exports.mjs

@@ -1,70 +1,48 @@
 import { default as e } from "./client/zod/context/RhfUtilsClientForZodContextProvider.mjs";
-import { default as s } from "./client/zod/context/useRhfUtilsClientForZodContext.mjs";
-import { default as f } from "./client/zod/context/useRhfUtilsZodForm.mjs";
-import { default as u } from "./client/zod/RhfUtilsZodForm.mjs";
-import { default as d } from "./devtool/LazyDevTool.mjs";
-import { default as x } from "./errors/flat/context/useFlatFieldErrorsContext.mjs";
-import { default as i } from "./errors/flat/FlatFieldErrorsList.mjs";
-import { default as E } from "./errors/message/FormErrorMessage.mjs";
-import { default as C } from "./errors/message/FormErrorMessageByPath.mjs";
-import { default as y } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
-import { default as M } from "./errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs";
-import { default as T } from "./errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo.mjs";
-import { default as I } from "./errors/orphan/useOrphanFormErrorsMemo.mjs";
-import { default as R } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
-import { default as B } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
-import { getOnSubmitTrpcClientErrorHandler as U } from "./errors/trpc/getOnSubmitTrpcClientErrorHandler.mjs";
-import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as v } from "./errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
-import { default as A } from "./errors/useFormErrorsEffect.mjs";
-import { default as L } from "./errors/useFormErrorsIfAny.mjs";
-import { default as N } from "./form/FormWithProviders.mjs";
-import { default as W } from "./form/useRhfUtilsForm.mjs";
-import { default as q } from "./form/context/utils/useFormUtilsContext.mjs";
-import { default as J } from "./form/context/group/FormGroupContextProvider.mjs";
-import { default as Q } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
-import { default as X } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
-import { default as _ } from "./form/context/group/useFormGroupChildTracker.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 fr } from "./form/context/group/useFormGroupParentTracker.mjs";
-import { default as ur } from "./form/context/group/useFormOrParentIsBusy.mjs";
-import { default as dr } from "./form/utils/getSubmitterButtonData.mjs";
-import { FormSubmitError as xr } from "./submit/error/FormSubmitError.mjs";
-import { default as ir } from "./submit/useFormOnSubmitSuccessful.mjs";
+import { default as s } 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/message/FormErrorMessageByPath.mjs";
+import { default as x } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
+import { default as F } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
+import { getOnSubmitTrpcClientErrorHandler as C } from "./errors/trpc/getOnSubmitTrpcClientErrorHandler.mjs";
+import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as E } from "./errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
+import { default as R } from "./form/context/utils/useRhfUtilsContext.mjs";
+import { default as b } from "./form/context/utils/useRhfUtilsContextRequestSubmit.mjs";
+import { default as T } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as B } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as P } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as U } from "./form/context/group/useFormGroupChildTracker.mjs";
+import { default as M } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as q } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as O } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as D } from "./form/context/group/useFormGroupParentTracker.mjs";
+import { default as L } from "./form/context/group/useFormOrParentIsBusy.mjs";
+import { default as j } from "./form/utils/getSubmitterButtonData.mjs";
+import { default as z } from "./form/utils/useFormRequestSubmit.mjs";
+import { FormSubmitError as K } from "./submit/error/FormSubmitError.mjs";
 export {
-  i as FlatFieldErrorsList,
-  E as FormErrorMessage,
-  C as FormErrorMessageByPath,
-  J as FormGroupContextProvider,
-  y as FormNonFieldErrorMarker,
-  M as FormNonFieldErrorMarkerHtmlAttribute,
-  xr as FormSubmitError,
-  N as FormWithProviders,
-  d as LazyDevTool,
+  d as FormErrorMessageByPath,
+  T as FormGroupContextProvider,
+  x as FormNonFieldErrorMarker,
+  K as FormSubmitError,
   e as RhfUtilsClientForZodContextProvider,
-  u as RhfUtilsZodForm,
-  R as RootErrorsListFromFlatFieldErrorsContext,
-  U as getOnSubmitTrpcClientErrorHandler,
-  dr as getSubmitterButtonData,
-  v as trpcClientErrorToFormSubmitErrorsSchemaTransformer,
-  x as useFlatFieldErrorsContext,
-  A as useFormErrorsEffect,
-  L as useFormErrorsIfAny,
-  Q as useFormGroupChildIsMountedTracker,
-  X as useFormGroupChildIsSubmittingTracker,
-  _ as useFormGroupChildTracker,
-  rr as useFormGroupIsAnyBusy,
-  er as useFormGroupIsChildBusy,
-  sr as useFormGroupIsParentBusy,
-  fr as useFormGroupParentTracker,
-  T as useFormHasOnlyOrphanFieldErrorsMemo,
-  ir as useFormOnSubmitSuccessful,
-  ur as useFormOrParentIsBusy,
-  q as useFormUtilsContext,
-  I as useOrphanFormErrorsMemo,
-  s as useRhfUtilsClientForZodContext,
-  W as useRhfUtilsForm,
-  f as useRhfUtilsZodForm,
-  B as useRootFormFieldErrorsMemo
+  s as RhfUtilsZodForm,
+  F as RootErrorsListFromFlatFieldErrorsContext,
+  C as getOnSubmitTrpcClientErrorHandler,
+  j as getSubmitterButtonData,
+  E as trpcClientErrorToFormSubmitErrorsSchemaTransformer,
+  m as useFlatFieldErrorsContext,
+  B as useFormGroupChildIsMountedTracker,
+  P as useFormGroupChildIsSubmittingTracker,
+  U as useFormGroupChildTracker,
+  M as useFormGroupIsAnyBusy,
+  q as useFormGroupIsChildBusy,
+  O as useFormGroupIsParentBusy,
+  D as useFormGroupParentTracker,
+  L as useFormOrParentIsBusy,
+  z as useFormRequestSubmit,
+  R as useRhfUtilsContext,
+  b as useRhfUtilsContextRequestSubmit,
+  u as useRhfUtilsZodForm
 };

package/dist/esm/src/form/Form.mjs

@@ -1,40 +1,40 @@
-import { jsxs as j, jsx as d } from "react/jsx-runtime";
+import { jsxs as B, jsx as d } from "react/jsx-runtime";
 import "react";
-import { useFormContext as B } from "react-hook-form";
-import T from "../client/config/useRhfUtilsClientConfigContext.mjs";
-import _ from "../devtool/LazyDevTool.mjs";
-import { FormSubmitError as D } from "../submit/error/FormSubmitError.mjs";
+import { useFormContext as T } from "react-hook-form";
+import _ from "../client/config/useRhfUtilsClientConfigContext.mjs";
+import D from "../devtool/LazyDevTool.mjs";
+import { FormSubmitError as x } from "../submit/error/FormSubmitError.mjs";
 import N from "../submit/error/setCtxErrorsByFormSubmitErrors.mjs";
 import P from "./_Controller.mjs";
 import S from "./_FormBase.mjs";
 function A({
-  formId: x,
+  formId: y,
   formRef: c,
   //
   onSubmit: p,
   onSubmitError: s,
-  onSubmitInvalid: y,
+  onSubmitInvalid: f,
   Children: l,
   //
   form: m,
   utils: o,
   //
-  children: f
+  children: v
 }) {
-  const a = B(), t = T(), v = async (e) => {
+  const a = T(), t = _(), b = async (e) => {
     o != null && o.stopSubmitPropagation && e.stopPropagation();
     try {
-      await a.handleSubmit(b, y)(e);
+      await a.handleSubmit(F, f)(e);
     } catch (r) {
-      F(r, e);
+      j(r, e);
     }
-  }, b = (e, r) => p == null ? void 0 : p(
+  }, F = (e, r) => p == null ? void 0 : p(
     e,
     a,
     r
-  ), F = (e, r) => {
+  ), j = (e, r) => {
     var h;
-    const n = e instanceof D ? (
+    const n = e instanceof x ? (
       // consumer can manually throw FormSubmitError (e.g., manual validation)
       e.errors
     ) : (
@@ -47,17 +47,18 @@ function A({
       r
     );
   }, i = {
-    formId: x,
+    formId: y,
     formRef: c,
     context: a,
     utils: o,
-    Controller: P
+    Controller: P,
+    FormSubmitError: x
   }, C = (e) => {
     var n;
     const r = (n = t == null ? void 0 : t.Children) == null ? void 0 : n[e];
     return r && /* @__PURE__ */ d(r, { ...i });
   };
-  return /* @__PURE__ */ j(
+  return /* @__PURE__ */ B(
     S,
     {
       noValidate: !0,
@@ -68,18 +69,18 @@ function A({
       formRef: c,
       ...m,
       className: [o == null ? void 0 : o.classNames, m == null ? void 0 : m.className].filter(Boolean).join(" "),
-      onSubmit: v,
+      onSubmit: b,
       children: [
         C("top"),
         (o == null ? void 0 : o.devTool) && /* @__PURE__ */ d(
-          _,
+          D,
           {
             isDevelopment: t == null ? void 0 : t.isDevelopment,
             props: typeof o.devTool == "object" ? o.devTool : void 0
           }
         ),
         l && /* @__PURE__ */ d(l, { ...i }),
-        f,
+        v,
         C("bottom")
       ]
     }

package/dist/esm/src/form/RhfUtilsFormProviders.mjs

@@ -1,7 +1,7 @@
 import { jsx as r } from "react/jsx-runtime";
 import { FormProvider as d } from "react-hook-form";
 import n from "../errors/flat/context/FlatFieldErrorsContextProvider.mjs";
-import l from "./context/utils/FormUtilsContextProvider.mjs";
+import l from "./context/utils/RhfUtilsContextProvider.mjs";
 function v({
   formId: t,
   formRef: o,

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

@@ -1,7 +1,6 @@
 import r from "./useFormGroupChildTracker.mjs";
-const o = () => {
-  r(!0);
-}, u = o;
+import o from "./useFormGroupIsParentBusy.mjs";
+const e = () => (r(!0), o()), t = e;
 export {
-  u as default
+  t as default
 };

package/dist/esm/src/form/context/group/useFormGroupChildIsSubmittingTracker.mjs

@@ -1,9 +1,10 @@
 import { useFormState as o } from "react-hook-form";
 import t from "./useFormGroupChildTracker.mjs";
-const i = () => {
+import u from "./useFormGroupIsParentBusy.mjs";
+const m = () => {
   const { isSubmitting: r } = o();
-  t(r);
-}, u = i;
+  return t(r), u();
+}, n = m;
 export {
-  u as default
+  n as default
 };

package/dist/esm/src/form/context/group/useFormGroupIsParentBusy.mjs

@@ -2,7 +2,7 @@ import { _useFormGroupContextMaybe as o } from "./index.mjs";
 const s = () => {
   const r = o();
   return !!(r != null && r.parent.isBusy);
-}, t = s;
+};
 export {
-  t as default
+  s as default
 };

package/dist/esm/src/form/context/group/useFormGroupParentTracker.mjs

@@ -1,12 +1,13 @@
 import s from "react";
 import t from "../../useFormIsBusy.mjs";
 import { _useFormGroupContext as e } from "./index.mjs";
-const u = () => {
+import u from "./useFormGroupIsChildBusy.mjs";
+const m = () => {
   const r = t(), { setIsBusy: o } = e().parent;
-  s.useEffect(() => {
+  return s.useEffect(() => {
     o(r);
-  }, [o, r]);
-}, n = u;
+  }, [o, r]), u();
+}, f = m;
 export {
-  n as default
+  f as default
 };

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

@@ -0,0 +1,27 @@
+import { jsx as f } from "react/jsx-runtime";
+import t from "../../../errors/flat/useFlatFieldErrorsOutput.mjs";
+import l from "../../../submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import F from "../../../submit/useResetFormOnSubmitError.mjs";
+import O from "../../../submit/useResetFormOnSubmitSuccessful.mjs";
+import b from "../../../submit/useSubmitFormOnChange.mjs";
+import { _RhfUtilsContextProvider as d } from "./useRhfUtilsContext.mjs";
+function P({
+  formId: u,
+  formRef: e,
+  onSubmitSuccessfulAndReset: m,
+  options: r,
+  children: a
+}) {
+  return t(), b(e, {
+    disabled: !(r != null && r.submitOnChange)
+  }), F({
+    disabled: !(r != null && r.resetValuesOnSubmitError)
+  }), O(
+    (r == null ? void 0 : r.resetFormAfterSubmitSuccessful) || !!m
+  ), l(() => {
+    m == null || m();
+  }), /* @__PURE__ */ f(d, { value: { formId: u, formRef: e, options: r }, children: a });
+}
+export {
+  P as default
+};

package/dist/esm/src/form/context/utils/useRhfUtilsContext.mjs

@@ -0,0 +1,6 @@
+import t from "../../../utils/createContext.mjs";
+const [, e, n] = t(), o = e, f = o;
+export {
+  n as _RhfUtilsContextProvider,
+  f as default
+};

package/dist/esm/src/form/context/utils/useRhfUtilsContextRequestSubmit.mjs

@@ -0,0 +1,9 @@
+import e from "../../utils/useFormRequestSubmit.mjs";
+import s from "./useRhfUtilsContext.mjs";
+const o = () => {
+  const t = s();
+  return e(t.formRef);
+}, m = o;
+export {
+  m as default
+};

package/dist/esm/src/form/useRhfUtilsForm.mjs

@@ -1,43 +1,43 @@
-import m from "react";
+import s from "react";
 import { useForm as d } from "react-hook-form";
 import { FormSubmitError as F } from "../submit/error/FormSubmitError.mjs";
-const R = ({
+const v = ({
   onSubmit: e,
   onSubmitError: f,
-  onSubmitInvalid: n,
-  defaultValues: p,
+  onSubmitInvalid: p,
+  defaultValues: n,
   Children: c,
   rhf: i,
   form: u,
-  utils: s
+  utils: t
 }) => {
-  const o = m.useId(), t = d({
+  const r = s.useId(), m = d({
     ...i,
-    defaultValues: p
-  }), r = m.useRef(null);
+    defaultValues: n
+  }), o = s.useRef(null);
   return {
-    id: o,
-    ref: r,
-    context: t,
+    id: r,
+    ref: o,
+    context: m,
     providerProps: {
-      formId: o,
-      formRef: r,
-      rhfForm: t,
-      utils: s
+      formId: r,
+      formRef: o,
+      rhfForm: m,
+      utils: t
     },
     formProps: {
       Children: c,
       onSubmit: e,
       onSubmitError: f,
-      onSubmitInvalid: n,
-      formId: o,
-      formRef: r,
+      onSubmitInvalid: p,
+      formId: r,
+      formRef: o,
       form: u,
-      utils: s
+      utils: t
     },
     FormSubmitError: F
   };
-}, x = R;
+};
 export {
-  x as default
+  v as default
 };

package/dist/esm/src/submit/useFormOnSubmitSuccessful.mjs

@@ -1,11 +1,11 @@
-import u from "react";
-import { useFormState as e } from "react-hook-form";
-const o = (s) => {
-  const { isSubmitSuccessful: t } = e();
-  u.useEffect(() => {
-    s && t && s();
-  }, [s, t]);
-}, r = o;
+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/src/submit/useSubmitFormOnChange.mjs

@@ -1,5 +1,5 @@
 import m from "react";
-import a from "../errors/useFormRequestSubmit.mjs";
+import a from "../form/utils/useFormRequestSubmit.mjs";
 const o = (t, e) => {
   const u = a(t);
   m.useEffect(() => {

package/dist/esm/src/utils/isEmptyObject.mjs

@@ -1,4 +1,4 @@
-const e = (t) => Object.keys(t).length === 0, s = e;
+const e = (t) => Object.keys(t).length === 0;
 export {
-  s as default
+  e as default
 };

package/dist/types/client/zod/RhfUtilsUseFormChildrenZodProps.d.ts

@@ -1,4 +1,5 @@
 import { UseRhfUtilsFormChildrenProps } from '../../form/UseRhfUtilsFormChildrenProps';
+import { zodTypeInput, zodTypeOutput } from './consts';
 import { ZodTypeFieldValues } from './ZodTypeFieldValues';
 
-export type RhfUtilsUseFormChildrenZodProps<TSchema extends ZodTypeFieldValues> = UseRhfUtilsFormChildrenProps<TSchema['_input'], TSchema['_output']>;
+export type RhfUtilsUseFormChildrenZodProps<TSchema extends ZodTypeFieldValues> = UseRhfUtilsFormChildrenProps<TSchema[typeof zodTypeInput], TSchema[typeof zodTypeOutput]>;

package/dist/types/client/zod/consts.d.ts

@@ -0,0 +1,4 @@
+/** Schema key that returns input type. */
+export declare const zodTypeInput = "_input";
+/** Schema keys that returns output type. */
+export declare const zodTypeOutput = "_output";

package/dist/types/client/zod/context/RhfUtilsZodForm.d.ts

@@ -0,0 +1,9 @@
+import { UseRhfUtilsFormProps } from '../../../form/UseRhfUtilsFormProps';
+import { zodTypeInput, zodTypeOutput } from '../consts';
+import { ZodTypeFieldValues } from '../ZodTypeFieldValues';
+
+type Props<TSchema extends ZodTypeFieldValues> = {
+    schema: TSchema;
+} & Omit<UseRhfUtilsFormProps<TSchema[typeof zodTypeInput], TSchema[typeof zodTypeOutput]>, 'config'>;
+declare function RhfUtilsZodForm<TSchema extends ZodTypeFieldValues>({ schema, ...props }: Props<TSchema>): import("react/jsx-runtime").JSX.Element;
+export default RhfUtilsZodForm;

package/dist/types/client/zod/context/useRhfUtilsZodForm.d.ts

@@ -1,7 +1,8 @@
 import { UseRhfUtilsFormProps } from '../../../form/UseRhfUtilsFormProps';
+import { zodTypeInput, zodTypeOutput } from '../consts';
 import { ZodTypeFieldValues } from '../ZodTypeFieldValues';
 
-declare const useRhfUtilsZodForm: <TSchema extends ZodTypeFieldValues>(schema: TSchema, form: Omit<UseRhfUtilsFormProps<TSchema['_input'], TSchema['_output']>, 'config'>) => import('../../../form/UseRhfUtilsFormReturn').UseRhfUtilsFormReturn<TSchema["_input"], TSchema["_output"]> & {
+declare const useRhfUtilsZodForm: <TSchema extends ZodTypeFieldValues>(schema: TSchema, form: Omit<UseRhfUtilsFormProps<TSchema[typeof zodTypeInput], TSchema[typeof zodTypeOutput]>, 'config'>) => import('../../../form/UseRhfUtilsFormReturn').UseRhfUtilsFormReturn<TSchema["_input"], TSchema["_output"]> & {
     FormWithProviders: import('react').FC<{
         children?: import('react').ReactNode;
     }>;

package/dist/types/errors/flat/getFlatFieldErrors.d.ts

@@ -6,7 +6,8 @@ import { FlatFieldErrors } from './types';
  * This makes it easy to work with potentially deeply-nested {@link FieldErrors}.
  *
  * @param errors {@link FieldErrors} object.
- * @returns FlatFieldErrors object.
+ *
+ * @returns `FlatFieldErrors` object.
  *
  * @example
  * ```
@@ -28,4 +29,4 @@ export default getFlatFieldErrors;
  *
  * iow: dot [?: non-capturing]("type" | "message")[\b word boundary][$ end of string]
  */
-export declare const regexMaybeFieldErrorLeafNode: RegExp;
+export declare const regexMaybeFieldErrorLeafNodeSuffix: RegExp;

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

@@ -1,4 +1,9 @@
 import { default as React } from 'react';
 
+/**
+ * Get {@link FlatFieldErrors} of only orphans.
+ * @param formRef Parent DOM element to look for non-field error markers.
+ * @returns Memoized {@link FlatFieldErrors} of only orphans.
+ */
 declare const useOrphanFormErrorsMemo: (formRef: React.RefObject<HTMLFormElement>) => import('../flat/types').FlatFieldErrors;
 export default useOrphanFormErrorsMemo;

package/dist/types/exports.d.ts

@@ -1,32 +1,21 @@
 export type { Register } from './register';
 export type { RhfUtilsClientConfig } from './client/config/RhfUtilsClientConfig';
 export { default as RhfUtilsClientForZodContextProvider } from './client/zod/context/RhfUtilsClientForZodContextProvider';
-export { default as useRhfUtilsClientForZodContext } from './client/zod/context/useRhfUtilsClientForZodContext';
+export { default as RhfUtilsZodForm } from './client/zod/context/RhfUtilsZodForm';
 export { default as useRhfUtilsZodForm } from './client/zod/context/useRhfUtilsZodForm';
 export type { RhfUtilsUseFormChildrenZodFC } from './client/zod/RhfUtilsUseFormChildrenZodFC';
 export type { RhfUtilsUseFormChildrenZodProps } from './client/zod/RhfUtilsUseFormChildrenZodProps';
-export { default as RhfUtilsZodForm } from './client/zod/RhfUtilsZodForm';
-export { default as LazyDevTool } from './devtool/LazyDevTool';
 export { default as useFlatFieldErrorsContext } from './errors/flat/context/useFlatFieldErrorsContext';
-export { default as FlatFieldErrorsList } from './errors/flat/FlatFieldErrorsList';
-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 useFormHasOnlyOrphanFieldErrorsMemo } from './errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo';
-export { default as useOrphanFormErrorsMemo } from './errors/orphan/useOrphanFormErrorsMemo';
 export { default as RootErrorsListFromFlatFieldErrorsContext } from './errors/root/RootErrorsListFromFlatFieldErrorsContext';
-export { default as useRootFormFieldErrorsMemo } from './errors/root/useRootFormFieldErrorsMemo';
 export { getOnSubmitTrpcClientErrorHandler } from './errors/trpc/getOnSubmitTrpcClientErrorHandler';
 export { trpcClientErrorToFormSubmitErrorsSchemaTransformer } from './errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer';
-export { default as useFormErrorsEffect } from './errors/useFormErrorsEffect';
-export { default as useFormErrorsIfAny } from './errors/useFormErrorsIfAny';
-export { default as FormWithProviders } from './form/FormWithProviders';
 export type { RhfUtilsFormOptions } from './form/RhfUtilsFormOptions';
 export type { SafeFieldValues } from './form/SafeFieldValues';
-export { default as useRhfUtilsForm } from './form/useRhfUtilsForm';
 export type { UseRhfUtilsFormChildrenProps } from './form/UseRhfUtilsFormChildrenProps';
-export { default as useFormUtilsContext } from './form/context/utils/useFormUtilsContext';
+export { default as useRhfUtilsContext } from './form/context/utils/useRhfUtilsContext';
+export { default as useRhfUtilsContextRequestSubmit } from './form/context/utils/useRhfUtilsContextRequestSubmit';
 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';
@@ -37,5 +26,5 @@ export { default as useFormGroupIsParentBusy } from './form/context/group/useFor
 export { default as useFormGroupParentTracker } from './form/context/group/useFormGroupParentTracker';
 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 { FormSubmitError } from './submit/error/FormSubmitError';
-export { default as useFormOnSubmitSuccessful } from './submit/useFormOnSubmitSuccessful';

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

@@ -1,13 +1,20 @@
 import { default as React } from 'react';
 import { UseFormReturn } from 'react-hook-form';
+import { FormSubmitError } from '../submit/error/FormSubmitError';
 import { default as _Controller } from './_Controller';
 import { RhfUtilsFormOptions } from './RhfUtilsFormOptions';
 import { SafeFieldValues } from './SafeFieldValues';
 
+/**
+ * Component props for `Children`.
+ *
+ * Consider keeping shape in line with `UseRhfUtilsFormReturn`.
+ */
 export type UseRhfUtilsFormChildrenProps<TFieldValues extends SafeFieldValues = SafeFieldValues, TTransformedValues extends SafeFieldValues = SafeFieldValues> = {
     formId: string;
     formRef: React.RefObject<HTMLFormElement>;
     context: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
     utils?: RhfUtilsFormOptions;
     Controller: typeof _Controller<TFieldValues>;
+    FormSubmitError: typeof FormSubmitError<TFieldValues>;
 };

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

@@ -5,6 +5,11 @@ import { FormProps } from './Form';
 import { RhfUtilsFormProvidersProps } from './RhfUtilsFormProviders';
 import { SafeFieldValues } from './SafeFieldValues';
 
+/**
+ * Return type for `useRhfUtilsForm`.
+ *
+ * Consider keeping shape in line with `UseRhfUtilsFormChildrenProps`.
+ */
 export type UseRhfUtilsFormReturn<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = {
     id: string;
     ref: React.RefObject<HTMLFormElement>;

package/dist/types/form/context/group/useFormGroupChildIsMountedTracker.d.ts

@@ -1,5 +1,5 @@
 /**
  * Mark "child" form as "busy" when mounted.
  */
-declare const useFormGroupChildIsMountedTracker: () => void;
+declare const useFormGroupChildIsMountedTracker: () => boolean;
 export default useFormGroupChildIsMountedTracker;

package/dist/types/form/context/group/useFormGroupChildIsSubmittingTracker.d.ts

@@ -1,5 +1,5 @@
 /**
  * Mark "child" form as "busy" when submitting.
  */
-declare const useFormGroupChildIsSubmittingTracker: () => void;
+declare const useFormGroupChildIsSubmittingTracker: () => boolean;
 export default useFormGroupChildIsSubmittingTracker;

package/dist/types/form/context/group/useFormGroupParentTracker.d.ts

@@ -3,5 +3,5 @@
  *
  * Requires usage of provider.
  */
-declare const useFormGroupParentTracker: () => void;
+declare const useFormGroupParentTracker: () => boolean;
 export default useFormGroupParentTracker;

package/dist/types/form/context/utils/RhfUtilsContextProvider.d.ts

@@ -0,0 +1,11 @@
+import { RhfUtilsFormOptions } from '../../RhfUtilsFormOptions';
+
+type Props = React.PropsWithChildren<{
+    formId: string;
+    formRef: React.RefObject<HTMLFormElement>;
+    /** Callback after successful submit, and form reset. */
+    onSubmitSuccessfulAndReset?: () => void;
+    options?: RhfUtilsFormOptions;
+}>;
+declare function RhfUtilsContextProvider({ formId, formRef, onSubmitSuccessfulAndReset, options, children, }: Props): import("react/jsx-runtime").JSX.Element;
+export default RhfUtilsContextProvider;

package/dist/types/form/context/utils/useRhfUtilsContext.d.ts

@@ -0,0 +1,14 @@
+import { RhfUtilsFormOptions } from '../../RhfUtilsFormOptions';
+
+export type RhfUtilsContext = {
+    formId: string;
+    formRef: React.RefObject<HTMLFormElement>;
+    options: RhfUtilsFormOptions | undefined;
+};
+declare const _RhfUtilsContextProvider: import('react').Provider<RhfUtilsContext | undefined>;
+/**
+ * Use utils from the current form context.
+ */
+declare const useRhfUtilsContext: () => RhfUtilsContext;
+export default useRhfUtilsContext;
+export { _RhfUtilsContextProvider };

package/dist/types/form/context/utils/useRhfUtilsContextRequestSubmit.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get `requestSubmit` function from the form ref'd in current context.
+ */
+declare const useRhfUtilsContextRequestSubmit: () => (submitter?: HTMLElement | null | undefined) => void;
+export default useRhfUtilsContextRequestSubmit;

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

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 
 /**
- * Get [name, value] of button/input that submitted form.
+ * Get [name, value] tuple of button/input that submitted form.
  * Useful when determining user intent
  */
 declare const getSubmitterButtonData: (event: React.BaseSyntheticEvent) => [

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

@@ -0,0 +1,6 @@
+/**
+ * Get callback to trigger submit manually on form.
+ * @link https://developer.mozilla.org/docs/Web/API/HTMLFormElement/requestSubmit
+ */
+declare const useFormRequestSubmit: (ref: React.RefObject<HTMLFormElement>) => HTMLFormElement['requestSubmit'];
+export default useFormRequestSubmit;

package/package.json

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

package/dist/esm/src/client/zod/RhfUtilsZodForm.mjs

@@ -1,12 +0,0 @@
-import { jsx as e } from "react/jsx-runtime";
-import i from "./context/useRhfUtilsClientForZodContext.mjs";
-function f({
-  schema: o,
-  ...t
-}) {
-  const r = i();
-  return /* @__PURE__ */ e(r.FormWithProviders, { schema: o, ...t });
-}
-export {
-  f as default
-};

package/dist/esm/src/errors/flat/useFormFlatFieldErrorsMemo.mjs

@@ -1,6 +0,0 @@
-import r from "../useFormErrorsTransformMemo.mjs";
-import o from "./getFlatFieldErrors.mjs";
-const s = () => r(o);
-export {
-  s as default
-};

package/dist/esm/src/errors/orphan/getOrphansFromFieldErrors.mjs

@@ -1,6 +0,0 @@
-import t from "../flat/getFlatFieldErrors.mjs";
-import e from "./getOrphansFromFlatFieldErrors.mjs";
-const a = (r, o) => e(t(r), o);
-export {
-  a as default
-};

package/dist/esm/src/errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo.mjs

@@ -1,10 +0,0 @@
-import s from "../../utils/isEmptyObject.mjs";
-import t from "../flat/useFormFlatFieldErrorsMemo.mjs";
-import m from "./useOrphanFormErrorsMemo.mjs";
-const n = (o) => {
-  const e = t(), r = m(o);
-  return s(r) ? !1 : Object.keys(e).length !== Object.keys(r).length;
-}, i = n;
-export {
-  i as default
-};

package/dist/esm/src/errors/orphan/useOrphanFormErrorsMemo.mjs

@@ -1,14 +0,0 @@
-import "react";
-import t from "../../utils/isEmptyObject.mjs";
-import m from "../useFormErrorsTransformMemo.mjs";
-import e from "./getOrphansFromFieldErrors.mjs";
-const s = (r) => m((o) => {
-  if (t(o))
-    return {};
-  if (!r.current)
-    throw new Error();
-  return e(o, r.current);
-}), a = s;
-export {
-  a as default
-};

package/dist/esm/src/errors/root/getRootsFromFieldErrors.mjs

@@ -1,6 +0,0 @@
-import o from "../flat/getFlatFieldErrors.mjs";
-import t from "./getRootsFromFlatFieldErrors.mjs";
-const F = (r) => t(o(r));
-export {
-  F as default
-};

package/dist/esm/src/errors/root/useRootFormFieldErrorsMemo.mjs

@@ -1,6 +0,0 @@
-import o from "../useFormErrorsTransformMemo.mjs";
-import r from "./getRootsFromFieldErrors.mjs";
-const e = () => o(r), t = e;
-export {
-  t as default
-};

package/dist/esm/src/errors/useFormErrorsEffect.mjs

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

package/dist/esm/src/errors/useFormErrorsIfAny.mjs

@@ -1,9 +0,0 @@
-import { useFormState as o } from "react-hook-form";
-import s from "../utils/isEmptyObject.mjs";
-const t = () => {
-  const { errors: r } = o();
-  return s(r) ? !1 : r;
-}, f = t;
-export {
-  f as default
-};

package/dist/esm/src/form/context/utils/FormUtilsContextProvider.mjs

@@ -1,35 +0,0 @@
-import { jsx as a } from "react/jsx-runtime";
-import l from "../../../errors/flat/useFlatFieldErrorsOutput.mjs";
-import b from "../../../errors/useFormRequestSubmit.mjs";
-import f from "../../../submit/useFormOnSubmitSuccessfulAndReset.mjs";
-import O from "../../../submit/useResetFormOnSubmitError.mjs";
-import i from "../../../submit/useResetFormOnSubmitSuccessful.mjs";
-import d from "../../../submit/useSubmitFormOnChange.mjs";
-import { _FormUtilsContextProvider as x } from "./useFormUtilsContext.mjs";
-function j({
-  formId: t,
-  formRef: e,
-  onSubmitSuccessfulAndReset: m,
-  options: r,
-  children: u
-}) {
-  const F = b(e);
-  return l(), d(e, {
-    disabled: !(r != null && r.submitOnChange)
-  }), O({
-    disabled: !(r != null && r.resetValuesOnSubmitError)
-  }), i(
-    (r == null ? void 0 : r.resetFormAfterSubmitSuccessful) || !!m
-  ), f(() => {
-    m == null || m();
-  }), /* @__PURE__ */ a(
-    x,
-    {
-      value: { formId: t, formRef: e, requestSubmit: F, options: r },
-      children: u
-    }
-  );
-}
-export {
-  j as default
-};

package/dist/esm/src/form/context/utils/useFormUtilsContext.mjs

@@ -1,6 +0,0 @@
-import t from "../../../utils/createContext.mjs";
-const [, o, r] = t(), s = o;
-export {
-  r as _FormUtilsContextProvider,
-  s as default
-};