@paragrav/rhf-utils 0.0.107 → 0.0.109

package/README.md

@@ -68,6 +68,18 @@ export const config: RhfUtilsClientConfig = {
       </>
     ),
   },
+
+  errors: {
+    output: {
+      // callback to determine when to output form context errors to console ("debug" or "error")
+      console: ({ isDevelopment, hasOrphans }) =>
+        (hasOrphans && { type: 'error' }) || // report orphan errors early
+        (isDevelopment && { type: 'debug' }), // facilitate debugging on dev
+
+      // callback to determine when to throw an error based on context
+      throw: ({ isDevelopment, hasOrphans }) => isDevelopment && hasOrphans,
+    },
+  },
 };
 ```
 
@@ -155,12 +167,6 @@ type RhfUtilsFormOptions = {
   /** Stop propagation of submit event. Useful for portals. */
   stopSubmitPropagation?: boolean;
 
-  /** Disable `console.debug` of field errors in dev. */
-  disableFormErrorConsoleDebug?: boolean;
-
-  /** Disable `console.error` of orphan field errors. */
-  disableOrphanFormErrorsToConsole?: boolean;
-
   /** Reset form after successful submit. */
   resetFormAfterSubmitSuccessful?: Parameters<
     typeof useResetFormAfterSubmitSuccessful

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

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

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

@@ -5,6 +5,11 @@ import { RhfUtilsFormOptions } from '../../form/RhfUtilsFormOptions';
 import { UseFormFieldsProps } from '../../form/useForm';
 import { FormSubmitErrors } from '../../submit/error/FormSubmitErrors';
 
+/**
+ * Client configuration object.
+ *
+ * Options under `defaults` can be overridden at form level.
+ */
 export type RhfUtilsClientConfig = {
     /**
      * Some behavior is dependent on environment.
@@ -66,18 +71,14 @@ export type RhfUtilsClientConfig = {
              * - console.debug errors in development environment.
              * - console.error certain errors in production environment.
              */
-            console?: {
-                getConfig?: (context: RhfUtilsErrorsOutputConfigContext) => RhfUtilsErrorsOutputConsoleConfig | null;
-            };
+            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?: {
-                getConfig?: (context: RhfUtilsErrorsOutputConfigContext) => true | string | false;
-            };
+            throw?: (context: RhfUtilsErrorsOutputConfigContext) => true | string | false | undefined;
         };
     };
 };

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

@@ -19,14 +19,10 @@ export type RhfUtilsFormOptions = {
     resetValuesOnSubmitError?: boolean;
     /** Stop propagation of submit event. Useful for portals. */
     stopSubmitPropagation?: boolean;
-    /** Disable `console.debug` of field errors in dev. */
-    disableFormErrorConsoleDebug?: boolean;
-    /** Disable `console.error` of orphan field errors. */
-    disableOrphanFormErrorsToConsole?: boolean;
     /** Reset form after successful submit. */
     resetFormAfterSubmitSuccessful?: Parameters<typeof useResetFormAfterSubmitSuccessful>[0];
     /** Control dev tool options. */
     devTool?: Pick<DevtoolUIProps, 'placement' | 'styles'> | 'disabled';
 } & (Register extends {
-    UseFormOptions: infer _UseFormOptions;
-} ? _UseFormOptions : {});
+    RhfUtilsFormOptions: infer _RhfUtilsFormOptions;
+} ? _RhfUtilsFormOptions : {});

package/dist/types/register.d.ts

@@ -4,5 +4,4 @@
  * For example, `RhfUtilsFormOptions`.
  */
 export interface Register {
-    RhfUtilsFormOptions?: never;
 }

package/package.json

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