@paragrav/rhf-utils 0.0.35 → 0.0.36

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

@@ -0,0 +1,30 @@
+import { jsx as y } from "react/jsx-runtime";
+import s from "react";
+import { _FormGroupContextProvider as m } from "./index.mjs";
+const B = ({ children: o }) => {
+  const [t, u] = s.useState([]), n = t.length, a = s.useCallback((e, l) => {
+    u(
+      (r) => l ? (
+        // add to array
+        [...r, e]
+      ) : (
+        // remove from array
+        r.filter((c) => c !== e)
+      )
+    );
+  }, []), [d, i] = s.useState(!1);
+  return /* @__PURE__ */ y(m, { value: {
+    children: {
+      busyCount: n,
+      busyIds: t,
+      setBusyId: a
+    },
+    parent: {
+      isBusy: d,
+      setIsBusy: i
+    }
+  }, children: o });
+}, h = B;
+export {
+  h as default
+};

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

@@ -0,0 +1,11 @@
+import o from "../../../utils/createContext.mjs";
+const [
+  t,
+  e,
+  m
+] = o();
+export {
+  m as _FormGroupContextProvider,
+  e as _useFormGroupContext,
+  t as _useFormGroupContextMaybe
+};

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

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

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

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

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

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

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

@@ -0,0 +1,8 @@
+import { _useFormGroupContextMaybe as s } from "./index.mjs";
+const r = () => {
+  const o = s();
+  return !!(o != null && o.children.busyCount) || !!(o != null && o.parent.isBusy);
+}, e = r;
+export {
+  e as default
+};

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

@@ -0,0 +1,8 @@
+import { _useFormGroupContextMaybe as r } from "./index.mjs";
+const s = () => {
+  const o = r();
+  return !!(o != null && o.children.busyCount);
+}, e = s;
+export {
+  e as default
+};

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

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

package/dist/esm/form/useFormIsBusy.mjs

@@ -1,9 +1,8 @@
-import { useFormState as r } from "react-hook-form";
-import e from "./context/parent/useFormParentIsBusy.mjs";
-const m = () => {
-  const { isSubmitting: t, isLoading: o } = r(), s = e();
-  return !!(t || o || s);
+import { useFormState as s } from "react-hook-form";
+const r = () => {
+  const { isSubmitting: o, isLoading: t } = s();
+  return !!(o || t);
 };
 export {
-  m as default
+  r as default
 };

package/dist/esm/main.mjs

@@ -1,48 +1,56 @@
 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 m } from "./errors/message/FormErrorMessage.mjs";
+import { default as a } 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 p } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
+import { default as F } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
 import { default as n } from "./errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs";
-import { default as i } from "./errors/orphan/useFormHasOrphanAndNoFieldErrors.mjs";
-import { default as b } from "./errors/orphan/useOrphanFormErrorsMemo.mjs";
-import { default as M } from "./errors/orphan/useOrphanFormErrorsToConsole.mjs";
-import { default as P } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
-import { default as O } from "./errors/useFormErrorConsoleDebug.mjs";
-import { default as h } from "./errors/useFormErrorsEffect.mjs";
-import { default as R } from "./errors/useFormErrorsIfAny.mjs";
-import { default as B } from "./errors/useFormErrorsMemo.mjs";
-import { default as N } from "./errors/useFormRequestSubmit.mjs";
-import { default as H } from "./form/context/parent/FormParentContextProvider.mjs";
-import { default as T } from "./form/context/parent/useAsFormParentState.mjs";
-import { default as z } from "./form/context/parent/useFormParentIsBusy.mjs";
-import { default as j } from "./form/utils/getSubmitterButtonData.mjs";
-import { default as G } from "./submit/useFormOnSubmitSuccessful.mjs";
-import { default as K } from "./submit/useFormOnSubmitSuccessfulAndReset.mjs";
-import { default as U } from "./submit/useResetFormOnSubmitSuccessful.mjs";
+import { default as E } from "./errors/orphan/useFormHasOrphanAndNoFieldErrors.mjs";
+import { default as S } from "./errors/orphan/useOrphanFormErrorsMemo.mjs";
+import { default as C } from "./errors/orphan/useOrphanFormErrorsToConsole.mjs";
+import { default as h } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
+import { default as A } from "./errors/useFormErrorConsoleDebug.mjs";
+import { default as I } from "./errors/useFormErrorsEffect.mjs";
+import { default as B } from "./errors/useFormErrorsIfAny.mjs";
+import { default as P } from "./errors/useFormErrorsMemo.mjs";
+import { default as R } from "./errors/useFormRequestSubmit.mjs";
+import { default as v } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as N } from "./form/context/group/useAsFormGroupParent.mjs";
+import { default as q } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as L } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as w } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as K } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as U } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as W } from "./form/utils/getSubmitterButtonData.mjs";
+import { default as Y } from "./submit/useFormOnSubmitSuccessful.mjs";
+import { default as _ } from "./submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import { default as rr } from "./submit/useResetFormOnSubmitSuccessful.mjs";
 export {
-  m as FormErrorMessage,
+  f as FormErrorMessage,
   d as FormErrorMessageByPath,
-  u as FormErrorsFlatContextProvider,
-  p as FormNonFieldErrorMarker,
+  a as FormErrorsFlatContextProvider,
+  v as FormGroupContextProvider,
+  F as FormNonFieldErrorMarker,
   n as FormNonFieldErrorMarkerHtmlAttribute,
-  H as FormParentContextProvider,
   e as LazyDevTool,
-  j as getSubmitterButtonData,
-  T as useAsFormParentState,
-  O as useFormErrorConsoleDebug,
-  h as useFormErrorsEffect,
+  W as getSubmitterButtonData,
+  N as useAsFormGroupParent,
+  A as useFormErrorConsoleDebug,
+  I as useFormErrorsEffect,
   s as useFormErrorsFlatContext,
-  R as useFormErrorsIfAny,
-  B as useFormErrorsMemo,
-  i as useFormHasOrphanAndNoFieldErrors,
-  G as useFormOnSubmitSuccessful,
-  K as useFormOnSubmitSuccessfulAndReset,
-  z as useFormParentIsBusy,
-  N as useFormRequestSubmit,
-  b as useOrphanFormErrorsMemo,
-  M as useOrphanFormErrorsToConsole,
-  U as useResetFormAfterSubmitSuccessful,
-  P as useRootFormFieldErrorsMemo
+  B as useFormErrorsIfAny,
+  P as useFormErrorsMemo,
+  q as useFormGroupChildIsMountedTracker,
+  L as useFormGroupChildIsSubmittingTracker,
+  w as useFormGroupIsAnyBusy,
+  K as useFormGroupIsChildBusy,
+  U as useFormGroupIsParentBusy,
+  E as useFormHasOrphanAndNoFieldErrors,
+  Y as useFormOnSubmitSuccessful,
+  _ as useFormOnSubmitSuccessfulAndReset,
+  R as useFormRequestSubmit,
+  S as useOrphanFormErrorsMemo,
+  C as useOrphanFormErrorsToConsole,
+  rr as useResetFormAfterSubmitSuccessful,
+  h as useRootFormFieldErrorsMemo
 };

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

@@ -1,3 +1,13 @@
 import { FieldError } from 'react-hook-form';
 
+/**
+ * Flattened field errors object.
+ *
+ * @example
+ * ```ts
+ * {
+ *   'address.street': FieldError
+ * }
+ * ```
+ */
 export type FlatFieldErrors = Record<string, FieldError>;

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

@@ -2,7 +2,7 @@ import { FlatFieldErrors } from '../flat/types';
 import { FieldErrors } from 'react-hook-form';
 
 /**
- * Pending.
+ * Generate {@link FlatFieldErrors} object from {@link FieldErrors}.
  */
 declare const getRootFlatFieldErrors: (errors: FieldErrors) => FlatFieldErrors;
 export default getRootFlatFieldErrors;

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

@@ -1,7 +1,7 @@
 import { FormBaseProps } from './FormBase';
-import { LazyDevToolProps } from '../devtool/LazyDevTool';
 import { FieldValues, SubmitErrorHandler, UseFormReturn } from 'react-hook-form';
 import { default as React } from 'react';
+import { DevtoolUIProps } from '@hookform/devtools/dist/devToolUI';
 
 export type FormProps<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = Omit<FormBaseProps, 'onSubmit'> & {
     isDev: boolean;
@@ -12,8 +12,9 @@ export type FormProps<TFieldValues extends FieldValues, TTransformedValues exten
     /** Submit handler when form is invalid. */
     onSubmitInvalid?: SubmitErrorHandler<TFieldValues>;
     options?: {
+        stopSubmitPropagation?: boolean;
         disableEmptyRootError?: boolean;
-        devTool?: LazyDevToolProps | 'disabled';
+        devTool?: DevtoolUIProps | 'disabled';
     };
     className?: string;
 };

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

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+
+type Props = React.PropsWithChildren;
+declare const FormGroupContextProvider: React.FC<Props>;
+export default FormGroupContextProvider;

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

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+export type FormGroupContext = {
+    children: {
+        busyIds: string[];
+        busyCount: number;
+        setBusyId: (id: string, isBusy: boolean) => void;
+    };
+    parent: {
+        isBusy: boolean;
+        setIsBusy: (isBusy: boolean) => void;
+    };
+};
+export declare const _useFormGroupContextMaybe: () => FormGroupContext | undefined, _useFormGroupContext: () => FormGroupContext, _FormGroupContextProvider: import('react').Provider<FormGroupContext | undefined>;

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

@@ -0,0 +1,7 @@
+/**
+ * Connect specific form state as parent context.
+ *
+ * Requires usage of provider.
+ */
+declare const useAsFormGroupParent: () => void;
+export default useAsFormGroupParent;

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/types/main.d.ts

@@ -14,9 +14,13 @@ 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 FormParentContextProvider } from './form/context/parent/FormParentContextProvider';
-export { default as useAsFormParentState } from './form/context/parent/useAsFormParentState';
-export { default as useFormParentIsBusy } from './form/context/parent/useFormParentIsBusy';
+export { default as FormGroupContextProvider } from './form/context/group/FormGroupContextProvider';
+export { default as useAsFormGroupParent } from './form/context/group/useAsFormGroupParent';
+export { default as useFormGroupChildIsMountedTracker } from './form/context/group/useFormGroupChildIsMountedTracker';
+export { default as useFormGroupChildIsSubmittingTracker } from './form/context/group/useFormGroupChildIsSubmittingTracker';
+export { default as useFormGroupIsAnyBusy } from './form/context/group/useFormGroupIsAnyBusy';
+export { default as useFormGroupIsChildBusy } from './form/context/group/useFormGroupIsChildBusy';
+export { default as useFormGroupIsParentBusy } from './form/context/group/useFormGroupIsParentBusy';
 export { default as getSubmitterButtonData } from './form/utils/getSubmitterButtonData';
 export { default as useFormOnSubmitSuccessful } from './submit/useFormOnSubmitSuccessful';
 export { default as useFormOnSubmitSuccessfulAndReset } from './submit/useFormOnSubmitSuccessfulAndReset';

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

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+
+declare const useToggle: (defaultValue?: boolean) => [boolean, React.DispatchWithoutAction];
+export default useToggle;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
   "license": "MIT",
-  "version": "0.0.35",
+  "version": "0.0.36",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -71,17 +71,33 @@
       "default": "./dist/esm/errors/root/useRootFormFieldErrors.mjs",
       "types": "./dist/types/errors/root/useRootFormFieldErrors.d.ts"
     },
-    "./form/context/parent/FormParentContextProvider": {
-      "default": "./dist/esm/form/context/parent/FormParentContextProvider.mjs",
-      "types": "./dist/types/form/context/parent/FormParentContextProvider.d.ts"
+    "./form/context/group/FormGroupContextProvider": {
+      "default": "./dist/esm/form/context/group/FormGroupContextProvider.mjs",
+      "types": "./dist/types/form/context/group/FormGroupContextProvider.d.ts"
     },
-    "./form/context/parent/useAsFormParentState": {
-      "default": "./dist/esm/form/context/parent/useAsFormParentState.mjs",
-      "types": "./dist/types/form/context/parent/useAsFormParentState.d.ts"
+    "./form/context/group/useAsFormGroupParent": {
+      "default": "./dist/esm/form/context/group/useAsFormGroupParent.mjs",
+      "types": "./dist/types/form/context/group/useAsFormGroupParent.d.ts"
     },
-    "./form/context/parent/useFormParentIsBusy": {
-      "default": "./dist/esm/form/context/parent/useFormParentIsBusy.mjs",
-      "types": "./dist/types/form/context/parent/useFormParentIsBusy.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/useFormGroupChildIsMountedTracker": {
+      "default": "./dist/esm/form/context/group/useFormGroupChildIsMountedTracker.mjs",
+      "types": "./dist/types/form/context/group/useFormGroupChildIsMountedTracker.d.ts"
+    },
+    "./form/context/group/useFormGroupIsAnyBusy": {
+      "default": "./dist/esm/form/context/group/useFormGroupIsAnyBusy.mjs",
+      "types": "./dist/types/form/context/group/useFormGroupIsAnyBusy.d.ts"
+    },
+    "./form/context/group/useFormGroupIsChildBusy": {
+      "default": "./dist/esm/form/context/group/useFormGroupIsChildBusy.mjs",
+      "types": "./dist/types/form/context/group/useFormGroupIsChildBusy.d.ts"
+    },
+    "./form/context/group/useFormGroupIsParentBusy": {
+      "default": "./dist/esm/form/context/group/useFormGroupIsParentBusy.mjs",
+      "types": "./dist/types/form/context/group/useFormGroupIsParentBusy.d.ts"
     },
     "./form/context/utils/getSubmitterButtonData": {
       "default": "./dist/esm/form/utils/getSubmitterButtonData.mjs",

package/dist/esm/form/context/parent/FormParentContextProvider.mjs

@@ -1,10 +0,0 @@
-import { jsx as e } from "react/jsx-runtime";
-import s from "react";
-import { _FormParentContextProvider as n } from "./index.mjs";
-const a = ({ children: t }) => {
-  const [r, o] = s.useState(!1);
-  return /* @__PURE__ */ e(n, { value: { isBusy: r, setIsBusy: o }, children: t });
-}, P = a;
-export {
-  P as default
-};

package/dist/esm/form/context/parent/index.mjs

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

package/dist/esm/form/context/parent/useAsFormParentState.mjs

@@ -1,14 +0,0 @@
-import o from "react";
-import r from "../../useFormIsBusy.mjs";
-import { _useFormParentContext as s } from "./index.mjs";
-const n = () => {
-  const e = r(), t = s();
-  if (!t)
-    throw new Error("Parent context is not provided.");
-  o.useEffect(() => {
-    t.setIsBusy(e);
-  }, [t, e]);
-}, c = n;
-export {
-  c as default
-};

package/dist/esm/form/context/parent/useFormParentIsBusy.mjs

@@ -1,8 +0,0 @@
-import { _useFormParentContext as t } from "./index.mjs";
-const e = () => {
-  var s;
-  return (s = t()) == null ? void 0 : s.isBusy;
-}, r = e;
-export {
-  r as default
-};