@paragrav/rhf-utils 0.0.83 → 0.0.85

package/dist/esm/client/index.mjs

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

package/dist/esm/exports.mjs

@@ -8,77 +8,81 @@ import { default as i } from "./errors/flat/FlatFieldErrorsList.mjs";
 import { default as E } from "./errors/message/FormErrorMessage.mjs";
 import { default as h } from "./errors/message/FormErrorMessageByPath.mjs";
 import { default as S } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
-import { default as y } from "./errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs";
-import { default as O } from "./errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo.mjs";
+import { default as P } from "./errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs";
+import { default as M } from "./errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo.mjs";
 import { default as R } from "./errors/orphan/useOrphanFormErrorsMemo.mjs";
-import { default as I } from "./errors/orphan/useOrphanFormErrorsToConsole.mjs";
-import { default as g } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
-import { default as v } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
+import { default as v } from "./errors/orphan/useOrphanFormErrorsToConsole.mjs";
+import { default as T } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
+import { default as k } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
 import { default as A } from "./errors/useFormErrorConsoleDebug.mjs";
 import { default as D } from "./errors/useFormErrorsEffect.mjs";
 import { default as Z } from "./errors/useFormErrorsIfAny.mjs";
 import { default as N } from "./errors/useFormErrorsTransformMemo.mjs";
 import { default as z } from "./errors/useFormRequestSubmit.mjs";
-import { default as j } from "./form/FormWithProviders.mjs";
-import { default as J } from "./form/useForm.mjs";
-import { default as Q } from "./form/context/utils/FormUtilsContextProvider.mjs";
-import { default as X } from "./form/context/utils/useFormUtilsContext.mjs";
-import { default as _ } from "./form/context/group/FormGroupContextProvider.mjs";
-import { default as rr } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
-import { default as er } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
-import { default as sr } from "./form/context/group/useFormGroupChildTracker.mjs";
-import { default as ur } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
-import { default as mr } from "./form/context/group/useFormGroupIsChildBusy.mjs";
-import { default as dr } from "./form/context/group/useFormGroupIsParentBusy.mjs";
-import { default as xr } from "./form/context/group/useFormGroupParentTracker.mjs";
-import { default as ir } from "./form/context/group/useFormOrParentIsBusy.mjs";
-import { default as Er } from "./form/utils/getSubmitterButtonData.mjs";
-import { FormSubmitError as hr } from "./submit/error/FormSubmitError.mjs";
-import { default as Sr } from "./submit/useFormOnSubmitSuccessful.mjs";
-import { default as yr } from "./submit/useFormOnSubmitSuccessfulAndReset.mjs";
-import { default as Or } from "./submit/useResetFormOnSubmitError.mjs";
-import { default as Rr } from "./submit/useResetFormOnSubmitSuccessful.mjs";
-import { default as Ir } from "./submit/useSubmitFormOnChange.mjs";
+import { default as j } from "./form/Form.mjs";
+import { default as J } from "./form/FormProviders.mjs";
+import { default as Q } from "./form/FormWithProviders.mjs";
+import { default as X } from "./form/useForm.mjs";
+import { default as _ } from "./form/context/utils/FormUtilsContextProvider.mjs";
+import { default as rr } from "./form/context/utils/useFormUtilsContext.mjs";
+import { default as er } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as sr } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as ur } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as mr } from "./form/context/group/useFormGroupChildTracker.mjs";
+import { default as dr } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as xr } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as ir } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as Er } from "./form/context/group/useFormGroupParentTracker.mjs";
+import { default as hr } from "./form/context/group/useFormOrParentIsBusy.mjs";
+import { default as Sr } from "./form/utils/getSubmitterButtonData.mjs";
+import { FormSubmitError as Pr } from "./submit/error/FormSubmitError.mjs";
+import { default as Mr } from "./submit/useFormOnSubmitSuccessful.mjs";
+import { default as Rr } from "./submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import { default as vr } from "./submit/useResetFormOnSubmitError.mjs";
+import { default as Tr } from "./submit/useResetFormOnSubmitSuccessful.mjs";
+import { default as kr } from "./submit/useSubmitFormOnChange.mjs";
 export {
   d as FlatFieldErrorsContextProvider,
   i as FlatFieldErrorsList,
+  j as Form,
   E as FormErrorMessage,
   h as FormErrorMessageByPath,
-  _ as FormGroupContextProvider,
+  er as FormGroupContextProvider,
   S as FormNonFieldErrorMarker,
-  y as FormNonFieldErrorMarkerHtmlAttribute,
-  hr as FormSubmitError,
-  Q as FormUtilsContextProvider,
-  j as FormWithProviders,
+  P as FormNonFieldErrorMarkerHtmlAttribute,
+  J as FormProviders,
+  Pr as FormSubmitError,
+  _ as FormUtilsContextProvider,
+  Q as FormWithProviders,
   m as LazyDevTool,
   e as RhfUtilsClientForZodContextProvider,
-  g as RootErrorsListFromFlatFieldErrorsContext,
+  T as RootErrorsListFromFlatFieldErrorsContext,
   u as createRhfUtilsClientForZod,
-  Er as getSubmitterButtonData,
+  Sr as getSubmitterButtonData,
   x as useFlatFieldErrorsContext,
-  J as useForm,
+  X as useForm,
   A as useFormErrorConsoleDebug,
   D as useFormErrorsEffect,
   Z as useFormErrorsIfAny,
   N as useFormErrorsTransformMemo,
-  rr as useFormGroupChildIsMountedTracker,
-  er as useFormGroupChildIsSubmittingTracker,
-  sr as useFormGroupChildTracker,
-  ur as useFormGroupIsAnyBusy,
-  mr as useFormGroupIsChildBusy,
-  dr as useFormGroupIsParentBusy,
-  xr as useFormGroupParentTracker,
-  O as useFormHasOnlyOrphanFieldErrorsMemo,
-  Sr as useFormOnSubmitSuccessful,
-  yr as useFormOnSubmitSuccessfulAndReset,
-  ir as useFormOrParentIsBusy,
+  sr as useFormGroupChildIsMountedTracker,
+  ur as useFormGroupChildIsSubmittingTracker,
+  mr as useFormGroupChildTracker,
+  dr as useFormGroupIsAnyBusy,
+  xr as useFormGroupIsChildBusy,
+  ir as useFormGroupIsParentBusy,
+  Er as useFormGroupParentTracker,
+  M as useFormHasOnlyOrphanFieldErrorsMemo,
+  Mr as useFormOnSubmitSuccessful,
+  Rr as useFormOnSubmitSuccessfulAndReset,
+  hr as useFormOrParentIsBusy,
   z as useFormRequestSubmit,
-  X as useFormUtilsContext,
+  rr as useFormUtilsContext,
   R as useOrphanFormErrorsMemo,
-  I as useOrphanFormErrorsToConsole,
-  Rr as useResetFormAfterSubmitSuccessful,
-  Or as useResetFormOnSubmitError,
+  v as useOrphanFormErrorsToConsole,
+  Tr as useResetFormAfterSubmitSuccessful,
+  vr as useResetFormOnSubmitError,
   s as useRhfUtilsClientForZodContext,
-  v as useRootFormFieldErrorsMemo,
-  Ir as useSubmitFormOnChange
+  k as useRootFormFieldErrorsMemo,
+  kr as useSubmitFormOnChange
 };

package/dist/esm/form/Form.mjs

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

package/dist/esm/form/FormWithProviders.mjs

@@ -1,6 +1,6 @@
 import { jsx as o } from "react/jsx-runtime";
-import t from "./_Form.mjs";
-import e from "./_FormProviders.mjs";
+import t from "./Form.mjs";
+import e from "./FormProviders.mjs";
 import f from "./useForm.mjs";
 function u({
   children: m,

package/dist/esm/form/useForm.mjs

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

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

@@ -1,7 +1,7 @@
 import { FormSubmitError } from '../submit/error/FormSubmitError';
 import { UseFormOptions } from '../form/useFormOptions';
 import { UseFormFieldsProps } from '../form/useForm';
-import { _FormSlots } from '../form/_Form';
+import { FormChildrenSlots } from '../form/Form';
 import { UseFormProps } from 'react-hook-form';
 
 export type ClientConfig = {
@@ -29,7 +29,7 @@ export type ClientConfig = {
      * top: e.g., block navigation on dirty form.
      * bottom: e.g., root errors list.
      */
-    Children?: Partial<Record<_FormSlots, React.FC<UseFormFieldsProps>>>;
+    Children?: Partial<Record<FormChildrenSlots, React.FC<UseFormFieldsProps>>>;
     /**
      * Handle non-{@link FormSubmitError} errors. Optionally, return {@link FormSubmitError} to merge into context errors.
      */

package/dist/types/client/index.d.ts

@@ -13,7 +13,11 @@ export type ObjectSchema<TInputKey extends string, TOutputKey extends string> =
     [key in TOutputKey]: SafeFieldValues;
 };
 export type CreateRhfUtilsClient<TObjectSchema extends ObjectSchema<TObjectSchemaInputKey, TObjectSchemaOutputKey>, TObjectSchemaInputKey extends string, TObjectSchemaOutputKey extends string> = {
-    useForm: <TSchema extends TObjectSchema, TSchemaInput extends SafeFieldValues = TSchema[TObjectSchemaInputKey], TSchemaOutput extends SafeFieldValues = TSchema[TObjectSchemaOutputKey]>(schema: TSchema, props: UseFormProps<TSchemaInput, TSchemaOutput>) => UseFormReturn<TSchemaInput, TSchemaOutput>;
+    useForm: <TSchema extends TObjectSchema, TSchemaInput extends SafeFieldValues = TSchema[TObjectSchemaInputKey], TSchemaOutput extends SafeFieldValues = TSchema[TObjectSchemaOutputKey], UseFormPropsForm extends UseFormProps<TSchemaInput, TSchemaOutput> = UseFormProps<TSchemaInput, TSchemaOutput>>(schema: TSchema, handlers: NonNullable<UseFormPropsForm['onSubmit']> | [
+        NonNullable<UseFormPropsForm['onSubmit']>,
+        UseFormPropsForm['onSubmitError'],
+        UseFormPropsForm['onSubmitInvalid']
+    ], defaultValues: UseFormPropsForm['defaultValues'], Fields: UseFormPropsForm['Fields'], props: UseFormProps<TSchemaInput, TSchemaOutput>) => UseFormReturn<TSchemaInput, TSchemaOutput>;
     FormWithProviders: <TSchema extends TObjectSchema, TSchemaInput extends SafeFieldValues = TSchema[TObjectSchemaInputKey], TSchemaOutput extends SafeFieldValues = TSchema[TObjectSchemaOutputKey]>(props: {
         schema: TSchema;
     } & FormWithProvidersProps<TSchemaInput, TSchemaOutput>) => JSX.Element;

package/dist/types/exports.d.ts

@@ -21,6 +21,8 @@ export { default as useFormErrorsEffect } from './errors/useFormErrorsEffect';
 export { default as useFormErrorsIfAny } from './errors/useFormErrorsIfAny';
 export { default as useFormErrorsTransformMemo } from './errors/useFormErrorsTransformMemo';
 export { default as useFormRequestSubmit } from './errors/useFormRequestSubmit';
+export { default as Form } from './form/Form';
+export { default as FormProviders } from './form/FormProviders';
 export { default as FormWithProviders } from './form/FormWithProviders';
 export type { SafeFieldValues } from './form/SafeFieldValues';
 export type { UseFormFieldsProps } from './form/useForm';

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

@@ -0,0 +1,11 @@
+import { UseFormProps } from './useForm';
+import { SafeFieldValues } from './SafeFieldValues';
+import { default as React } from 'react';
+
+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' | 'config'>>;
+declare function _Form<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ formId, formRef, onSubmit, onSubmitError, onSubmitInvalid, Fields, form, options, config, children, }: FormProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+export default _Form;

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

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

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

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

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

@@ -1,7 +1,7 @@
 import { UseFormOptions } from './useFormOptions';
 import { SafeFieldValues } from './SafeFieldValues';
-import { _FormProvidersProps } from './_FormProviders';
-import { _FormProps } from './_Form';
+import { FormProvidersProps } from './FormProviders';
+import { FormProps } from './Form';
 import { ClientConfig } from '../client/config';
 import { SubmitErrorHandler, UseFormProps as RhfUseFormProps, UseFormReturn as RhfUseFormReturn } from 'react-hook-form';
 import { default as React } from 'react';
@@ -13,19 +13,18 @@ export type UseFormFieldsProps<TFieldValues extends SafeFieldValues = SafeFieldV
     options?: UseFormOptions;
 };
 export type UseFormProps<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = {
+    onSubmit?: (values: TTransformedValues, context: RhfUseFormReturn<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: RhfUseFormReturn<TFieldValues, unknown, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => void;
+    /** Submit handler when form is invalid. */
+    onSubmitInvalid?: SubmitErrorHandler<TFieldValues>;
+    defaultValues?: RhfUseFormProps<TFieldValues>['defaultValues'];
+    Fields?: React.FC<UseFormFieldsProps<TFieldValues, TTransformedValues>>;
     config?: ClientConfig;
     /** {@link RhfUseFormProps} props for RHF's {@link useRhfForm}. */
-    rhf?: RhfUseFormProps<TFieldValues>;
+    rhf?: Omit<RhfUseFormProps<TFieldValues>, 'defaultValues'>;
     /** {@link FormProps} props for Form. */
-    form?: {
-        Fields?: React.FC<UseFormFieldsProps<TFieldValues, TTransformedValues>>;
-        onSubmit?: (values: TTransformedValues, context: RhfUseFormReturn<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: RhfUseFormReturn<TFieldValues, unknown, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => void;
-        /** Submit handler when form is invalid. */
-        onSubmitInvalid?: SubmitErrorHandler<TFieldValues>;
-        props?: React.PropsWithoutRef<JSX.IntrinsicElements['form']>;
-    };
+    form?: React.PropsWithoutRef<JSX.IntrinsicElements['form']>;
     options?: UseFormOptions;
 };
 /**
@@ -37,12 +36,29 @@ export type UseFormProps<TFieldValues extends SafeFieldValues, TTransformedValue
  * see https://caniuse.com/?search=form%20attribute
  * @returns Form provider and form.
  */
-declare const useForm: <TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ config, rhf, form, options, }: UseFormProps<TFieldValues, TTransformedValues>) => {
+declare const useForm: <TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>({ onSubmit, onSubmitError, onSubmitInvalid, defaultValues, Fields, config, rhf, form, options, }: UseFormProps<TFieldValues, TTransformedValues>) => {
     readonly id: string;
     readonly ref: React.RefObject<HTMLFormElement>;
     readonly context: RhfUseFormReturn<TFieldValues, unknown, TTransformedValues>;
-    readonly providerProps: _FormProvidersProps<TFieldValues, TTransformedValues>;
-    readonly formProps: _FormProps<TFieldValues, TTransformedValues>;
+    readonly providerProps: FormProvidersProps<TFieldValues, TTransformedValues>;
+    readonly formProps: FormProps<TFieldValues, TTransformedValues>;
+    readonly SubmitError: {
+        new (errors: Record<`root.${string}` | import('react-hook-form').Path<TFieldValues>, {
+            type?: string | undefined;
+            message: string;
+        }>, message?: string | undefined): {
+            errors: Record<`root.${string}` | import('react-hook-form').Path<TFieldValues>, {
+                type?: string | undefined;
+                message: string;
+            }>;
+            name: string;
+            message: string;
+            stack?: string | undefined;
+        };
+        captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+        prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+        stackTraceLimit: number;
+    };
 };
 export default useForm;
 export type UseForm<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = typeof useForm<TFieldValues, TTransformedValues>;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
   "license": "MIT",
-  "version": "0.0.83",
+  "version": "0.0.85",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -11,270 +11,18 @@
     "dist/types/*"
   ],
   "module": "./dist/esm/exports.mjs",
-  "imports": {
-    "#is-development": {
-      "development": "./src/env-conditions/development.ts",
-      "default": "./src/env-conditions/production.ts"
-    }
-  },
   "exports": {
     ".": {
       "import": {
         "default": "./dist/esm/exports.mjs",
         "types": "./dist/types/exports.d.ts"
       }
-    },
-    "./client/*": {
-      "import": {
-        "default": "./dist/esm/client/*",
-        "types": "./dist/types/client/*"
-      }
-    },
-    "./client/zod/*": {
-      "import": {
-        "default": "./dist/esm/client/zod/*",
-        "types": "./dist/types/client/zod/*"
-      }
-    },
-    "./client/zod/createRhfUtilsClientForZod": {
-      "import": {
-        "default": "./dist/esm/client/zod/createRhfUtilsClientForZod.mjs",
-        "types": "./dist/types/client/zod/createRhfUtilsClientForZod.d.ts"
-      }
-    },
-    "./client/zod/useRhfUtilsClientForZodContext": {
-      "import": {
-        "default": "./dist/esm/client/zod/useRhfUtilsClientForZodContext.mjs",
-        "types": "./dist/types/client/zod/useRhfUtilsClientForZodContext.d.ts"
-      }
-    },
-    "./client/zod/RhfUtilsClientForZodContextProvider": {
-      "import": {
-        "default": "./dist/esm/client/zod/RhfUtilsClientForZodContextProvider.mjs",
-        "types": "./dist/types/client/zod/RhfUtilsClientForZodContextProvider.d.ts"
-      }
-    },
-    "./devtool/LazyDevTool": {
-      "import": {
-        "default": "./dist/esm/devtool/LazyDevTool.mjs",
-        "types": "./dist/types/devtool/LazyDevTool.d.ts"
-      }
-    },
-    "./errors/flat/context/FlatFieldErrorsContextProvider": {
-      "import": {
-        "default": "./dist/esm/errors/flat/context/FlatFieldErrorsContextProvider.mjs",
-        "types": "./dist/types/errors/flat/context/FlatFieldErrorsContextProvider.d.ts"
-      }
-    },
-    "./errors/flat/context/useFlatFieldErrorsContext": {
-      "import": {
-        "default": "./dist/esm/errors/flat/context/useFlatFieldErrorsContext.mjs",
-        "types": "./dist/types/errors/flat/context/useFlatFieldErrorsContext.d.ts"
-      }
-    },
-    "./errors/flat/FlatFieldErrorsList": {
-      "import": {
-        "default": "./dist/esm/errors/flat/FlatFieldErrorsList.mjs",
-        "types": "./dist/types/errors/flat/FlatFieldErrorsList.d.ts"
-      }
-    },
-    "./errors/FormErrorMessage": {
-      "import": {
-        "default": "./dist/esm/errors/message/FormErrorMessage.mjs",
-        "types": "./dist/types/errors/message/FormErrorMessage.d.ts"
-      }
-    },
-    "./errors/FormErrorMessageByPath": {
-      "import": {
-        "default": "./dist/esm/errors/message/FormErrorMessageByPath.mjs",
-        "types": "./dist/types/errors/message/FormErrorMessageByPath.d.ts"
-      }
-    },
-    "./errors/useFormErrorConsoleDebug": {
-      "import": {
-        "default": "./dist/esm/errors/useFormErrorConsoleDebug.mjs",
-        "types": "./dist/types/errors/useFormErrorConsoleDebug.d.ts"
-      }
-    },
-    "./errors/useFormErrorsEffect": {
-      "import": {
-        "default": "./dist/esm/errors/useFormErrorsEffect.mjs",
-        "types": "./dist/types/errors/useFormErrorsEffect.d.ts"
-      }
-    },
-    "./errors/useFormErrorsIfAny": {
-      "import": {
-        "default": "./dist/esm/errors/useFormErrorsIfAny.mjs",
-        "types": "./dist/types/errors/useFormErrorsIfAny.d.ts"
-      }
-    },
-    "./errors/useFormErrorsTransformMemo": {
-      "import": {
-        "default": "./dist/esm/errors/useFormErrorsTransformMemo.mjs",
-        "types": "./dist/types/errors/useFormErrorsTransformMemo.d.ts"
-      }
-    },
-    "./errors/useFormRequestSubmit": {
-      "import": {
-        "default": "./dist/esm/errors/useFormRequestSubmit.mjs",
-        "types": "./dist/types/errors/useFormRequestSubmit.d.ts"
-      }
-    },
-    "./errors/FormNonFieldErrorMarker": {
-      "import": {
-        "default": "./dist/esm/errors/nonfield/FormNonFieldErrorMarker.mjs",
-        "types": "./dist/types/errors/nonfield/FormNonFieldErrorMarker.d.ts"
-      }
-    },
-    "./errors/FormNonFieldErrorMarkerHtmlAttribute": {
-      "import": {
-        "default": "./dist/esm/errors/nonfield/FormNonFieldErrorMarker.utils.mjs",
-        "types": "./dist/types/errors/nonfield/FormNonFieldErrorMarker.utils.d.ts"
-      }
-    },
-    "./errors/useFormHasOnlyOrphanFieldErrorsMemo": {
-      "import": {
-        "default": "./dist/esm/errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo.mjs",
-        "types": "./dist/types/errors/orphan/useFormHasOnlyOrphanFieldErrorsMemo.d.ts"
-      }
-    },
-    "./errors/useOrphanFormErrorsToConsoleError": {
-      "import": {
-        "default": "./dist/esm/errors/orphan/useOrphanFormErrorsToConsoleError.mjs",
-        "types": "./dist/types/errors/orphan/useOrphanFormErrorsToConsoleError.d.ts"
-      }
-    },
-    "./errors/useOrphanFormErrors": {
-      "import": {
-        "default": "./dist/esm/errors/orphan/useOrphanFormErrors.mjs",
-        "types": "./dist/types/errors/orphan/useOrphanFormErrors.d.ts"
-      }
-    },
-    "./errors/useRootFormFieldErrors": {
-      "import": {
-        "default": "./dist/esm/errors/root/useRootFormFieldErrors.mjs",
-        "types": "./dist/types/errors/root/useRootFormFieldErrors.d.ts"
-      }
-    },
-    "./errors/RootErrorsListFromFlatFieldErrorsContext": {
-      "import": {
-        "default": "./dist/esm/errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs",
-        "types": "./dist/types/errors/root/RootErrorsListFromFlatFieldErrorsContext.d.ts"
-      }
-    },
-    "./form/useForm": {
-      "import": {
-        "default": "./dist/esm/form/useForm.mjs",
-        "types": "./dist/types/form/useForm.d.ts"
-      }
-    },
-    "./form/context/group/FormGroupContextProvider": {
-      "import": {
-        "default": "./dist/esm/form/context/group/FormGroupContextProvider.mjs",
-        "types": "./dist/types/form/context/group/FormGroupContextProvider.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupParentTracker": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupParentTracker.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupParentTracker.d.ts"
-      }
-    },
-    "./form/context/group/useFormOrParentIsBusy": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormOrParentIsBusy.mjs",
-        "types": "./dist/types/form/context/group/useFormOrParentIsBusy.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupChildIsSubmittingTracker": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupChildIsSubmittingTracker.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupChildIsSubmittingTracker.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupChildTracker": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupChildTracker.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupChildTracker.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupChildIsMountedTracker": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupChildIsMountedTracker.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupChildIsMountedTracker.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupIsAnyBusy": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupIsAnyBusy.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupIsAnyBusy.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupIsChildBusy": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupIsChildBusy.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupIsChildBusy.d.ts"
-      }
-    },
-    "./form/context/group/useFormGroupIsParentBusy": {
-      "import": {
-        "default": "./dist/esm/form/context/group/useFormGroupIsParentBusy.mjs",
-        "types": "./dist/types/form/context/group/useFormGroupIsParentBusy.d.ts"
-      }
-    },
-    "./form/context/utils/FormUtilsContextProvider": {
-      "import": {
-        "default": "./dist/esm/form/context/utils/FormUtilsContextProvider.mjs",
-        "types": "./dist/types/form/context/utils/FormUtilsContextProvider.d.ts"
-      }
-    },
-    "./form/context/utils/useFormUtilsContext": {
-      "import": {
-        "default": "./dist/esm/form/context/utils/useFormUtilsContext.mjs",
-        "types": "./dist/types/form/context/utils/useFormUtilsContext.d.ts"
-      }
-    },
-    "./form/utils/getSubmitterButtonData": {
-      "import": {
-        "default": "./dist/esm/form/utils/getSubmitterButtonData.mjs",
-        "types": "./dist/types/form/utils/getSubmitterButtonData.d.ts"
-      }
-    },
-    "./submit/useFormOnSubmitSuccessful": {
-      "import": {
-        "default": "./dist/esm/submit/useFormOnSubmitSuccessful.mjs",
-        "types": "./dist/types/submit/useFormOnSubmitSuccessful.d.ts"
-      }
-    },
-    "./submit/error/FormSubmitError": {
-      "import": {
-        "default": "./dist/esm/submit/error/FormSubmitError.mjs",
-        "types": "./dist/types/submit/error/FormSubmitError.d.ts"
-      }
-    },
-    "./submit/useFormOnSubmitSuccessfulAndReset": {
-      "import": {
-        "default": "./dist/esm/submit/useFormOnSubmitSuccessfulAndReset.mjs",
-        "types": "./dist/types/submit/useFormOnSubmitSuccessfulAndReset.d.ts"
-      }
-    },
-    "./submit/useResetFormOnSubmitError": {
-      "import": {
-        "default": "./dist/esm/submit/useResetFormOnSubmitError.mjs",
-        "types": "./dist/types/submit/useResetFormOnSubmitError.d.ts"
-      }
-    },
-    "./submit/useResetFormAfterSubmitSuccessful": {
-      "import": {
-        "default": "./dist/esm/submit/useResetFormAfterSubmitSuccessful.mjs",
-        "types": "./dist/types/submit/useResetFormAfterSubmitSuccessful.d.ts"
-      }
-    },
-    "./submit/useSubmitFormOnChange": {
-      "import": {
-        "default": "./dist/esm/submit/useSubmitFormOnChange.mjs",
-        "types": "./dist/types/submit/useSubmitFormOnChange.d.ts"
-      }
+    }
+  },
+  "imports": {
+    "#is-development": {
+      "development": "./src/env-conditions/development.ts",
+      "default": "./src/env-conditions/production.ts"
     }
   },
   "peerDependencies": {

package/dist/esm/form/_Form.mjs

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