@paragrav/rhf-utils 0.0.106 → 0.0.108

package/README.md

@@ -16,20 +16,21 @@ To configure, create a file like `src/integrations/paragrav-rhf-utils/config.tsx
 export const config: RhfUtilsClientConfig = {
   isDevelopment: import.meta.env.DEV,
 
-  defaultOptions: {
-    // UseFormProps
+  defaults: {
+    // globally relevant subset of RHF's `UseFormProps` options
     rhf: {
       mode: 'onBlur',
     },
 
-    // UseFormOptions
-    form: {
+    // RhfUtilsFormOptions (see further below)
+    utils: {
       devTool: {
         placement: 'top-right',
       },
     },
   },
 
+  // optional (defaults to primitive HTML form)
   FormComponent: Form.Root,
 
   // transform backend error
@@ -46,7 +47,13 @@ export const config: RhfUtilsClientConfig = {
 
   Children: {
     top: (
-      { options }, // UseFormFieldsProps
+      {
+        formId, //     unique id string
+        formRef, //    ref
+        context, //    rhf UseFormReturn
+        options, //    RhfUtilsFormOptions
+        Controller, // strongly-typed controller
+      }, // UseFormFieldsProps
     ) => {
       // navigation blocker (using custom option)
       useFormRouterBlocker(!!options?.prompter);
@@ -61,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,
+    },
+  },
 };
 ```
 
@@ -96,13 +115,15 @@ And add the context provider to your stack:
     onError(error);
   }}
   // fields
-  Fields={({
-    formId, //     unique id string
-    formRef, //    ref
-    context, //    rhf UseFormReturn
-    options, //    UseFormOptions
-    Controller, // strongly-typed controlled
-  }) => (
+  Fields={(
+    {
+      formId, //     unique id string
+      formRef, //    ref
+      context, //    rhf UseFormReturn
+      options, //    RhfUtilsFormOptions
+      Controller, // strongly-typed controller
+    }, // UseFormFieldsProps
+  ) => (
     <>
       <Controller
         name="email" // strongly-typed field name
@@ -125,16 +146,47 @@ And add the context provider to your stack:
 
 `Fields` is a component which is rendered as a child of the form. It receives `UseFormFieldsProps` as props, including type-safe `Controller`.
 
-## Extend Options
+## `RhfUtilsFormOptions`
+
+These options can be set globally and/or per form.
+
+```ts
+type RhfUtilsFormOptions = {
+  /**
+   * Control visibility of certain items via your own classes and styles.
+   * (Defaults merged with individual class names.)
+   */
+  classNames?: string[];
+
+  /** 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;
+
+  /** Stop propagation of submit event. Useful for portals. */
+  stopSubmitPropagation?: boolean;
+
+  /** Reset form after successful submit. */
+  resetFormAfterSubmitSuccessful?: Parameters<
+    typeof useResetFormAfterSubmitSuccessful
+  >[0];
+
+  /** Control dev tool options. */
+  devTool?: Pick<DevtoolUIProps, 'placement' | 'styles'> | 'disabled';
+};
+```
+
+## Extend `RhfUtilsFormOptions`
 
-Extend `UseFormOptions` with custom options, which get passed to `Fields` component in `options` prop.
+Extend `RhfUtilsFormOptions` with custom options, which get passed to `Fields` component in `options` prop.
 
 ```tsx
 import '@paragrav/rhf-utils';
 
 declare module '@paragrav/rhf-utils' {
   export interface Register {
-    UseFormOptions: {
+    RhfUtilsFormOptions: {
       /** Enable user prompt to confirm navigating away from dirty form. */
       prompter?: boolean;
     };

package/dist/esm/src/client/index.mjs

@@ -0,0 +1,55 @@
+import { jsx as h } from "react/jsx-runtime";
+import F from "../form/FormWithProviders.mjs";
+import f from "../form/useForm.mjs";
+const W = (e) => (r) => {
+  const m = d(
+    e,
+    r
+  );
+  return {
+    useForm: (i, s) => {
+      const t = m(i, s);
+      return {
+        ...f(t),
+        FormWithProviders: ({
+          children: o
+        }) => /* @__PURE__ */ h(F, { ...t, children: o })
+      };
+    },
+    FormWithProviders: a(e, r)
+  };
+}, d = (e, r) => function(i, s) {
+  var t, o, n, u, l;
+  return {
+    ...s,
+    rhf: {
+      ...(t = r.defaults) == null ? void 0 : t.rhf,
+      ...s.rhf,
+      resolver: e(i)
+    },
+    utils: {
+      ...(o = r.defaults) == null ? void 0 : o.utils,
+      ...s.utils,
+      classNames: [
+        ...((u = (n = r.defaults) == null ? void 0 : n.utils) == null ? void 0 : u.classNames) ?? [],
+        ...((l = s.utils) == null ? void 0 : l.classNames) ?? []
+      ]
+    }
+  };
+}, a = (e, r) => function({
+  schema: i,
+  children: s,
+  ...t
+}) {
+  const o = d(e, r);
+  return /* @__PURE__ */ h(
+    F,
+    {
+      ...o(i, t),
+      children: s
+    }
+  );
+};
+export {
+  W as createRhfUtilsClient
+};

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

@@ -0,0 +1,30 @@
+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/src/errors/trpc/getOnSubmitTrpcClientErrorHandler.mjs

@@ -0,0 +1,7 @@
+import { TRPCClientError as o } from "../../../node_modules/.pnpm/@trpc_client@11.0.0-rc.390_@trpc_server@11.0.0-rc.390/node_modules/@trpc/client/dist/TRPCClientError.mjs";
+import "../../../node_modules/.pnpm/@trpc_server@11.0.0-rc.390/node_modules/@trpc/server/dist/unstable-core-do-not-import/rootConfig.mjs";
+import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as n } from "./trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
+const p = (t) => (r) => r instanceof o ? n.parse(r) : t(r);
+export {
+  p as getOnSubmitTrpcClientErrorHandler
+};

package/dist/esm/src/errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs

@@ -0,0 +1,35 @@
+import { TRPCClientError as e } from "../../../node_modules/.pnpm/@trpc_client@11.0.0-rc.390_@trpc_server@11.0.0-rc.390/node_modules/@trpc/client/dist/TRPCClientError.mjs";
+import "../../../node_modules/.pnpm/@trpc_server@11.0.0-rc.390/node_modules/@trpc/server/dist/unstable-core-do-not-import/rootConfig.mjs";
+import { z as o } from "zod";
+import { trpcClientErrorMessageSchema as m } from "./trpcClientErrorMessageSchema.mjs";
+const p = o.custom(
+  (r) => r instanceof e
+  // check instance type
+).transform((r) => r.message).transform((r) => {
+  try {
+    return JSON.parse(r);
+  } catch {
+    return [
+      {
+        validation: "root",
+        code: "server",
+        message: r,
+        path: ["root"]
+      }
+    ];
+  }
+}).pipe(o.array(m)).transform(
+  (r) => r.map(
+    (t) => [
+      t.path.join("."),
+      // flatten path (e.g., "street.name")
+      {
+        type: t.code,
+        message: t.message
+      }
+    ]
+  )
+).transform((r) => Object.fromEntries(r));
+export {
+  p as trpcClientErrorToFormSubmitErrorsSchemaTransformer
+};

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

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

package/dist/esm/{form → src/form}/FormProviders.mjs

@@ -6,7 +6,7 @@ function v({
   formId: t,
   formRef: o,
   rhfForm: i,
-  options: e,
+  utils: e,
   children: m
 }) {
   return /* @__PURE__ */ r(d, { ...i, children: /* @__PURE__ */ r(n, { formRef: o, children: /* @__PURE__ */ r(

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

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

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

@@ -1,10 +1,15 @@
 import { UseFormProps } from 'react-hook-form';
 import { RhfUtilsErrorsOutputConfigContext, RhfUtilsErrorsOutputConsoleConfig } from '../../errors/output/types';
 import { FormChildrenSlots } from '../../form/Form';
+import { RhfUtilsFormOptions } from '../../form/RhfUtilsFormOptions';
 import { UseFormFieldsProps } from '../../form/useForm';
-import { UseFormOptions } from '../../form/useFormOptions';
 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.
@@ -13,7 +18,7 @@ export type RhfUtilsClientConfig = {
     /**
      * Default options for all forms. (Are overridden by form-specific options.)
      */
-    defaultOptions?: {
+    defaults?: {
         /**
          * Default RHF `useForm` settings.
          *
@@ -25,7 +30,7 @@ export type RhfUtilsClientConfig = {
          *
          * Extend this type to inject custom options/functionality via `Children` component.
          */
-        form?: UseFormOptions;
+        utils?: RhfUtilsFormOptions;
     };
     /**
      * Supply your own `<form>` component.
@@ -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/exports.d.ts

@@ -21,10 +21,10 @@ export { trpcClientErrorToFormSubmitErrorsSchemaTransformer } from './errors/trp
 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 type { UseFormFieldsProps } from './form/useForm';
 export { default as useForm } from './form/useForm';
-export type { UseFormOptions } from './form/useFormOptions';
 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';

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

@@ -6,6 +6,6 @@ export type FormChildrenSlots = 'top' | 'bottom';
 export type FormProps<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = React.PropsWithChildren<{
     formId: string;
     formRef: React.RefObject<HTMLFormElement>;
-} & Pick<UseFormProps<TFieldValues, TTransformedValues>, 'onSubmit' | 'onSubmitError' | 'onSubmitInvalid' | 'Fields' | 'form' | 'options'>>;
-declare function _Form<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ formId, formRef, onSubmit, onSubmitError, onSubmitInvalid, Fields, form, options, children, }: FormProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+} & Pick<UseFormProps<TFieldValues, TTransformedValues>, 'onSubmit' | 'onSubmitError' | 'onSubmitInvalid' | 'Fields' | 'form' | 'utils'>>;
+declare function _Form<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ formId, formRef, onSubmit, onSubmitError, onSubmitInvalid, Fields, form, utils, children, }: FormProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
 export default _Form;

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

@@ -1,12 +1,12 @@
 import { UseFormReturn } from 'react-hook-form';
+import { RhfUtilsFormOptions } from './RhfUtilsFormOptions';
 import { SafeFieldValues } from './SafeFieldValues';
-import { UseFormOptions } from './useFormOptions';
 
 export type FormProvidersProps<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = React.PropsWithChildren<{
     formId: string;
     formRef: React.RefObject<HTMLFormElement>;
     rhfForm: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
-    options?: UseFormOptions;
+    utils?: RhfUtilsFormOptions;
 }>;
-declare function FormProviders<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ formId, formRef, rhfForm, options, children, }: FormProvidersProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+declare function FormProviders<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ formId, formRef, rhfForm, utils, children, }: FormProvidersProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
 export default FormProviders;

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

@@ -0,0 +1,28 @@
+import { DevtoolUIProps } from '@hookform/devtools/dist/devToolUI';
+import { default as useResetFormAfterSubmitSuccessful } from '../submit/useResetFormOnSubmitSuccessful';
+import { Register } from '../register';
+
+/**
+ * Options for enabling utils functionality provided by this library.
+ *
+ * Can be extended using {@link Register.RhfUtilsFormOptions}.
+ */
+export type RhfUtilsFormOptions = {
+    /**
+     * Control visibility of certain items via your own classes and styles.
+     * (Defaults merged with individual class names.)
+     */
+    classNames?: string[];
+    /** 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;
+    /** Stop propagation of submit event. Useful for portals. */
+    stopSubmitPropagation?: boolean;
+    /** Reset form after successful submit. */
+    resetFormAfterSubmitSuccessful?: Parameters<typeof useResetFormAfterSubmitSuccessful>[0];
+    /** Control dev tool options. */
+    devTool?: Pick<DevtoolUIProps, 'placement' | 'styles'> | 'disabled';
+} & (Register extends {
+    RhfUtilsFormOptions: infer _RhfUtilsFormOptions;
+} ? _RhfUtilsFormOptions : {});

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

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

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

@@ -1,9 +1,9 @@
-import { UseFormOptions } from '../../useFormOptions';
+import { RhfUtilsFormOptions } from '../../RhfUtilsFormOptions';
 
 export type FormUtilsContext = {
     formId: string;
     formRef: React.RefObject<HTMLFormElement>;
-    options: UseFormOptions | undefined;
+    options: RhfUtilsFormOptions | undefined;
     /** Callback to trigger submit manually -- e.g., on change. */
     requestSubmit: HTMLFormElement['requestSubmit'];
 };

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

@@ -4,14 +4,14 @@ import { FormSubmitError } from '../submit/error/FormSubmitError';
 import { default as _Controller } from './_Controller';
 import { FormProps } from './Form';
 import { FormProvidersProps } from './FormProviders';
+import { RhfUtilsFormOptions } from './RhfUtilsFormOptions';
 import { SafeFieldValues } from './SafeFieldValues';
-import { UseFormOptions } from './useFormOptions';
 
 export type UseFormFieldsProps<TFieldValues extends SafeFieldValues = SafeFieldValues, TTransformedValues extends SafeFieldValues = SafeFieldValues> = {
     formId: string;
     formRef: React.RefObject<HTMLFormElement>;
     context: RhfUseFormReturn<TFieldValues, unknown, TTransformedValues>;
-    options?: UseFormOptions;
+    utils?: RhfUtilsFormOptions;
     Controller: typeof _Controller<TFieldValues>;
 };
 export type UseFormProps<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = {
@@ -26,7 +26,8 @@ export type UseFormProps<TFieldValues extends SafeFieldValues, TTransformedValue
     rhf?: Omit<RhfUseFormProps<TFieldValues>, 'defaultValues'>;
     /** {@link FormProps} props for Form. */
     form?: React.PropsWithoutRef<JSX.IntrinsicElements['form']>;
-    options?: UseFormOptions;
+    /** {@link RhfUtilsFormOptions} to enabled utils functionality. */
+    utils?: RhfUtilsFormOptions;
 };
 export type UseFormReturn<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = {
     id: string;
@@ -45,6 +46,6 @@ export type UseFormReturn<TFieldValues extends SafeFieldValues, TTransformedValu
  * see https://caniuse.com/?search=form%20attribute
  * @returns Form provider and form.
  */
-declare const useForm: <TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ onSubmit, onSubmitError, onSubmitInvalid, defaultValues, Fields, rhf, form, options, }: UseFormProps<TFieldValues, TTransformedValues>) => UseFormReturn<TFieldValues, TTransformedValues>;
+declare const useForm: <TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ onSubmit, onSubmitError, onSubmitInvalid, defaultValues, Fields, rhf, form, utils, }: UseFormProps<TFieldValues, TTransformedValues>) => UseFormReturn<TFieldValues, TTransformedValues>;
 export default useForm;
 export type UseForm<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = typeof useForm<TFieldValues, TTransformedValues>;

package/dist/types/register.d.ts

@@ -1,7 +1,8 @@
 /**
  * Use this to extend internal types.
  *
- * For example, `UseFormOptions`.
+ * 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.106",
+  "version": "0.0.108",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -22,14 +22,16 @@
   "peerDependencies": {
     "@hookform/devtools": "4",
     "@hookform/resolvers": "3",
-    "@trpc/client": "next",
-    "@trpc/server": "next",
     "flat": "6",
     "react": "18",
     "react-dom": "18",
     "react-hook-form": "7",
     "zod": "3"
   },
+  "optionalDependencies": {
+    "@trpc/client": "next",
+    "@trpc/server": "next"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/paragrav/rhf-utils.git"

package/dist/esm/client/index.mjs

@@ -1,55 +0,0 @@
-import { jsx as h } from "react/jsx-runtime";
-import F from "../form/FormWithProviders.mjs";
-import a from "../form/useForm.mjs";
-const v = (s) => (r) => {
-  const i = d(
-    s,
-    r
-  );
-  return {
-    useForm: (n, o) => {
-      const t = i(n, o);
-      return {
-        ...a(t),
-        FormWithProviders: ({
-          children: e
-        }) => /* @__PURE__ */ h(F, { ...t, children: e })
-      };
-    },
-    FormWithProviders: l(s, r)
-  };
-}, d = (s, r) => function(n, o) {
-  var t, e, m, f, u;
-  return {
-    ...o,
-    rhf: {
-      ...(t = r.defaultOptions) == null ? void 0 : t.rhf,
-      ...o.rhf,
-      resolver: s(n)
-    },
-    options: {
-      ...(e = r.defaultOptions) == null ? void 0 : e.form,
-      ...o.options,
-      classNames: [
-        ...((f = (m = r.defaultOptions) == null ? void 0 : m.form) == null ? void 0 : f.classNames) ?? [],
-        ...((u = o.options) == null ? void 0 : u.classNames) ?? []
-      ]
-    }
-  };
-}, l = (s, r) => function({
-  schema: n,
-  children: o,
-  ...t
-}) {
-  const e = d(s, r);
-  return /* @__PURE__ */ h(
-    F,
-    {
-      ...e(n, t),
-      children: o
-    }
-  );
-};
-export {
-  v as createRhfUtilsClient
-};

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

@@ -1,24 +0,0 @@
-import { useFormContext as C } 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";
-export {
-  v as default
-};

package/dist/esm/errors/trpc/getOnSubmitTrpcClientErrorHandler.mjs

@@ -1,6 +0,0 @@
-import { TRPCClientError as o } from "@trpc/client";
-import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as n } from "./trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
-const m = (t) => (r) => r instanceof o ? n.parse(r) : t(r);
-export {
-  m as getOnSubmitTrpcClientErrorHandler
-};

package/dist/esm/errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs

@@ -1,34 +0,0 @@
-import { TRPCClientError as o } from "@trpc/client";
-import { z as e } from "zod";
-import { trpcClientErrorMessageSchema as a } from "./trpcClientErrorMessageSchema.mjs";
-const i = e.custom(
-  (r) => r instanceof o
-  // check instance type
-).transform((r) => r.message).transform((r) => {
-  try {
-    return JSON.parse(r);
-  } catch {
-    return [
-      {
-        validation: "root",
-        code: "server",
-        message: r,
-        path: ["root"]
-      }
-    ];
-  }
-}).pipe(e.array(a)).transform(
-  (r) => r.map(
-    (t) => [
-      t.path.join("."),
-      // flatten path (e.g., "street.name")
-      {
-        type: t.code,
-        message: t.message
-      }
-    ]
-  )
-).transform((r) => Object.fromEntries(r));
-export {
-  i as trpcClientErrorToFormSubmitErrorsSchemaTransformer
-};

package/dist/esm/form/Form.mjs

@@ -1,91 +0,0 @@
-import { jsxs as F, jsx as c } from "react/jsx-runtime";
-import "react";
-import { useFormContext as _ } from "react-hook-form";
-import j from "../client/config/useRhfUtilsClientConfigContext.mjs";
-import D from "../devtool/LazyDevTool.mjs";
-import { FormSubmitError as N } from "../submit/error/FormSubmitError.mjs";
-import P from "../submit/error/setCtxErrorsByFormSubmitErrors.mjs";
-import S from "./_Controller.mjs";
-import T from "./_FormBase.mjs";
-function q({
-  formId: x,
-  formRef: C,
-  //
-  onSubmit: o,
-  onSubmitError: d,
-  onSubmitInvalid: y,
-  Fields: h,
-  //
-  form: s,
-  options: e,
-  //
-  children: f
-}) {
-  const l = _(), r = j(), b = async (t) => {
-    e != null && e.stopSubmitPropagation && t.stopPropagation();
-    try {
-      await l.handleSubmit(v, y)(t);
-    } catch (a) {
-      B(a, t);
-    }
-  }, v = (t, a) => o == null ? void 0 : o(
-    t,
-    l,
-    a
-  ), B = (t, a) => {
-    var n;
-    const m = t instanceof N ? (
-      // consumer can manually throw FormSubmitError (e.g., manual validation)
-      t.errors
-    ) : (
-      // if error is not FormSubmitError, consumer can provide global handler
-      (n = r == null ? void 0 : r.onSubmitError) == null ? void 0 : n.call(r, t)
-    );
-    m && P(l, m), d == null || d(
-      t,
-      l,
-      a
-    );
-  }, u = {
-    formId: x,
-    formRef: C,
-    context: l,
-    options: e,
-    Controller: S
-  }, i = (t) => {
-    var m;
-    const a = (m = r == null ? void 0 : r.Children) == null ? void 0 : m[t];
-    return a && /* @__PURE__ */ c(a, { ...u });
-  };
-  return /* @__PURE__ */ F(
-    T,
-    {
-      noValidate: !0,
-      style: {
-        position: "relative"
-      },
-      config: r,
-      formRef: C,
-      ...s,
-      className: [e == null ? void 0 : e.classNames, s == null ? void 0 : s.className].filter(Boolean).join(" "),
-      onSubmit: b,
-      children: [
-        i("top"),
-        (e == null ? void 0 : e.devTool) !== "disabled" && /* @__PURE__ */ c(
-          D,
-          {
-            placement: "top-right",
-            isDevelopment: r == null ? void 0 : r.isDevelopment,
-            ...e == null ? void 0 : e.devTool
-          }
-        ),
-        h && /* @__PURE__ */ c(h, { ...u }),
-        f,
-        i("bottom")
-      ]
-    }
-  );
-}
-export {
-  q as default
-};

package/dist/esm/form/useForm.mjs

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