@paragrav/rhf-utils 0.0.115 → 0.0.116

package/README.md

@@ -161,7 +161,7 @@ function Children({...}: RhfUtilsUseFormChildrenZodProps<typeof schema>) { }
 
 ## `FormSubmitError`
 
-This is a derived `Error` class you can use to throw a structured error in your submit handler. It is strongly-typed, so it only allows field names in schema and `root`/`root.{string}` keys.
+This is an `Error`-based class you can use to throw a structured error in your submit handler. It is strongly-typed, so it only allows field names in schema and `root`/`root.{string}` keys.
 
 It uses `FormSubmitErrors` shape, which is a flat (dot notation) equivalent of RHF's `FieldErrors`.
 
@@ -263,8 +263,9 @@ Example use case: Field array with minimum items. (When there are no items, the
 
 Orphans are optionally exposed in a few places.
 
-- In errors outputted via console.
+- In errors outputted via console. (Configured via `RhfUtilsClientConfig['errors']['output']`.)
 - And `useFlatFieldErrorsContext()` hook, which returns an object with divided into `all`, `root`, and `orphans` errors.
+- Boolean value from `useFlatFieldErrorsContextHasOnlyOrphans`.
 
 `FlatFieldErrors` is a flattened, simplified version of RHF's `FieldErrors`. Keys represent field paths flattened to dot notation.
 

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

@@ -1,23 +1,21 @@
-import { jsx as s } from "react/jsx-runtime";
+import { jsx as m } from "react/jsx-runtime";
+import "react";
+import { useFormState as i } from "react-hook-form";
 import l from "../../orphan/getOrphansFromFlatFieldErrors.mjs";
 import F from "../../root/getRootsFromFlatFieldErrors.mjs";
-import a from "../../useFormErrorsTransformMemo.mjs";
-import i from "../getFlatFieldErrors.mjs";
+import a from "../getFlatFieldErrors.mjs";
 import { _FormErrorsFlatContextProvider as n } from "./useFlatFieldErrorsContext.mjs";
-const x = ({
+const g = ({
   formRef: o,
   children: t
 }) => {
-  const e = a((m) => {
-    const r = i(m);
-    return {
-      all: r,
-      roots: F(r),
-      orphans: o.current ? l(r, o.current) : {}
-    };
-  });
-  return /* @__PURE__ */ s(n, { value: e, children: t });
+  const { errors: e } = i(), r = a(e), s = {
+    all: r,
+    roots: F(r),
+    orphans: o.current ? l(r, o.current) : {}
+  };
+  return /* @__PURE__ */ m(n, { value: s, children: t });
 };
 export {
-  x as default
+  g as default
 };

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

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

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

@@ -0,0 +1,10 @@
+import t from "react";
+import s from "../../../utils/isEmptyObject.mjs";
+import e from "./useFlatFieldErrorsContext.mjs";
+const n = () => {
+  const r = e();
+  return t.useMemo(() => s(r.orphans) ? !1 : Object.keys(r.orphans).length === Object.keys(r.all).length, [r]);
+}, O = n;
+export {
+  O as default
+};

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

@@ -0,0 +1,29 @@
+import h from "react";
+import { useFormContext as E } from "react-hook-form";
+import c from "../../../utils/isEmptyObject.mjs";
+import F from "../../output/consoleErrors.mjs";
+import x from "./useFlatFieldErrorsContext.mjs";
+const g = (e) => {
+  const i = E(), o = x();
+  h.useEffect(() => {
+    var p, r, l, u, t, a;
+    if (c(o.all))
+      return;
+    const m = {
+      isDevelopment: e.isDevelopment,
+      hasOrphans: !c(o.orphans)
+    }, s = (l = (r = (p = e.errors) == null ? void 0 : p.output) == null ? void 0 : r.console) == null ? void 0 : l.call(r, m);
+    s && F(
+      s.message ?? f,
+      i.getValues(),
+      o,
+      s.type
+    );
+    const n = (a = (t = (u = e.errors) == null ? void 0 : u.output) == null ? void 0 : t.throw) == null ? void 0 : a.call(t, m);
+    if (n)
+      throw new Error(typeof n == "string" ? n : f);
+  }, [o]);
+}, f = "Form errors";
+export {
+  g as default
+};

package/dist/esm/exports.mjs

@@ -2,47 +2,49 @@ import { default as e } from "./client/zod/context/RhfUtilsClientForZodContextPr
 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";
+import { default as d } from "./errors/flat/context/useFlatFieldErrorsContextHasOnlyOrphans.mjs";
+import { default as x } from "./errors/message/FormErrorMessageByPath.mjs";
+import { default as F } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
+import { default as C } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
+import { getOnSubmitTrpcClientErrorHandler as E } from "./errors/trpc/getOnSubmitTrpcClientErrorHandler.mjs";
+import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as R } from "./errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
+import { default as b } from "./form/context/utils/useRhfUtilsContext.mjs";
+import { default as y } from "./form/context/utils/useRhfUtilsContextRequestSubmit.mjs";
+import { default as B } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as P } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as U } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as O } from "./form/context/group/useFormGroupChildTracker.mjs";
+import { default as Z } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as v } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as A } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as L } from "./form/context/group/useFormGroupParentTracker.mjs";
+import { default as j } from "./form/context/group/useFormOrParentIsBusy.mjs";
+import { default as z } from "./form/utils/getSubmitterButtonData.mjs";
+import { default as K } from "./form/utils/useFormRequestSubmit.mjs";
+import { FormSubmitError as V } from "./submit/error/FormSubmitError.mjs";
 export {
-  d as FormErrorMessageByPath,
-  T as FormGroupContextProvider,
-  x as FormNonFieldErrorMarker,
-  K as FormSubmitError,
+  x as FormErrorMessageByPath,
+  B as FormGroupContextProvider,
+  F as FormNonFieldErrorMarker,
+  V as FormSubmitError,
   e as RhfUtilsClientForZodContextProvider,
   s as RhfUtilsZodForm,
-  F as RootErrorsListFromFlatFieldErrorsContext,
-  C as getOnSubmitTrpcClientErrorHandler,
-  j as getSubmitterButtonData,
-  E as trpcClientErrorToFormSubmitErrorsSchemaTransformer,
+  C as RootErrorsListFromFlatFieldErrorsContext,
+  E as getOnSubmitTrpcClientErrorHandler,
+  z as getSubmitterButtonData,
+  R 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,
+  d as useFlatFieldErrorsContextHasOnlyOrphans,
+  P as useFormGroupChildIsMountedTracker,
+  U as useFormGroupChildIsSubmittingTracker,
+  O as useFormGroupChildTracker,
+  Z as useFormGroupIsAnyBusy,
+  v as useFormGroupIsChildBusy,
+  A as useFormGroupIsParentBusy,
+  L as useFormGroupParentTracker,
+  j as useFormOrParentIsBusy,
+  K as useFormRequestSubmit,
+  b as useRhfUtilsContext,
+  y as useRhfUtilsContextRequestSubmit,
   u as useRhfUtilsZodForm
 };

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

@@ -1,27 +1,33 @@
 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,
+import C from "../../../client/config/useRhfUtilsClientConfigContext.mjs";
+import F from "../../../errors/flat/context/useFlatFieldErrorsContextOutput.mjs";
+import x from "../../../submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import O from "../../../submit/useResetFormOnSubmitError.mjs";
+import b from "../../../submit/useResetFormOnSubmitSuccessful.mjs";
+import h from "../../../submit/useSubmitFormOnChange.mjs";
+import { _RhfUtilsContextProvider as v } from "./useRhfUtilsContext.mjs";
+const y = ({
+  formId: l,
+  formRef: t,
   onSubmitSuccessfulAndReset: m,
   options: r,
   children: a
-}) {
-  return t(), b(e, {
+}) => {
+  var u;
+  const e = C();
+  return F({
+    ...(u = e == null ? void 0 : e.errors) == null ? void 0 : u.output,
+    isDevelopment: e == null ? void 0 : e.isDevelopment
+  }), h(t, {
     disabled: !(r != null && r.submitOnChange)
-  }), F({
+  }), O({
     disabled: !(r != null && r.resetValuesOnSubmitError)
-  }), O(
+  }), b(
     (r == null ? void 0 : r.resetFormAfterSubmitSuccessful) || !!m
-  ), l(() => {
+  ), x(() => {
     m == null || m();
-  }), /* @__PURE__ */ f(d, { value: { formId: u, formRef: e, options: r }, children: a });
-}
+  }), /* @__PURE__ */ f(v, { value: { formId: l, formRef: t, options: r }, children: a });
+};
 export {
-  P as default
+  y as default
 };

package/dist/types/client/config/RhfUtilsClientConfig.d.ts

@@ -1,5 +1,5 @@
 import { UseFormProps } from 'react-hook-form';
-import { RhfUtilsErrorsOutputConfigContext, RhfUtilsErrorsOutputConsoleConfig } from '../../errors/output/types';
+import { FlatFieldErrorsOutputConfig } from '../../errors/flat/context/FlatFieldErrorsOutputConfig';
 import { FormChildrenSlots } from '../../form/Form';
 import { RhfUtilsFormOptions } from '../../form/RhfUtilsFormOptions';
 import { UseRhfUtilsFormChildrenProps } from '../../form/UseRhfUtilsFormChildrenProps';
@@ -61,22 +61,6 @@ export type RhfUtilsClientConfig = {
         /**
          * Configure how/if errors should be outputted.
          */
-        output?: {
-            /**
-             * Configure how/if errors should be outputted to console.
-             *
-             * Example use cases:
-             * - console.debug errors in development environment.
-             * - console.error certain errors in production environment.
-             */
-            console?: (context: RhfUtilsErrorsOutputConfigContext) => RhfUtilsErrorsOutputConsoleConfig | null | false | undefined;
-            /**
-             * Configure how/if errors should be thrown.
-             *
-             * Example use case:
-             * - bring attention to certain errors in development environment.
-             */
-            throw?: (context: RhfUtilsErrorsOutputConfigContext) => true | string | false | undefined;
-        };
+        output?: FlatFieldErrorsOutputConfig;
     };
 };

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

@@ -1,4 +1,5 @@
-/// <reference types="react" />
+import { default as React } from 'react';
+
 type Props = React.PropsWithChildren<{
     formRef: React.RefObject<HTMLFormElement>;
 }>;

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

@@ -0,0 +1,19 @@
+import { RhfUtilsErrorsOutputConfigContext, RhfUtilsErrorsOutputConsoleConfig } from '../../output/types';
+
+export type FlatFieldErrorsOutputConfig = {
+    /**
+     * Configure how/if errors should be outputted to console.
+     *
+     * Example use cases:
+     * - console.debug errors in development environment.
+     * - console.error certain errors in production environment.
+     */
+    console?: (context: RhfUtilsErrorsOutputConfigContext) => RhfUtilsErrorsOutputConsoleConfig | null | false | undefined;
+    /**
+     * Configure how/if errors should be thrown.
+     *
+     * Example use case:
+     * - bring attention to certain errors in development environment.
+     */
+    throw?: (context: RhfUtilsErrorsOutputConfigContext) => true | string | false | undefined;
+};

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

@@ -5,6 +5,6 @@ export type FlatFieldErrorsContext = {
     roots: FlatFieldErrors;
     orphans: FlatFieldErrors;
 };
-declare const useFlatFieldErrorsContextMaybe: () => FlatFieldErrorsContext | undefined, useFlatFieldErrorsContext: () => FlatFieldErrorsContext, _FormErrorsFlatContextProvider: import('react').Provider<FlatFieldErrorsContext | undefined>;
+declare const useFlatFieldErrorsContext: () => FlatFieldErrorsContext, _FormErrorsFlatContextProvider: import('react').Provider<FlatFieldErrorsContext | undefined>;
 export default useFlatFieldErrorsContext;
-export { _FormErrorsFlatContextProvider, useFlatFieldErrorsContextMaybe };
+export { _FormErrorsFlatContextProvider };

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

@@ -0,0 +1,7 @@
+/**
+ * Returns `true` if all errors are orphans.
+ *
+ * You may want to treat this case specifically.
+ */
+declare const useFlatFieldErrorsContextHasOnlyOrphans: () => boolean;
+export default useFlatFieldErrorsContextHasOnlyOrphans;

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

@@ -0,0 +1,7 @@
+import { RhfUtilsClientConfig } from '../../../client/config/RhfUtilsClientConfig';
+
+/**
+ * Outputs (e.g., console, throw) errors based on config.
+ */
+declare const useFlatFieldErrorsContextOutput: (config: RhfUtilsClientConfig) => void;
+export default useFlatFieldErrorsContextOutput;

package/dist/types/exports.d.ts

@@ -6,6 +6,7 @@ export { default as useRhfUtilsZodForm } from './client/zod/context/useRhfUtilsZ
 export type { RhfUtilsUseFormChildrenZodFC } from './client/zod/RhfUtilsUseFormChildrenZodFC';
 export type { RhfUtilsUseFormChildrenZodProps } from './client/zod/RhfUtilsUseFormChildrenZodProps';
 export { default as useFlatFieldErrorsContext } from './errors/flat/context/useFlatFieldErrorsContext';
+export { default as useFlatFieldErrorsContextHasOnlyOrphans } from './errors/flat/context/useFlatFieldErrorsContextHasOnlyOrphans';
 export { default as FormErrorMessageByPath } from './errors/message/FormErrorMessageByPath';
 export { default as FormNonFieldErrorMarker } from './errors/nonfield/FormNonFieldErrorMarker';
 export { default as RootErrorsListFromFlatFieldErrorsContext } from './errors/root/RootErrorsListFromFlatFieldErrorsContext';

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

@@ -7,5 +7,5 @@ type Props = React.PropsWithChildren<{
     onSubmitSuccessfulAndReset?: () => void;
     options?: RhfUtilsFormOptions;
 }>;
-declare function RhfUtilsContextProvider({ formId, formRef, onSubmitSuccessfulAndReset, options, children, }: Props): import("react/jsx-runtime").JSX.Element;
+declare const RhfUtilsContextProvider: React.FC<Props>;
 export default RhfUtilsContextProvider;

package/package.json

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

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

@@ -1,30 +0,0 @@
-import h from "react";
-import { useFormContext as E } from "react-hook-form";
-import F from "../../client/config/useRhfUtilsClientConfigContext.mjs";
-import i from "../../utils/isEmptyObject.mjs";
-import x from "../output/consoleErrors.mjs";
-import C from "./context/useFlatFieldErrorsContext.mjs";
-const D = () => {
-  const c = E(), t = F(), r = C();
-  h.useEffect(() => {
-    var p, o, l, u, e, a;
-    if (i(r.all))
-      return;
-    const n = {
-      isDevelopment: t == null ? void 0 : t.isDevelopment,
-      hasOrphans: !i(r.orphans)
-    }, s = (l = (o = (p = t == null ? void 0 : t.errors) == null ? void 0 : p.output) == null ? void 0 : o.console) == null ? void 0 : l.call(o, n);
-    s && x(
-      s.message ?? f,
-      c.getValues(),
-      r,
-      s.type
-    );
-    const m = (a = (e = (u = t == null ? void 0 : t.errors) == null ? void 0 : u.output) == null ? void 0 : e.throw) == null ? void 0 : a.call(e, n);
-    if (m)
-      throw new Error(typeof m == "string" ? m : f);
-  }, [r]);
-}, f = "Form errors";
-export {
-  D as default
-};

package/dist/esm/errors/useFormErrorsTransformMemo.mjs

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