@paragrav/rhf-utils 0.0.51 → 0.0.56

package/README.md

@@ -0,0 +1 @@
+Readme

package/dist/esm/config/index.mjs

@@ -0,0 +1,14 @@
+let o;
+const n = (t) => {
+  o = t;
+}, e = (t) => ({
+  ...o,
+  options: {
+    ...o == null ? void 0 : o.options,
+    ...t
+  }
+});
+export {
+  e as _getConfig,
+  n as setConfig
+};

package/dist/esm/errors/isFieldError.mjs

@@ -1,4 +1,4 @@
-const e = (r) => !!r.ref, o = e;
+const e = (r) => !!r.ref;
 export {
-  o as default
+  e as default
 };

package/dist/esm/errors/orphan/getOrphansFromFlatFieldErrors.mjs

@@ -1,16 +1,9 @@
-import i from "../isFieldError.mjs";
-import { hasNonFieldErrorMarkerInDOM as m } from "../nonfield/FormNonFieldErrorMarker.utils.mjs";
-import s from "../root/isFormErrorPathRoot.mjs";
-const n = (o, t) => Object.fromEntries(
-  Object.entries(o).filter(
-    ([r, e]) => (
-      // not root path
-      !s(r) && // non-field
-      !i(e) && // does not have marker
-      !m(r, t)
-    )
+import s from "./isOrphanFormError.mjs";
+const a = (r, t) => Object.fromEntries(
+  Object.entries(r).filter(
+    ([e, o]) => s(e, o, t)
   )
 );
 export {
-  n as default
+  a as default
 };

package/dist/esm/errors/orphan/isOrphanFormError.mjs

@@ -0,0 +1,12 @@
+import m from "../isFieldError.mjs";
+import { hasNonFieldErrorMarkerInDOM as t } from "../nonfield/FormNonFieldErrorMarker.utils.mjs";
+import s from "../root/isFormErrorPathRoot.mjs";
+const n = (r, o, i) => (
+  // not root path
+  !s(r) && // non-field
+  !m(o) && // does not have marker
+  !t(r, i)
+);
+export {
+  n as default
+};

package/dist/esm/errors/orphan/useFormHasOrphanAndNoFieldErrors.mjs

@@ -1,4 +1,4 @@
-import r from "../../isEmptyObject.mjs";
+import r from "../../utils/isEmptyObject.mjs";
 import t from "../flat/useRefdFieldErrorsMemo.mjs";
 import m from "./useOrphanFormErrorsMemo.mjs";
 const n = (o) => {

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

@@ -1,5 +1,5 @@
 import "react";
-import t from "../../isEmptyObject.mjs";
+import t from "../../utils/isEmptyObject.mjs";
 import e from "../useFormErrorsMemo.mjs";
 import m from "./getOrphansFromFieldErrors.mjs";
 const s = (r) => e((o) => {

package/dist/esm/errors/useFormErrorsIfAny.mjs

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

package/dist/esm/errors/useFormErrorsToConsole.mjs

@@ -1,6 +1,6 @@
 import a from "react";
 import { useFormContext as l, useFormState as E } from "react-hook-form";
-import c from "../isEmptyObject.mjs";
+import c from "../utils/isEmptyObject.mjs";
 import d from "./outputErrors.mjs";
 const h = (e, f, r) => {
   const { getValues: m } = l(), { errors: u } = E();

package/dist/esm/exports.mjs

@@ -1,76 +1,74 @@
-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";
+import { setConfig as e } from "./config/index.mjs";
+import { default as s } from "./devtool/LazyDevTool.mjs";
+import { default as a } from "./errors/context/index.mjs";
+import { default as f } from "./errors/context/provider.mjs";
+import { default as d } from "./errors/message/FormErrorMessage.mjs";
+import { default as x } from "./errors/message/FormErrorMessageByPath.mjs";
+import { default as n } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
+import { default as E } from "./errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs";
+import { default as S } from "./errors/orphan/useFormHasOrphanAndNoFieldErrors.mjs";
+import { default as c } from "./errors/orphan/useOrphanFormErrorsMemo.mjs";
+import { default as y } from "./errors/orphan/useOrphanFormErrorsToConsole.mjs";
+import { default as M } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
+import { default as g } from "./errors/useFormErrorConsoleDebug.mjs";
+import { default as P } from "./errors/useFormErrorsEffect.mjs";
+import { default as A } from "./errors/useFormErrorsIfAny.mjs";
+import { default as T } from "./errors/useFormErrorsMemo.mjs";
+import { default as v } from "./errors/useFormRequestSubmit.mjs";
+import { default as N } from "./form/useForm.mjs";
+import { default as U } from "./form/context/utils/FormUtilsContextProvider.mjs";
+import { default as z } from "./form/context/utils/useFormUtilsContext.mjs";
+import { default as j } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as J } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as Q } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as W } from "./form/context/group/useFormGroupChildTracker.mjs";
+import { default as Y } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as _ } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as rr } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as er } from "./form/context/group/useFormGroupParentTracker.mjs";
+import { default as sr } from "./form/context/group/useFormOrParentIsBusy.mjs";
+import { default as ar } from "./form/utils/getSubmitterButtonData.mjs";
+import { FormSubmitError as fr } from "./submit/error/FormSubmitError.mjs";
+import { default as dr } from "./submit/useFormOnSubmitSuccessful.mjs";
+import { default as xr } from "./submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import { default as nr } from "./submit/useResetFormOnSubmitError.mjs";
+import { default as Er } from "./submit/useResetFormOnSubmitSuccessful.mjs";
+import { default as Sr } 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
+  d as FormErrorMessage,
+  x as FormErrorMessageByPath,
+  f as FormErrorsFlatContextProvider,
+  j as FormGroupContextProvider,
+  n as FormNonFieldErrorMarker,
+  E as FormNonFieldErrorMarkerHtmlAttribute,
+  fr as FormSubmitError,
+  U as FormUtilsContextProvider,
+  s as LazyDevTool,
+  ar as getSubmitterButtonData,
+  e as setConfig,
+  N as useForm,
+  g as useFormErrorConsoleDebug,
+  P as useFormErrorsEffect,
+  a as useFormErrorsFlatContext,
+  A as useFormErrorsIfAny,
+  T as useFormErrorsMemo,
+  J as useFormGroupChildIsMountedTracker,
+  Q as useFormGroupChildIsSubmittingTracker,
+  W as useFormGroupChildTracker,
+  Y as useFormGroupIsAnyBusy,
+  _ as useFormGroupIsChildBusy,
+  rr as useFormGroupIsParentBusy,
+  er as useFormGroupParentTracker,
+  S as useFormHasOrphanAndNoFieldErrors,
+  dr as useFormOnSubmitSuccessful,
+  xr as useFormOnSubmitSuccessfulAndReset,
+  sr as useFormOrParentIsBusy,
+  v as useFormRequestSubmit,
+  z as useFormUtilsContext,
+  c as useOrphanFormErrorsMemo,
+  y as useOrphanFormErrorsToConsole,
+  Er as useResetFormAfterSubmitSuccessful,
+  nr as useResetFormOnSubmitError,
+  M as useRootFormFieldErrorsMemo,
+  Sr as useSubmitFormOnChange
 };

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

@@ -1,16 +1,7 @@
-import o from "react";
-import { _useFormGroupContext as u } from "./index.mjs";
-const c = () => {
-  const { setBusyId: r } = u().children, s = o.useId();
-  o.useEffect(() => {
-    const e = (t) => {
-      r(s, t);
-    };
-    return e(!0), () => {
-      e(!1);
-    };
-  }, []);
-}, m = c;
+import r from "./useFormGroupChildTracker.mjs";
+const o = () => {
+  r(!0);
+}, u = o;
 export {
-  m as default
+  u as default
 };

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

@@ -1,14 +1,9 @@
-import e from "react";
-import { useFormState as s } from "react-hook-form";
-import { _useFormGroupContext as u } from "./index.mjs";
+import { useFormState as o } from "react-hook-form";
+import t from "./useFormGroupChildTracker.mjs";
 const i = () => {
-  const { isSubmitting: o } = s(), { setBusyId: t } = u().children, r = e.useId();
-  e.useEffect(() => {
-    t(r, o);
-  }, [o, r, t]), e.useEffect(() => () => {
-    t(r, !1);
-  }, []);
-}, f = i;
+  const { isSubmitting: r } = o();
+  t(r);
+}, u = i;
 export {
-  f as default
+  u as default
 };

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

@@ -0,0 +1,13 @@
+import o from "react";
+import { _useFormGroupContext as t } from "./index.mjs";
+const u = (s) => {
+  const { setBusyId: e } = t().children, r = o.useId();
+  o.useEffect(() => {
+    e(r, s);
+  }, [s, r, e]), o.useEffect(() => () => {
+    e(r, !1);
+  }, []);
+}, d = u;
+export {
+  d as default
+};

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

@@ -0,0 +1,10 @@
+import t from "../../useFormIsBusy.mjs";
+import { _useFormGroupContextMaybe as e } from "./index.mjs";
+const u = () => {
+  var s;
+  const r = t(), o = (s = e()) == null ? void 0 : s.parent.isBusy;
+  return !!(r || o);
+}, a = u;
+export {
+  a as default
+};

package/dist/esm/form/useForm.mjs

@@ -1,29 +1,33 @@
-import { jsx as n } from "react/jsx-runtime";
-import i from "react";
-import { useForm as u } from "react-hook-form";
-import F from "../utils/useImperativeForwardedRef.mjs";
-import c from "./Form.mjs";
+import n from "react";
+import { useForm as p } from "react-hook-form";
+import u from "../submit/useSubmitFormOnChange.mjs";
+import { _getConfig as c } from "../config/index.mjs";
 const f = ({
-  rhf: e,
-  form: o
+  rhf: m,
+  form: o,
+  utils: i
 }) => {
-  const r = i.useId(), m = u(e), t = F();
-  return {
-    id: r,
-    ref: t,
-    context: m,
-    Form: ({ children: s }) => /* @__PURE__ */ n(
-      c,
-      {
-        formId: r,
-        formRef: t,
-        onSubmit: o == null ? void 0 : o.onSubmit,
-        ...o,
-        children: s
-      }
-    )
+  const t = c(o == null ? void 0 : o.options), s = n.useId(), e = p({
+    ...t.rhf,
+    ...m
+  }), r = n.useRef(null);
+  return u(r, { disabled: !t.options.submitOnChange }), {
+    id: s,
+    ref: r,
+    context: e,
+    providerProps: {
+      formId: s,
+      formRef: r,
+      rhfForm: e,
+      utils: i
+    },
+    formProps: {
+      formId: s,
+      formRef: r,
+      form: o
+    }
   };
-}, b = f;
+}, P = f;
 export {
-  b as default
+  P as default
 };

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

@@ -1,6 +1,7 @@
 import "react";
 const e = (t) => {
-  if (t.nativeEvent instanceof SubmitEvent && (t.nativeEvent.submitter instanceof HTMLButtonElement || t.nativeEvent.submitter instanceof HTMLInputElement) && t.nativeEvent.submitter.name)
+  if (t.nativeEvent instanceof SubmitEvent && !(!(t.nativeEvent.submitter instanceof HTMLButtonElement) && // not button
+  !(t.nativeEvent.submitter instanceof HTMLInputElement)) && t.nativeEvent.submitter.name)
     return [
       t.nativeEvent.submitter.name,
       t.nativeEvent.submitter.value

package/dist/esm/submit/useResetFormOnSubmitError.mjs

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

package/dist/esm/submit/useSubmitFormOnChange.mjs

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

package/dist/types/src/config/index.d.ts

@@ -0,0 +1,57 @@
+import { FormSubmitError } from '../submit/error/FormSubmitError';
+import { UseFormOptions } from '../form/useForm';
+import { FieldValues, UseFormProps, UseFormStateReturn } from 'react-hook-form';
+
+type Config = {
+    rhf?: Pick<UseFormProps, 'mode' | 'reValidateMode' | 'resetOptions' | 'context' | 'shouldFocusError' | 'shouldUnregister' | 'shouldUseNativeValidation' | 'progressive' | 'criteriaMode' | 'delayError'>;
+    options?: UseFormOptions;
+    /**
+     * Handle non-{@link FormSubmitError} errors. Optionally, return {@link FormSubmitError} to merge into context errors.
+     */
+    onSubmitError?: (error: unknown) => FormSubmitError | undefined;
+    Prompter?: React.FC<UseFormStateReturn<FieldValues>>;
+};
+export declare const setConfig: (config: Config) => void;
+export declare const _getConfig: (options?: UseFormOptions) => {
+    options: {
+        hideRootErrorsList?: boolean | undefined;
+        submitOnChange?: boolean | undefined;
+        resetValuesOnSubmitError?: boolean | undefined;
+        stopSubmitPropagation?: boolean | undefined;
+        devTool?: import('@hookform/devtools/dist/devToolUI').DevtoolUIProps | "disabled" | undefined;
+    };
+    rhf?: Pick<Partial<{
+        mode: "onBlur" | "onChange" | "onSubmit" | "onTouched" | "all";
+        disabled: boolean;
+        reValidateMode: "onBlur" | "onChange" | "onSubmit";
+        defaultValues: {
+            [x: string]: any;
+        } | ((payload?: unknown) => Promise<FieldValues>);
+        values: FieldValues;
+        errors: import('react-hook-form').FieldErrors<FieldValues>;
+        resetOptions: Partial<{
+            keepDirtyValues: boolean;
+            keepErrors: boolean;
+            keepDirty: boolean;
+            keepValues: boolean;
+            keepDefaultValues: boolean;
+            keepIsSubmitted: boolean;
+            keepIsSubmitSuccessful: boolean;
+            keepTouched: boolean;
+            keepIsValidating: boolean;
+            keepIsValid: boolean;
+            keepSubmitCount: boolean;
+        }> | undefined;
+        resolver: import('react-hook-form').Resolver<FieldValues, any>;
+        context: any;
+        shouldFocusError: boolean;
+        shouldUnregister: boolean;
+        shouldUseNativeValidation: boolean;
+        progressive: boolean;
+        criteriaMode: import('react-hook-form').CriteriaMode;
+        delayError: number;
+    }>, "mode" | "reValidateMode" | "resetOptions" | "context" | "shouldFocusError" | "shouldUnregister" | "shouldUseNativeValidation" | "progressive" | "criteriaMode" | "delayError"> | undefined;
+    onSubmitError?: ((error: unknown) => FormSubmitError | undefined) | undefined;
+    Prompter?: import('react').FC<UseFormStateReturn<FieldValues>> | undefined;
+};
+export {};

package/dist/types/src/errors/orphan/isOrphanFormError.d.ts

@@ -0,0 +1,4 @@
+import { FieldError } from 'react-hook-form';
+
+declare const isOrphanFormError: (path: string, error: FieldError, parentElement: Pick<HTMLElement, 'querySelector'>) => boolean;
+export default isOrphanFormError;

package/dist/types/src/exports.d.ts

@@ -1,3 +1,4 @@
+export { setConfig } from './config';
 export { default as LazyDevTool } from './devtool/LazyDevTool';
 export { default as useFormErrorsFlatContext } from './errors/context';
 export { default as FormErrorsFlatContextProvider } from './errors/context/provider';
@@ -14,20 +15,18 @@ 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 useFormGroupChildTracker } from './form/context/group/useFormGroupChildTracker';
 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 useFormOrParentIsBusy } from './form/context/group/useFormOrParentIsBusy';
 export { default as getSubmitterButtonData } from './form/utils/getSubmitterButtonData';
 export { FormSubmitError } from './submit/error/FormSubmitError';
 export { default as useFormOnSubmitSuccessful } from './submit/useFormOnSubmitSuccessful';

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

@@ -1,13 +1,12 @@
 import { UseFormProps } from './useForm';
-import { FieldValues } from 'react-hook-form';
+import { z } from 'zod';
 
-export type FormWithProviders<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = React.PropsWithChildren<UseFormProps<TFieldValues, TTransformedValues>>;
 /**
- * {@link FormProvider} (and utils) with immediate descendent {@link Form}.
+ * Form providers (with 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;
+declare function FormWithProviders<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>>({ children, ...props }: React.PropsWithChildren<UseFormProps<TSchema, TFieldValues, TTransformedValues>>): import("react/jsx-runtime").JSX.Element;
 export default FormWithProviders;

package/dist/types/src/form/_Form.d.ts

@@ -0,0 +1,10 @@
+import { UseFormProps } from './useForm';
+import { z } from 'zod';
+import { default as React } from 'react';
+
+export type _FormProps<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>> = React.PropsWithChildren<Pick<UseFormProps<TSchema, TFieldValues, TTransformedValues>, 'form'> & {
+    formId: string;
+    formRef: React.RefObject<HTMLFormElement>;
+}>;
+declare function _Form<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>>({ formId, formRef, form, children, }: _FormProps<TSchema, TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+export default _Form;

package/dist/types/src/form/_FormBase.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+
+export type FormBaseProps = React.PropsWithoutRef<JSX.IntrinsicElements['form']> & {
+    formRef: React.RefObject<HTMLFormElement>;
+    antiCsrfToken?: string;
+};
+declare const _FormBase: ({ formRef, antiCsrfToken, children, ...props }: FormBaseProps) => import("react/jsx-runtime").JSX.Element;
+export default _FormBase;

package/dist/types/src/form/_FormProviders.d.ts

@@ -0,0 +1,12 @@
+import { FormUtilsContextProviderProps } from './context/utils/FormUtilsContextProvider';
+import { z } from 'zod';
+import { UseFormReturn } from 'react-hook-form';
+
+export type _FormProvidersProps<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>> = React.PropsWithChildren<{
+    formId: string;
+    formRef: React.RefObject<HTMLFormElement>;
+    rhfForm: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
+    utils?: FormUtilsContextProviderProps;
+}>;
+declare function _FormProviders<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>>({ formId, formRef, rhfForm, utils, children, }: _FormProvidersProps<TSchema, TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+export default _FormProviders;

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

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

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

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

package/dist/types/src/form/context/group/useFormGroupChildTracker.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mark "child" form as "busy" via arbitrary boolean.
+ * Automatically marks as "not busy" on dismount.
+ */
+declare const useFormGroupChildTracker: (track: boolean) => void;
+export default useFormGroupChildTracker;

package/dist/types/src/form/context/group/useFormOrParentIsBusy.d.ts

@@ -0,0 +1,2 @@
+declare const useFormOrParentIsBusy: () => boolean;
+export default useFormOrParentIsBusy;

package/dist/types/src/form/context/utils/FormUtilsContextProvider.d.ts

@@ -1,14 +1,11 @@
-import { FormProps } from '../../Form';
-import { FieldValues } from 'react-hook-form';
-
+/// <reference types="react" />
 export type FormUtilsContextProviderProps = {
     /** Callback after successful submit, and form reset. */
     onSubmitSuccessfulAndReset?: () => void;
 };
-type Props<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = React.PropsWithChildren<{
+type Props = React.PropsWithChildren<{
     formId: string;
     formRef: React.RefObject<HTMLFormElement>;
-    formProps?: Omit<FormProps<TFieldValues, TTransformedValues>, 'formRef' | 'formId'>;
 } & FormUtilsContextProviderProps>;
-declare function FormUtilsContextProvider<TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ formRef, onSubmitSuccessfulAndReset, children, }: Props<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+declare function FormUtilsContextProvider({ formRef, onSubmitSuccessfulAndReset, children, }: Props): import("react/jsx-runtime").JSX.Element;
 export default FormUtilsContextProvider;

package/dist/types/src/form/useForm.d.ts

@@ -1,16 +1,46 @@
-import { FormProps } from './Form';
-import { FieldValues, UseFormProps as RhfUseFormProps } from 'react-hook-form';
+import { FormUtilsContextProviderProps } from './context/utils/FormUtilsContextProvider';
+import { _FormProvidersProps } from './_FormProviders';
+import { _FormProps } from './_Form';
+import { z } from 'zod';
+import { SubmitErrorHandler, UseFormProps as RhfUseFormProps, UseFormReturn } from 'react-hook-form';
 import { default as React } from 'react';
+import { DevtoolUIProps } from '@hookform/devtools/dist/devToolUI';
 
-export type UseFormProps<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = {
+export type UseFormOptions = {
+    /**  */
+    hideRootErrorsList?: 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;
+    devTool?: DevtoolUIProps | 'disabled';
+};
+export type UseFormFieldProps<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>> = {
+    formId: string;
+    formRef: React.RefObject<HTMLFormElement>;
+    ctx: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
+    options?: UseFormOptions;
+};
+export type UseFormProps<TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>> = {
+    schema?: TSchema;
     /** {@link RhfUseFormProps} props for RHF's {@link useRhfForm}. */
     rhf?: RhfUseFormProps<TFieldValues>;
     /** {@link FormProps} props for Form. */
-    form?: Omit<FormProps<TFieldValues, TTransformedValues>, 'formId' | 'formRef'>;
+    form?: {
+        Fields?: React.FC<UseFormFieldProps<TSchema, TFieldValues, 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, context: UseFormReturn<TFieldValues, unknown, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => void;
+        /** Submit handler when form is invalid. */
+        onSubmitInvalid?: SubmitErrorHandler<TFieldValues>;
+        options?: UseFormOptions;
+        props?: React.PropsWithoutRef<JSX.IntrinsicElements['form']>;
+    };
+    utils?: FormUtilsContextProviderProps;
 };
-export type UseFormReturn = ReturnType<typeof useForm>;
 /**
- * Base Rhf Form hook. Use `Form` in `index.ts` for most cases.
+ * Core Rhf Form hook. Use `Form` in `index.ts` for most cases.
  * Use this if you need to separate form components.
  * e.g., a form for table row due to `form` being considered invalid HTML around `tr` tags.
  * With this hook, you can wrap the `tr` tag with `form.Provider` and use `form.Form` inside
@@ -18,12 +48,11 @@ export type UseFormReturn = ReturnType<typeof useForm>;
  * see https://caniuse.com/?search=form%20attribute
  * @returns Form provider and form.
  */
-declare const useForm: <TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ rhf, form, }: UseFormProps<TFieldValues, TTransformedValues>) => {
+declare const useForm: <TSchema extends z.SomeZodObject, TFieldValues extends z.input<TSchema>, TTransformedValues extends z.output<TSchema>>({ rhf, form, utils, }: UseFormProps<TSchema, TFieldValues, TTransformedValues>) => {
     readonly id: string;
     readonly ref: React.RefObject<HTMLFormElement>;
-    readonly context: import('react-hook-form').UseFormReturn<TFieldValues, unknown, TTransformedValues>;
-    readonly Form: React.FC<{
-        children?: React.ReactNode;
-    }>;
+    readonly context: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
+    readonly providerProps: _FormProvidersProps<TSchema, TFieldValues, TTransformedValues>;
+    readonly formProps: _FormProps<TSchema, TFieldValues, TTransformedValues>;
 };
 export default useForm;

package/dist/types/src/main.d.ts

@@ -1 +1,7 @@
-export {};
+import { default as React } from 'react';
+
+type Props = {
+    error: boolean;
+};
+declare const ToggleFormSpec: React.FC<Props>;
+export default ToggleFormSpec;

package/dist/types/src/submit/error/FormSubmitError.d.ts

@@ -1,6 +1,12 @@
 import { FieldPath, FieldValues } from 'react-hook-form';
 
 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);
+    errors: Record<FieldPath<TFieldValues> | `root.${string}`, {
+        type?: string;
+        message: string;
+    }>;
+    constructor(errors: Record<FieldPath<TFieldValues> | `root.${string}`, {
+        type?: string;
+        message: string;
+    }>, message?: string);
 }

package/dist/types/src/submit/error/setCtxErrorsByFormSubmitError.d.ts

@@ -0,0 +1,9 @@
+import { FormSubmitError } from './FormSubmitError';
+import { FieldValues, UseFormReturn } from 'react-hook-form';
+
+/**
+ * Handle thrown {@link FormSubmitError}.
+ * Add key/values as name/message to RHF context errors.
+ */
+declare const setCtxErrorsByFormSubmitError: <TFieldValues extends FieldValues, TTransformedValues extends FieldValues>(ctx: UseFormReturn<TFieldValues, unknown, TTransformedValues>, error: FormSubmitError<any>) => void;
+export default setCtxErrorsByFormSubmitError;

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

@@ -3,5 +3,7 @@
  * 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;
+declare const useResetFormOnSubmitError: (options?: {
+    disabled?: boolean;
+}) => void;
 export default useResetFormOnSubmitError;

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

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

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

@@ -0,0 +1,2 @@
+declare const isEmptyObject: (obj: Record<string, unknown>) => boolean;
+export default isEmptyObject;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
   "license": "MIT",
-  "version": "0.0.51",
+  "version": "0.0.56",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -21,6 +21,10 @@
       "default": "./dist/esm/exports.mjs",
       "types": "./dist/types/exports.d.ts"
     },
+    "./setConfig": {
+      "default": "./dist/esm/setConfig.mjs",
+      "types": "./dist/types/setConfig.d.ts"
+    },
     "./LazyDevTool": {
       "default": "./dist/esm/devtool/LazyDevTool.mjs",
       "types": "./dist/types/devtool/LazyDevTool.d.ts"
@@ -77,26 +81,10 @@
       "default": "./dist/esm/errors/root/useRootFormFieldErrors.mjs",
       "types": "./dist/types/errors/root/useRootFormFieldErrors.d.ts"
     },
-    "./form/Form": {
-      "default": "./dist/esm/form/Form.mjs",
-      "types": "./dist/types/form/Form.d.ts"
-    },
-    "./form/context/FormWithProviders": {
-      "default": "./dist/esm/form/context/FormWithProviders.mjs",
-      "types": "./dist/types/form/context/FormWithProviders.d.ts"
-    },
     "./form/useForm": {
       "default": "./dist/esm/form/useForm.mjs",
       "types": "./dist/types/form/useForm.d.ts"
     },
-    "./form/useFormWithProviders": {
-      "default": "./dist/esm/form/useFormWithProviders.mjs",
-      "types": "./dist/types/form/useFormWithProviders.d.ts"
-    },
-    "./form/context/FormProvider": {
-      "default": "./dist/esm/form/context/FormProvider.mjs",
-      "types": "./dist/types/form/context/FormProvider.d.ts"
-    },
     "./form/context/FormUtilsContextProvider": {
       "default": "./dist/esm/form/context/FormUtilsContextProvider.mjs",
       "types": "./dist/types/form/context/FormUtilsContextProvider.d.ts"
@@ -113,10 +101,18 @@
       "default": "./dist/esm/form/context/group/useFormGroupParentTracker.mjs",
       "types": "./dist/types/form/context/group/useFormGroupParentTracker.d.ts"
     },
+    "./form/context/group/useFormOrParentIsBusy": {
+      "default": "./dist/esm/form/context/group/useFormOrParentIsBusy.mjs",
+      "types": "./dist/types/form/context/group/useFormOrParentIsBusy.d.ts"
+    },
     "./form/context/group/useFormGroupChildIsSubmittingTracker": {
       "default": "./dist/esm/form/context/group/useFormGroupChildIsSubmittingTracker.mjs",
       "types": "./dist/types/form/context/group/useFormGroupChildIsSubmittingTracker.d.ts"
     },
+    "./form/context/group/useFormGroupChildTracker": {
+      "default": "./dist/esm/form/context/group/useFormGroupChildTracker.mjs",
+      "types": "./dist/types/form/context/group/useFormGroupChildTracker.d.ts"
+    },
     "./form/context/group/useFormGroupChildIsMountedTracker": {
       "default": "./dist/esm/form/context/group/useFormGroupChildIsMountedTracker.mjs",
       "types": "./dist/types/form/context/group/useFormGroupChildIsMountedTracker.d.ts"

package/dist/esm/errors/root/FormRootErrors.mjs

@@ -1,14 +0,0 @@
-import { jsx as t } from "react/jsx-runtime";
-import i from "../../isEmptyObject.mjs";
-const l = ({ errors: r, ...e }) => i(r) ? null : /* @__PURE__ */ t("ul", { ...e, children: Object.values(r).map((o) => /* @__PURE__ */ t(
-  "li",
-  {
-    role: "alert",
-    "aria-live": "polite",
-    children: o.message
-  },
-  JSON.stringify(o)
-)) }), n = l;
-export {
-  n as default
-};

package/dist/esm/errors/root/FormRootErrorsFromContext.mjs

@@ -1,11 +0,0 @@
-import { jsx as t } from "react/jsx-runtime";
-import { useFormErrorsFlatContextMaybe as s } from "../context/index.mjs";
-import m from "./FormRootErrors.mjs";
-const u = () => {
-  var o;
-  const r = (o = s()) == null ? void 0 : o.roots;
-  return r ? /* @__PURE__ */ t(m, { errors: r }) : null;
-};
-export {
-  u as default
-};

package/dist/esm/form/Form.mjs

@@ -1,63 +0,0 @@
-import { jsxs as C, jsx as t } from "react/jsx-runtime";
-import "react";
-import { useFormContext as O } from "react-hook-form";
-import v from "../devtool/LazyDevTool.mjs";
-import T from "../errors/root/FormRootErrorsFromContext.mjs";
-import V from "../submit/error/handleFormSubmitError.mjs";
-import j from "../submit/useResetFormOnSubmitError.mjs";
-import w from "../submit/useSubmitFormOnChange.mjs";
-import E from "../utils/useImperativeForwardedRef.mjs";
-import P from "./FormBase.mjs";
-function G({
-  formId: u,
-  formRef: h,
-  Fields: f,
-  //
-  onSubmit: d,
-  onSubmitError: l,
-  onSubmitInvalid: F,
-  //
-  options: r,
-  //
-  children: x,
-  ...g
-}) {
-  const m = O(), c = E(h);
-  w(c, !(r != null && r.submitOnChange)), j(!(r != null && r.resetValuesOnSubmitError));
-  const R = async (e) => {
-    r != null && r.stopSubmitPropagation && e.stopPropagation();
-    try {
-      await m.handleSubmit(b, F)(e);
-    } catch (a) {
-      y(a, e);
-    }
-  }, b = (e, a) => d == null ? void 0 : d(
-    e,
-    m,
-    a
-  ), y = (e, a) => {
-    V(e, m), l == null || l(e, m, a);
-  };
-  return /* @__PURE__ */ C(
-    P,
-    {
-      id: u,
-      onSubmit: R,
-      noValidate: !0,
-      style: {
-        position: "relative"
-      },
-      ...g,
-      ref: c,
-      children: [
-        (r == null ? void 0 : r.devTool) !== "disabled" && /* @__PURE__ */ t(v, { placement: "top-right", ...r == null ? void 0 : r.devTool }),
-        f && /* @__PURE__ */ t(f, { ctx: m }),
-        x,
-        !(r != null && r.hideRootErrors) && /* @__PURE__ */ t(T, {})
-      ]
-    }
-  );
-}
-export {
-  G as default
-};

package/dist/esm/form/FormBase.mjs

@@ -1,10 +0,0 @@
-import { jsxs as m, jsx as s } from "react/jsx-runtime";
-import "react";
-import a from "../utils/fixedForwardRef.mjs";
-const f = ({ antiCsrfToken: r, children: o, ...e }, t) => /* @__PURE__ */ m("form", { role: "form", ...e, ref: t, children: [
-  r && /* @__PURE__ */ s("input", { type: "hidden", name: "anticsrftoken", value: r }),
-  o
-] }), p = a(f);
-export {
-  p as default
-};

package/dist/esm/form/FormWithProviders.mjs

@@ -1,10 +0,0 @@
-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/FormProvider.mjs

@@ -1,25 +0,0 @@
-import { jsx as r } from "react/jsx-runtime";
-import { FormProvider as f } from "react-hook-form";
-import n from "./utils/FormUtilsContextProvider.mjs";
-function v({
-  formId: o,
-  formRef: m,
-  rhf: i,
-  form: t,
-  utils: e,
-  children: d
-}) {
-  return /* @__PURE__ */ r(f, { ...i, children: /* @__PURE__ */ r(
-    n,
-    {
-      formId: o,
-      formRef: m,
-      formProps: t,
-      ...e,
-      children: d
-    }
-  ) });
-}
-export {
-  v as default
-};

package/dist/esm/form/useFormWithProviders.mjs

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

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

@@ -1,12 +0,0 @@
-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/utils/fixedForwardRef.mjs

@@ -1,7 +0,0 @@
-import e from "react";
-function o(r) {
-  return e.forwardRef(r);
-}
-export {
-  o as default
-};

package/dist/esm/utils/useImperativeForwardedRef.mjs

@@ -1,16 +0,0 @@
-import r from "react";
-const a = (t) => {
-  const e = r.useRef(null);
-  return r.useImperativeHandle(
-    t,
-    () => {
-      if (!e.current)
-        throw new Error();
-      return e.current;
-    },
-    []
-  ), e;
-}, o = a;
-export {
-  o as default
-};