@paragrav/rhf-utils 0.0.131 → 0.0.133

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

@@ -0,0 +1 @@
+{"version":3,"file":"Form.mjs","sources":["../../../src/form/Form.tsx"],"sourcesContent":["import React from 'react';\nimport type { UseFormHandleSubmit } from 'react-hook-form';\nimport { useFormContext } from 'react-hook-form';\n\nimport useRhfUtilsClientConfigMaybeContext from '@/client/config/useRhfUtilsClientConfigContext';\n\nimport LazyDevTool from '@/devtool/LazyDevTool';\n\nimport { FormSubmitError } from '@/submit/error/FormSubmitError';\nimport setCtxErrorsByFormSubmitErrors from '@/submit/error/setCtxErrorsByFormSubmitErrors';\n\nimport PassthroughChildren from '@/utils/PassthroughChildren';\n\nimport _Controller from './_Controller';\nimport type { SafeFieldValues } from './SafeFieldValues';\nimport type { UseRhfUtilsFormChildrenProps } from './UseRhfUtilsFormChildrenProps';\nimport type {\n  UseRhfUtilsFormOnSubmitContext,\n  UseRhfUtilsFormOnSubmitErrorContext,\n} from './UseRhfUtilsFormOnSubmitContext';\nimport type { UseRhfUtilsFormProps } from './UseRhfUtilsFormProps';\n\nexport type FormChildrenSlots = 'top' | 'bottom';\n\nexport type FormProps<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n> = {\n  formId: string;\n  formRef: React.RefObject<HTMLFormElement>;\n} & Pick<\n  UseRhfUtilsFormProps<TFieldValues, TTransformedValues>,\n  | 'onSubmit'\n  | 'onSubmitError'\n  | 'onSubmitInvalid'\n  //\n  | 'Children'\n  //\n  | 'form'\n  | 'utils'\n>;\n\nfunction _Form<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>({\n  formId,\n  formRef,\n  //\n  onSubmit,\n  onSubmitError,\n  onSubmitInvalid,\n  Children,\n  //\n  form,\n  utils,\n}: FormProps<TFieldValues, TTransformedValues>) {\n  const rhfContext = useFormContext<\n    TFieldValues,\n    unknown,\n    TTransformedValues\n  >();\n\n  const config = useRhfUtilsClientConfigMaybeContext();\n\n  // handlers\n\n  const handleSubmit = async (event: React.FormEvent<HTMLFormElement>) => {\n    // cannot stop propagation in handleSubmitValid, b/c it receives a different event object\n    if (utils?.stopSubmitPropagation) event.stopPropagation();\n\n    try {\n      await rhfContext.handleSubmit(handleSubmitValid, onSubmitInvalid)(event);\n    } catch (error) {\n      handleSubmitError(error, event);\n    }\n  };\n\n  const handleSubmitValid = ((\n    data: TTransformedValues,\n    event?: React.BaseSyntheticEvent,\n  ) => {\n    return onSubmit?.(\n      data,\n      {\n        formId,\n        formRef,\n        context: rhfContext,\n        utils,\n        FormSubmitError: FormSubmitError<TFieldValues>,\n      } satisfies UseRhfUtilsFormOnSubmitContext<\n        TFieldValues,\n        TTransformedValues\n      >,\n      event as React.BaseSyntheticEvent<SubmitEvent>, // `as` required due to conditional generic\n    );\n  }) as Parameters<UseFormHandleSubmit<TFieldValues, TTransformedValues>>[0];\n\n  const handleSubmitError = (\n    error: unknown,\n    event: React.BaseSyntheticEvent,\n  ) => {\n    // get `FormSubmitErrors`, if possible\n    const formSubmitErrors =\n      error instanceof FormSubmitError\n        ? // consumer can manually throw FormSubmitError (e.g., manual validation)\n          (error as FormSubmitError).errors // `as` to avoid `<any>`\n        : // if error is not FormSubmitError, consumer can provide global handler\n          config?.onSubmitErrorUnknown?.(error);\n\n    if (formSubmitErrors)\n      setCtxErrorsByFormSubmitErrors(rhfContext, formSubmitErrors);\n\n    onSubmitError?.(\n      error,\n      {\n        formId,\n        formRef,\n        context: rhfContext,\n        utils,\n      } satisfies UseRhfUtilsFormOnSubmitErrorContext<\n        TFieldValues,\n        TTransformedValues\n      >,\n      event as React.BaseSyntheticEvent<SubmitEvent>, // `as` required due to conditional generic\n    );\n  };\n\n  const childrenProps: UseRhfUtilsFormChildrenProps<\n    TFieldValues,\n    TTransformedValues\n  > = {\n    formId,\n    formRef,\n    context: rhfContext,\n    utils,\n    Controller: _Controller<TFieldValues>,\n    FormSubmitError: FormSubmitError<TFieldValues>,\n  };\n\n  const FormComponent = config?.FormComponent ?? 'form';\n\n  const FormChildrenWrapper =\n    config?.FormChildrenWrapper ?? PassthroughChildren;\n\n  return (\n    <FormComponent\n      {...form}\n      ref={formRef}\n      onSubmit={(e) => void handleSubmit(e)}\n    >\n      <FormChildrenWrapper {...childrenProps}>\n        {utils?.devTool && (\n          <LazyDevTool\n            props={\n              typeof utils.devTool === 'object' ? utils.devTool : undefined\n            }\n          />\n        )}\n\n        <Children {...childrenProps} />\n      </FormChildrenWrapper>\n    </FormComponent>\n  );\n}\n\nexport default _Form;\n"],"names":["_Form","formId","formRef","onSubmit","onSubmitError","onSubmitInvalid","Children","form","utils","rhfContext","useFormContext","config","useRhfUtilsClientConfigMaybeContext","handleSubmit","event","handleSubmitValid","error","handleSubmitError","data","FormSubmitError","formSubmitErrors","_a","setCtxErrorsByFormSubmitErrors","childrenProps","_Controller","FormComponent","FormChildrenWrapper","PassthroughChildren","jsx","e","jsxs","LazyDevTool"],"mappings":";;;;;;;;;AA0CA,SAASA,EAGP;AAAA,EACA,QAAAC;AAAA,EACA,SAAAC;AAAA;AAAA,EAEA,UAAAC;AAAA,EACA,eAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,UAAAC;AAAA;AAAA,EAEA,MAAAC;AAAA,EACA,OAAAC;AACF,GAAgD;AAC9C,QAAMC,IAAaC,KAMbC,IAASC,KAITC,IAAe,OAAOC,MAA4C;AAElE,IAAAN,KAAA,QAAAA,EAAO,yBAAuBM,EAAM,gBAAgB;AAEpD,QAAA;AACF,YAAML,EAAW,aAAaM,GAAmBV,CAAe,EAAES,CAAK;AAAA,aAChEE,GAAO;AACd,MAAAC,EAAkBD,GAAOF,CAAK;AAAA,IAChC;AAAA,EAAA,GAGIC,IAAqB,CACzBG,GACAJ,MAEOX,KAAA,gBAAAA;AAAA,IACLe;AAAA,IACA;AAAA,MACE,QAAAjB;AAAA,MACA,SAAAC;AAAA,MACA,SAASO;AAAA,MACT,OAAAD;AAAA,MACA,iBAAAW;AAAA,IACF;AAAA,IAIAL;AAAA,KAIEG,IAAoB,CACxBD,GACAF,MACG;;AAEH,UAAMM,IACJJ,aAAiBG;AAAA;AAAA,MAEZH,EAA0B;AAAA;AAAA;AAAA,OAE3BK,IAAAV,KAAA,gBAAAA,EAAQ,yBAAR,gBAAAU,EAAA,KAAAV,GAA+BK;AAAA;AAEjC,IAAAI,KACFE,EAA+Bb,GAAYW,CAAgB,GAE7DhB,KAAA,QAAAA;AAAA,MACEY;AAAA,MACA;AAAA,QACE,QAAAf;AAAA,QACA,SAAAC;AAAA,QACA,SAASO;AAAA,QACT,OAAAD;AAAA,MACF;AAAA,MAIAM;AAAA;AAAA,EACF,GAGIS,IAGF;AAAA,IACF,QAAAtB;AAAA,IACA,SAAAC;AAAA,IACA,SAASO;AAAA,IACT,OAAAD;AAAA,IACA,YAAYgB;AAAA,IACZ,iBAAAL;AAAA,EAAA,GAGIM,KAAgBd,KAAA,gBAAAA,EAAQ,kBAAiB,QAEzCe,KACJf,KAAA,gBAAAA,EAAQ,wBAAuBgB;AAG/B,SAAA,gBAAAC;AAAA,IAACH;AAAA,IAAA;AAAA,MACE,GAAGlB;AAAA,MACJ,KAAKL;AAAA,MACL,UAAU,CAAC2B,MAAM,KAAKhB,EAAagB,CAAC;AAAA,MAEpC,UAAA,gBAAAC,EAACJ,GAAqB,EAAA,GAAGH,GACtB,UAAA;AAAA,SAAAf,KAAA,gBAAAA,EAAO,YACN,gBAAAoB;AAAA,UAACG;AAAA,UAAA;AAAA,YACC,OACE,OAAOvB,EAAM,WAAY,WAAWA,EAAM,UAAU;AAAA,UAAA;AAAA,QAExD;AAAA,QAGF,gBAAAoB,EAACtB,GAAU,EAAA,GAAGiB,GAAe;AAAA,MAAA,GAC/B;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/esm/form/FormWithProviders.mjs

@@ -9,3 +9,4 @@ function n(m) {
 export {
   n as default
 };
+//# sourceMappingURL=FormWithProviders.mjs.map

package/dist/esm/form/FormWithProviders.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormWithProviders.mjs","sources":["../../../src/form/FormWithProviders.tsx"],"sourcesContent":["import Form from './Form';\nimport RhfUtilsFormProviders from './RhfUtilsFormProviders';\nimport type { SafeFieldValues } from './SafeFieldValues';\nimport useRhfUtilsForm from './useRhfUtilsForm';\nimport type { UseRhfUtilsFormProps } from './UseRhfUtilsFormProps';\n\nexport type FormWithProvidersProps<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n> = React.PropsWithChildren<\n  UseRhfUtilsFormProps<TFieldValues, TTransformedValues>\n>;\n\n/**\n * Form providers (with utils) with immediate descendent {@link Form}.\n * (Syntactic sugar for {@link useRhfUtilsForm}. Use this for most applications.)\n *\n * Use {@link useRhfUtilsForm} if you need to specific nesting hierarchy.\n * (e.g., wrapping `<tr>` with provider and nesting `<form>` within `<td>` to appease HTML rules.)\n */\nfunction FormWithProviders<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>(props: FormWithProvidersProps<TFieldValues, TTransformedValues>) {\n  const form = useRhfUtilsForm(props);\n\n  return (\n    <RhfUtilsFormProviders {...form.providerProps}>\n      <Form {...form.formProps} />\n    </RhfUtilsFormProviders>\n  );\n}\n\nexport default FormWithProviders;\n"],"names":["FormWithProviders","props","form","useRhfUtilsForm","jsx","RhfUtilsFormProviders","Form"],"mappings":";;;;AAoBA,SAASA,EAGPC,GAAiE;AAC3D,QAAAC,IAAOC,EAAgBF,CAAK;AAGhC,SAAA,gBAAAG,EAACC,GAAuB,EAAA,GAAGH,EAAK,eAC9B,4BAACI,GAAM,EAAA,GAAGJ,EAAK,UAAW,CAAA,EAC5B,CAAA;AAEJ;"}

package/dist/esm/form/RhfUtilsFormProviders.mjs

@@ -22,3 +22,4 @@ function v({
 export {
   v as default
 };
+//# sourceMappingURL=RhfUtilsFormProviders.mjs.map

package/dist/esm/form/RhfUtilsFormProviders.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RhfUtilsFormProviders.mjs","sources":["../../../src/form/RhfUtilsFormProviders.tsx"],"sourcesContent":["import type { UseFormReturn } from 'react-hook-form';\nimport { FormProvider } from 'react-hook-form';\n\nimport FlatFieldErrorsContextProvider from '@/errors/flat/context/FlatFieldErrorsContextProvider';\n\nimport RhfUtilsContextProvider from './context/utils/RhfUtilsContextProvider';\nimport type { RhfUtilsFormOptions } from './RhfUtilsFormOptions';\nimport type { SafeFieldValues } from './SafeFieldValues';\n\nexport type RhfUtilsFormProvidersProps<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n> = React.PropsWithChildren<{\n  formId: string;\n  formRef: React.RefObject<HTMLFormElement>;\n  rhfForm: UseFormReturn<TFieldValues, unknown, TTransformedValues>;\n  utils?: RhfUtilsFormOptions;\n}>;\n\nfunction RhfUtilsFormProviders<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>({\n  formId,\n  formRef,\n  rhfForm,\n  utils,\n  children,\n}: RhfUtilsFormProvidersProps<TFieldValues, TTransformedValues>) {\n  return (\n    <FormProvider {...rhfForm}>\n      <FlatFieldErrorsContextProvider formRef={formRef}>\n        <RhfUtilsContextProvider\n          formId={formId}\n          formRef={formRef}\n          options={utils}\n        >\n          {children}\n        </RhfUtilsContextProvider>\n      </FlatFieldErrorsContextProvider>\n    </FormProvider>\n  );\n}\n\nexport default RhfUtilsFormProviders;\n"],"names":["RhfUtilsFormProviders","formId","formRef","rhfForm","utils","children","FormProvider","jsx","FlatFieldErrorsContextProvider","RhfUtilsContextProvider"],"mappings":";;;;AAmBA,SAASA,EAGP;AAAA,EACA,QAAAC;AAAA,EACA,SAAAC;AAAA,EACA,SAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC;AACF,GAAiE;AAC/D,2BACGC,GAAc,EAAA,GAAGH,GAChB,UAAA,gBAAAI,EAACC,KAA+B,SAAAN,GAC9B,UAAA,gBAAAK;AAAA,IAACE;AAAA,IAAA;AAAA,MACC,QAAAR;AAAA,MACA,SAAAC;AAAA,MACA,SAASE;AAAA,MAER,UAAAC;AAAA,IAAA;AAAA,EAAA,EAEL,CAAA,EACF,CAAA;AAEJ;"}

package/dist/esm/form/_Controller.mjs

@@ -6,3 +6,4 @@ function n(r) {
 export {
   n as default
 };
+//# sourceMappingURL=_Controller.mjs.map

package/dist/esm/form/_Controller.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_Controller.mjs","sources":["../../../src/form/_Controller.tsx"],"sourcesContent":["import type { ControllerProps, FieldPath } from 'react-hook-form';\nimport { Controller as RhfController } from 'react-hook-form';\n\nimport type { SafeFieldValues } from './SafeFieldValues';\n\nexport type _ControllerProps<\n  TFieldValues extends SafeFieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n> = Omit<ControllerProps<TFieldValues, TName>, 'control'>;\n\nfunction _Controller<\n  TFieldValues extends SafeFieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n>(props: _ControllerProps<TFieldValues, TName>) {\n  return <RhfController {...props} />;\n}\n\nexport default _Controller;\n"],"names":["_Controller","props","jsx","RhfController"],"mappings":";;AAUA,SAASA,EAGPC,GAA8C;AACvC,SAAA,gBAAAC,EAACC,GAAe,EAAA,GAAGF,EAAO,CAAA;AACnC;"}

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

@@ -28,3 +28,4 @@ const B = ({ children: o }) => {
 export {
   h as default
 };
+//# sourceMappingURL=FormGroupContextProvider.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormGroupContextProvider.mjs","sources":["../../../../../src/form/context/group/FormGroupContextProvider.tsx"],"sourcesContent":["import React from 'react';\n\nimport { _FormGroupContextProvider } from '.';\n\ntype Props = React.PropsWithChildren;\n\nconst FormGroupContextProvider: React.FC<Props> = ({ children }) => {\n  // children\n\n  const [childrenBusyIds, setChildrenBusyIds] = React.useState<string[]>([]);\n\n  const childrenBusyCount = childrenBusyIds.length;\n\n  const setChildrenBusyId = React.useCallback((id: string, isBusy: boolean) => {\n    setChildrenBusyIds((prev) =>\n      isBusy\n        ? // add to array\n          [...prev, id]\n        : // remove from array\n          prev.filter((formId) => formId !== id),\n    );\n  }, []);\n\n  // parent\n\n  const [isParentBusy, setIsParentBusy] = React.useState(false);\n\n  // value\n\n  const value = {\n    children: {\n      busyCount: childrenBusyCount,\n      busyIds: childrenBusyIds,\n      setBusyId: setChildrenBusyId,\n    },\n    parent: {\n      isBusy: isParentBusy,\n      setIsBusy: setIsParentBusy,\n    },\n  };\n\n  return (\n    <_FormGroupContextProvider value={value}>\n      {children}\n    </_FormGroupContextProvider>\n  );\n};\n\nexport default FormGroupContextProvider;\n"],"names":["FormGroupContextProvider","children","childrenBusyIds","setChildrenBusyIds","React","childrenBusyCount","setChildrenBusyId","id","isBusy","prev","formId","isParentBusy","setIsParentBusy","jsx","_FormGroupContextProvider","FormGroupContextProvider$1"],"mappings":";;;AAMA,MAAMA,IAA4C,CAAC,EAAE,UAAAC,QAAe;AAGlE,QAAM,CAACC,GAAiBC,CAAkB,IAAIC,EAAM,SAAmB,CAAA,CAAE,GAEnEC,IAAoBH,EAAgB,QAEpCI,IAAoBF,EAAM,YAAY,CAACG,GAAYC,MAAoB;AAC3E,IAAAL;AAAA,MAAmB,CAACM,MAClBD;AAAA;AAAA,QAEI,CAAC,GAAGC,GAAMF,CAAE;AAAA;AAAA;AAAA,QAEZE,EAAK,OAAO,CAACC,MAAWA,MAAWH,CAAE;AAAA;AAAA,IAAA;AAAA,EAE7C,GAAG,CAAE,CAAA,GAIC,CAACI,GAAcC,CAAe,IAAIR,EAAM,SAAS,EAAK;AAiB1D,SAAA,gBAAAS,EAACC,GAA0B,EAAA,OAbf;AAAA,IACZ,UAAU;AAAA,MACR,WAAWT;AAAA,MACX,SAASH;AAAA,MACT,WAAWI;AAAA,IACb;AAAA,IACA,QAAQ;AAAA,MACN,QAAQK;AAAA,MACR,WAAWC;AAAA,IACb;AAAA,EAAA,GAKG,UAAAX,EACH,CAAA;AAEJ,GAEAc,IAAef;"}

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

@@ -9,3 +9,4 @@ export {
   t as _useFormGroupContext,
   u as _useFormGroupContextMaybe
 };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../../src/form/context/group/index.ts"],"sourcesContent":["import createContext from '@/utils/createContext';\n\nexport type FormGroupContext = {\n  /** Dependent forms. */\n  children: {\n    busyIds: string[];\n    busyCount: number;\n    setBusyId: (id: string, isBusy: boolean) => void;\n  };\n  /** Main form. */\n  parent: {\n    isBusy: boolean;\n    setIsBusy: (isBusy: boolean) => void;\n  };\n};\n\nexport const {\n  Provider: _FormGroupContextProvider,\n  useRequired: _useFormGroupContext,\n  useMaybe: _useFormGroupContextMaybe,\n} = createContext<FormGroupContext>();\n"],"names":["_FormGroupContextProvider","_useFormGroupContext","_useFormGroupContextMaybe","createContext"],"mappings":";AAgBa,MAAA;AAAA,EACX,UAAUA;AAAA,EACV,aAAaC;AAAA,EACb,UAAUC;AACZ,IAAIC,EAAgC;"}

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

@@ -4,3 +4,4 @@ const e = () => (r(!0), o()), t = e;
 export {
   t as default
 };
+//# sourceMappingURL=useFormGroupChildIsMountedTracker.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupChildIsMountedTracker.mjs","sources":["../../../../../src/form/context/group/useFormGroupChildIsMountedTracker.ts"],"sourcesContent":["import useFormGroupChildTracker from './useFormGroupChildTracker';\nimport useFormGroupIsParentBusy from './useFormGroupIsParentBusy';\n\n/**\n * Mark \"child\" form as \"busy\" when mounted.\n */\nconst useFormGroupChildIsMountedTracker = () => {\n  useFormGroupChildTracker(true);\n\n  // return parent status\n  return useFormGroupIsParentBusy();\n};\n\nexport default useFormGroupChildIsMountedTracker;\n"],"names":["useFormGroupChildIsMountedTracker","useFormGroupChildTracker","useFormGroupIsParentBusy","useFormGroupChildIsMountedTracker$1"],"mappings":";;AAMA,MAAMA,IAAoC,OACxCC,EAAyB,EAAI,GAGtBC,EAAyB,IAGlCC,IAAeH;"}

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

@@ -8,3 +8,4 @@ const m = () => {
 export {
   n as default
 };
+//# sourceMappingURL=useFormGroupChildIsSubmittingTracker.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupChildIsSubmittingTracker.mjs","sources":["../../../../../src/form/context/group/useFormGroupChildIsSubmittingTracker.ts"],"sourcesContent":["import { useFormState } from 'react-hook-form';\n\nimport useFormGroupChildTracker from './useFormGroupChildTracker';\nimport useFormGroupIsParentBusy from './useFormGroupIsParentBusy';\n\n/**\n * Mark \"child\" form as \"busy\" when submitting.\n */\nconst useFormGroupChildIsSubmittingTracker = () => {\n  const { isSubmitting } = useFormState();\n\n  useFormGroupChildTracker(isSubmitting);\n\n  // return parent status\n  return useFormGroupIsParentBusy();\n};\n\nexport default useFormGroupChildIsSubmittingTracker;\n"],"names":["useFormGroupChildIsSubmittingTracker","isSubmitting","useFormState","useFormGroupChildTracker","useFormGroupIsParentBusy","useFormGroupChildIsSubmittingTracker$1"],"mappings":";;;AAQA,MAAMA,IAAuC,MAAM;AAC3C,QAAA,EAAE,cAAAC,MAAiBC;AAEzB,SAAAC,EAAyBF,CAAY,GAG9BG,EAAyB;AAClC,GAEAC,IAAeL;"}

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

@@ -11,3 +11,4 @@ const u = (s) => {
 export {
   d as default
 };
+//# sourceMappingURL=useFormGroupChildTracker.mjs.map

package/dist/esm/form/context/group/useFormGroupChildTracker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupChildTracker.mjs","sources":["../../../../../src/form/context/group/useFormGroupChildTracker.ts"],"sourcesContent":["import React from 'react';\n\nimport { _useFormGroupContext } from '.';\n\n/**\n * Mark \"child\" form as \"busy\" via arbitrary boolean.\n * Automatically marks as \"not busy\" on dismount.\n */\nconst useFormGroupChildTracker = (track: boolean) => {\n  const { setBusyId } = _useFormGroupContext().children;\n\n  // generate unique id to track this form instance\n  const id = React.useId();\n\n  // update context state based on isSubmitting\n  React.useEffect(() => {\n    setBusyId(id, track);\n  }, [track, id, setBusyId]);\n\n  // on dismount, set form as not busy\n  // (e.g., form hides after successful submission; useEffect above will not re-run before unmount)\n  React.useEffect(() => {\n    return () => {\n      setBusyId(id, false);\n    };\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps\n};\n\nexport default useFormGroupChildTracker;\n"],"names":["useFormGroupChildTracker","track","setBusyId","_useFormGroupContext","id","React","useFormGroupChildTracker$1"],"mappings":";;AAQA,MAAMA,IAA2B,CAACC,MAAmB;AACnD,QAAM,EAAE,WAAAC,EAAA,IAAcC,EAAA,EAAuB,UAGvCC,IAAKC,EAAM;AAGjB,EAAAA,EAAM,UAAU,MAAM;AACpB,IAAAH,EAAUE,GAAIH,CAAK;AAAA,EAClB,GAAA,CAACA,GAAOG,GAAIF,CAAS,CAAC,GAIzBG,EAAM,UAAU,MACP,MAAM;AACX,IAAAH,EAAUE,GAAI,EAAK;AAAA,EAAA,GAEpB,CAAE,CAAA;AACP,GAEAE,IAAeN;"}

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

@@ -6,3 +6,4 @@ const r = () => {
 export {
   e as default
 };
+//# sourceMappingURL=useFormGroupIsAnyBusy.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupIsAnyBusy.mjs","sources":["../../../../../src/form/context/group/useFormGroupIsAnyBusy.ts"],"sourcesContent":["import { _useFormGroupContextMaybe } from '.';\n\nconst useFormGroupIsAnyBusy = (): boolean => {\n  const ctx = _useFormGroupContextMaybe();\n\n  return !!ctx?.children.busyCount || !!ctx?.parent.isBusy;\n};\n\nexport default useFormGroupIsAnyBusy;\n"],"names":["useFormGroupIsAnyBusy","ctx","_useFormGroupContextMaybe","useFormGroupIsAnyBusy$1"],"mappings":";AAEA,MAAMA,IAAwB,MAAe;AAC3C,QAAMC,IAAMC;AAEL,SAAA,CAAC,EAACD,KAAA,QAAAA,EAAK,SAAS,cAAa,CAAC,EAACA,KAAA,QAAAA,EAAK,OAAO;AACpD,GAEAE,IAAeH;"}

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

@@ -6,3 +6,4 @@ const s = () => {
 export {
   e as default
 };
+//# sourceMappingURL=useFormGroupIsChildBusy.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupIsChildBusy.mjs","sources":["../../../../../src/form/context/group/useFormGroupIsChildBusy.ts"],"sourcesContent":["import { _useFormGroupContextMaybe } from '.';\n\nconst useFormGroupIsChildBusy = (): boolean => {\n  const ctx = _useFormGroupContextMaybe();\n\n  return !!ctx?.children.busyCount;\n};\n\nexport default useFormGroupIsChildBusy;\n"],"names":["useFormGroupIsChildBusy","ctx","_useFormGroupContextMaybe","useFormGroupIsChildBusy$1"],"mappings":";AAEA,MAAMA,IAA0B,MAAe;AAC7C,QAAMC,IAAMC;AAEL,SAAA,CAAC,EAACD,KAAA,QAAAA,EAAK,SAAS;AACzB,GAEAE,IAAeH;"}

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

@@ -6,3 +6,4 @@ const s = () => {
 export {
   s as default
 };
+//# sourceMappingURL=useFormGroupIsParentBusy.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupIsParentBusy.mjs","sources":["../../../../../src/form/context/group/useFormGroupIsParentBusy.ts"],"sourcesContent":["import { _useFormGroupContextMaybe } from '.';\n\nconst useFormGroupIsParentBusy = (): boolean => {\n  const ctx = _useFormGroupContextMaybe();\n\n  return !!ctx?.parent.isBusy;\n};\n\nexport default useFormGroupIsParentBusy;\n"],"names":["useFormGroupIsParentBusy","ctx","_useFormGroupContextMaybe"],"mappings":";AAEA,MAAMA,IAA2B,MAAe;AAC9C,QAAMC,IAAMC;AAEL,SAAA,CAAC,EAACD,KAAA,QAAAA,EAAK,OAAO;AACvB;"}

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

@@ -11,3 +11,4 @@ const m = () => {
 export {
   f as default
 };
+//# sourceMappingURL=useFormGroupParentTracker.mjs.map

package/dist/esm/form/context/group/useFormGroupParentTracker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormGroupParentTracker.mjs","sources":["../../../../../src/form/context/group/useFormGroupParentTracker.ts"],"sourcesContent":["import React from 'react';\n\nimport useFormIsBusy from '@/form/useFormIsBusy';\n\nimport { _useFormGroupContext } from '.';\nimport useFormGroupIsChildBusy from './useFormGroupIsChildBusy';\n\n/**\n * Connect specific form state as parent context.\n *\n * Requires usage of provider.\n */\nconst useFormGroupParentTracker = () => {\n  const isBusy = useFormIsBusy();\n\n  const { setIsBusy } = _useFormGroupContext().parent;\n\n  // when this form state changes, update context state\n  React.useEffect(() => {\n    setIsBusy(isBusy);\n  }, [setIsBusy, isBusy]);\n\n  // return children status\n  return useFormGroupIsChildBusy();\n};\n\nexport default useFormGroupParentTracker;\n"],"names":["useFormGroupParentTracker","isBusy","useFormIsBusy","setIsBusy","_useFormGroupContext","React","useFormGroupIsChildBusy","useFormGroupParentTracker$1"],"mappings":";;;;AAYA,MAAMA,IAA4B,MAAM;AACtC,QAAMC,IAASC,KAET,EAAE,WAAAC,EAAA,IAAcC,EAAA,EAAuB;AAG7C,SAAAC,EAAM,UAAU,MAAM;AACpB,IAAAF,EAAUF,CAAM;AAAA,EAAA,GACf,CAACE,GAAWF,CAAM,CAAC,GAGfK,EAAwB;AACjC,GAEAC,IAAeP;"}

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

@@ -8,3 +8,4 @@ const u = () => {
 export {
   a as default
 };
+//# sourceMappingURL=useFormOrParentIsBusy.mjs.map

package/dist/esm/form/context/group/useFormOrParentIsBusy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormOrParentIsBusy.mjs","sources":["../../../../../src/form/context/group/useFormOrParentIsBusy.ts"],"sourcesContent":["import useFormIsBusy from '../../useFormIsBusy';\n\nimport { _useFormGroupContextMaybe } from '.';\n\nconst useFormOrParentIsBusy = (): boolean => {\n  const isFormBusy = useFormIsBusy();\n  const isParentBusy = _useFormGroupContextMaybe()?.parent.isBusy;\n\n  return Boolean(isFormBusy || isParentBusy);\n};\n\nexport default useFormOrParentIsBusy;\n"],"names":["useFormOrParentIsBusy","isFormBusy","useFormIsBusy","isParentBusy","_a","_useFormGroupContextMaybe","useFormOrParentIsBusy$1"],"mappings":";;AAIA,MAAMA,IAAwB,MAAe;;AAC3C,QAAMC,IAAaC,KACbC,KAAeC,IAAAC,QAAA,gBAAAD,EAA6B,OAAO;AAElD,SAAA,GAAQH,KAAcE;AAC/B,GAEAG,IAAeN;"}

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

@@ -19,3 +19,4 @@ const n = ({
 export {
   n as default
 };
+//# sourceMappingURL=RhfUtilsContextProvider.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RhfUtilsContextProvider.mjs","sources":["../../../../../src/form/context/utils/RhfUtilsContextProvider.tsx"],"sourcesContent":["import useRhfUtilsClientConfigMaybeContext from '@/client/config/useRhfUtilsClientConfigContext';\n\nimport useFlatFieldErrorsContextOutput from '@/errors/flat/context/useFlatFieldErrorsContextOutput';\n\nimport type { RhfUtilsFormOptions } from '@/form/RhfUtilsFormOptions';\n\nimport useResetFormOnSubmitted from '@/submit/useResetFormOnSubmitted';\nimport useSubmitFormOnChange from '@/submit/useSubmitFormOnChange';\n\nimport { _RhfUtilsContextProvider } from './useRhfUtilsContext';\n\ntype Props = React.PropsWithChildren<{\n  formId: string;\n  formRef: React.RefObject<HTMLFormElement>;\n  options?: RhfUtilsFormOptions;\n}>;\n\nconst RhfUtilsContextProvider: React.FC<Props> = ({\n  formId,\n  formRef,\n  options,\n  children,\n}) => {\n  const config = useRhfUtilsClientConfigMaybeContext();\n\n  useFlatFieldErrorsContextOutput(config?.FieldErrors?.output);\n\n  useSubmitFormOnChange(formRef, {\n    disabled: !options?.submitOnChange,\n  });\n\n  useResetFormOnSubmitted(options?.resetOnSubmitted);\n\n  return (\n    <_RhfUtilsContextProvider value={{ formId, formRef, options }}>\n      {children}\n    </_RhfUtilsContextProvider>\n  );\n};\n\nexport default RhfUtilsContextProvider;\n"],"names":["RhfUtilsContextProvider","formId","formRef","options","children","config","useRhfUtilsClientConfigMaybeContext","useFlatFieldErrorsContextOutput","_a","useSubmitFormOnChange","useResetFormOnSubmitted","jsx","_RhfUtilsContextProvider"],"mappings":";;;;;;AAiBA,MAAMA,IAA2C,CAAC;AAAA,EAChD,QAAAC;AAAA,EACA,SAAAC;AAAA,EACA,SAAAC;AAAA,EACA,UAAAC;AACF,MAAM;;AACJ,QAAMC,IAASC;AAEiB,SAAAC,GAAAC,IAAAH,KAAA,gBAAAA,EAAQ,gBAAR,gBAAAG,EAAqB,MAAM,GAE3DC,EAAsBP,GAAS;AAAA,IAC7B,UAAU,EAACC,KAAA,QAAAA,EAAS;AAAA,EAAA,CACrB,GAEDO,EAAwBP,KAAA,gBAAAA,EAAS,gBAAgB,GAG/C,gBAAAQ,EAACC,KAAyB,OAAO,EAAE,QAAAX,GAAQ,SAAAC,GAAS,SAAAC,EAAA,GACjD,UAAAC,EACH,CAAA;AAEJ;"}

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

@@ -4,3 +4,4 @@ export {
   r as _RhfUtilsContextProvider,
   i as default
 };
+//# sourceMappingURL=useRhfUtilsContext.mjs.map

package/dist/esm/form/context/utils/useRhfUtilsContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRhfUtilsContext.mjs","sources":["../../../../../src/form/context/utils/useRhfUtilsContext.tsx"],"sourcesContent":["import type { RhfUtilsFormOptions } from '@/form/RhfUtilsFormOptions';\n\nimport createContext from '@/utils/createContext';\n\nexport type RhfUtilsContext = {\n  formId: string;\n  formRef: React.RefObject<HTMLFormElement>;\n  options: RhfUtilsFormOptions | undefined;\n};\n\nconst { Provider: _RhfUtilsContextProvider, useRequired: _useRhfUtilsContext } =\n  createContext<RhfUtilsContext>();\n\n/**\n * Use utils from the current form context.\n */\nconst useRhfUtilsContext = _useRhfUtilsContext;\n\nexport default useRhfUtilsContext;\n\nexport { _RhfUtilsContextProvider };\n"],"names":["_RhfUtilsContextProvider","_useRhfUtilsContext","createContext","useRhfUtilsContext","useRhfUtilsContext$1"],"mappings":";AAUA,MAAM,EAAE,UAAUA,GAA0B,aAAaC,EAAA,IACvDC,EAA+B,GAK3BC,IAAqBF,GAE3BG,IAAeD;"}

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

@@ -7,3 +7,4 @@ const o = () => {
 export {
   m as default
 };
+//# sourceMappingURL=useRhfUtilsContextRequestSubmit.mjs.map

package/dist/esm/form/context/utils/useRhfUtilsContextRequestSubmit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRhfUtilsContextRequestSubmit.mjs","sources":["../../../../../src/form/context/utils/useRhfUtilsContextRequestSubmit.ts"],"sourcesContent":["import useFormRequestSubmit from '@/form/utils/useFormRequestSubmit';\n\nimport useRhfUtilsContext from './useRhfUtilsContext';\n\n/**\n * Get `requestSubmit` function from the form ref'd in current context.\n */\nconst useRhfUtilsContextRequestSubmit = () => {\n  const utils = useRhfUtilsContext();\n\n  return useFormRequestSubmit(utils.formRef);\n};\n\nexport default useRhfUtilsContextRequestSubmit;\n"],"names":["useRhfUtilsContextRequestSubmit","utils","useRhfUtilsContext","useFormRequestSubmit","useRhfUtilsContextRequestSubmit$1"],"mappings":";;AAOA,MAAMA,IAAkC,MAAM;AAC5C,QAAMC,IAAQC;AAEP,SAAAC,EAAqBF,EAAM,OAAO;AAC3C,GAEAG,IAAeJ;"}

package/dist/esm/form/useFormIsBusy.mjs

@@ -6,3 +6,4 @@ const e = () => {
 export {
   e as default
 };
+//# sourceMappingURL=useFormIsBusy.mjs.map

package/dist/esm/form/useFormIsBusy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormIsBusy.mjs","sources":["../../../src/form/useFormIsBusy.ts"],"sourcesContent":["import { useFormState } from 'react-hook-form';\n\nconst useFormIsBusy = (): boolean => {\n  const { isSubmitting, isLoading } = useFormState();\n\n  return isSubmitting || isLoading;\n};\n\nexport default useFormIsBusy;\n"],"names":["useFormIsBusy","isSubmitting","isLoading","useFormState"],"mappings":";AAEA,MAAMA,IAAgB,MAAe;AACnC,QAAM,EAAE,cAAAC,GAAc,WAAAC,EAAU,IAAIC,EAAa;AAEjD,SAAOF,KAAgBC;AACzB;"}

package/dist/esm/form/useRhfUtilsForm.mjs

@@ -41,3 +41,4 @@ const v = ({
 export {
   v as default
 };
+//# sourceMappingURL=useRhfUtilsForm.mjs.map

package/dist/esm/form/useRhfUtilsForm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRhfUtilsForm.mjs","sources":["../../../src/form/useRhfUtilsForm.tsx"],"sourcesContent":["import React from 'react';\nimport { useForm as useRhfForm } from 'react-hook-form';\n\nimport { FormSubmitError } from '@/submit/error/FormSubmitError';\n\nimport type { FormProps } from './Form';\nimport type { RhfUtilsFormProvidersProps } from './RhfUtilsFormProviders';\nimport type { SafeFieldValues } from './SafeFieldValues';\nimport type { UseRhfUtilsFormProps } from './UseRhfUtilsFormProps';\nimport type { UseRhfUtilsFormReturn } from './UseRhfUtilsFormReturn';\n\n/**\n * Core Rhf Form hook. Use `Form` in `index.ts` for most cases.\n * Use this if you need to separate form components.\n * e.g., a form for table row due to `form` being considered invalid HTML around `tr` tags.\n * With this hook, you can wrap the `tr` tag with `form.Provider` and use `form.Form` inside\n * one of the cells. Other components can be outside form while referring to form by its id via `form` attribute.\n * see https://caniuse.com/?search=form%20attribute\n * @returns Form provider and form.\n */\nconst useRhfUtilsForm = <\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>({\n  defaultValues,\n  onSubmit,\n  onSubmitError,\n  onSubmitInvalid,\n  Children,\n  rhf,\n  form,\n  utils,\n}: UseRhfUtilsFormProps<\n  TFieldValues,\n  TTransformedValues\n>): UseRhfUtilsFormReturn<TFieldValues, TTransformedValues> => {\n  const formId = React.useId();\n\n  const rhfForm = useRhfForm<TFieldValues, unknown, TTransformedValues>({\n    ...rhf,\n    defaultValues,\n  });\n\n  const formRef = React.useRef<HTMLFormElement>(null);\n\n  const providerProps: RhfUtilsFormProvidersProps<\n    TFieldValues,\n    TTransformedValues\n  > = {\n    formId,\n    formRef,\n    rhfForm,\n    utils,\n  };\n\n  const formProps: FormProps<TFieldValues, TTransformedValues> = {\n    Children,\n    onSubmit,\n    onSubmitError,\n    onSubmitInvalid,\n    formId,\n    formRef,\n    form,\n    utils,\n  };\n\n  return {\n    id: formId,\n    ref: formRef,\n    context: rhfForm,\n    providerProps,\n    formProps,\n    FormSubmitError: FormSubmitError<TFieldValues>,\n  } as const;\n};\n\nexport default useRhfUtilsForm;\n\nexport type UseRhfUtilsForm<\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n> = typeof useRhfUtilsForm<TFieldValues, TTransformedValues>;\n"],"names":["useRhfUtilsForm","defaultValues","onSubmit","onSubmitError","onSubmitInvalid","Children","rhf","form","utils","formId","React","rhfForm","useRhfForm","formRef","FormSubmitError"],"mappings":";;;AAoBA,MAAMA,IAAkB,CAGtB;AAAA,EACA,eAAAC;AAAA,EACA,UAAAC;AAAA,EACA,eAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,UAAAC;AAAA,EACA,KAAAC;AAAA,EACA,MAAAC;AAAA,EACA,OAAAC;AACF,MAG+D;AACvD,QAAAC,IAASC,EAAM,SAEfC,IAAUC,EAAsD;AAAA,IACpE,GAAGN;AAAA,IACH,eAAAL;AAAA,EAAA,CACD,GAEKY,IAAUH,EAAM,OAAwB,IAAI;AAuB3C,SAAA;AAAA,IACL,IAAID;AAAA,IACJ,KAAKI;AAAA,IACL,SAASF;AAAA,IACT,eAtBE;AAAA,MACF,QAAAF;AAAA,MACA,SAAAI;AAAA,MACA,SAAAF;AAAA,MACA,OAAAH;AAAA,IAAA;AAAA,IAmBA,WAhB6D;AAAA,MAC7D,UAAAH;AAAA,MACA,UAAAH;AAAA,MACA,eAAAC;AAAA,MACA,iBAAAC;AAAA,MACA,QAAAK;AAAA,MACA,SAAAI;AAAA,MACA,MAAAN;AAAA,MACA,OAAAC;AAAA,IAAA;AAAA,IASA,iBAAAM;AAAA,EAAA;AAEJ;"}

package/dist/esm/form/utils/getSubmitterButtonData.mjs

@@ -10,3 +10,4 @@ const e = (t) => {
 export {
   i as default
 };
+//# sourceMappingURL=getSubmitterButtonData.mjs.map

package/dist/esm/form/utils/getSubmitterButtonData.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSubmitterButtonData.mjs","sources":["../../../../src/form/utils/getSubmitterButtonData.ts"],"sourcesContent":["import React from 'react';\n\n/**\n * Get [name, value] tuple of button/input that submitted form.\n * Useful when determining user intent\n */\nconst getSubmitterButtonData = (\n  event: React.BaseSyntheticEvent,\n): [name: string, value: string] | undefined => {\n  if (!(event.nativeEvent instanceof SubmitEvent)) return; // not submit\n  if (\n    !(event.nativeEvent.submitter instanceof HTMLButtonElement) && // not button\n    !(event.nativeEvent.submitter instanceof HTMLInputElement) // not input\n  )\n    return;\n\n  if (!event.nativeEvent.submitter.name) return; // no name on button\n\n  return [\n    event.nativeEvent.submitter.name,\n    event.nativeEvent.submitter.value,\n  ] as const;\n};\n\nexport default getSubmitterButtonData;\n"],"names":["getSubmitterButtonData","event","getSubmitterButtonData$1"],"mappings":";AAMA,MAAMA,IAAyB,CAC7BC,MAC8C;AAC1C,MAAEA,EAAM,uBAAuB,eAEjC,IAAEA,EAAM,YAAY,qBAAqB;AAAA,EACzC,EAAEA,EAAM,YAAY,qBAAqB,sBAItCA,EAAM,YAAY,UAAU;AAE1B,WAAA;AAAA,MACLA,EAAM,YAAY,UAAU;AAAA,MAC5BA,EAAM,YAAY,UAAU;AAAA,IAAA;AAEhC,GAEAC,IAAeF;"}

package/dist/esm/form/utils/useFormRequestSubmit.mjs

@@ -7,3 +7,4 @@ const u = (t) => (r) => {
 export {
   u as default
 };
+//# sourceMappingURL=useFormRequestSubmit.mjs.map

package/dist/esm/form/utils/useFormRequestSubmit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormRequestSubmit.mjs","sources":["../../../../src/form/utils/useFormRequestSubmit.ts"],"sourcesContent":["/**\n * Get callback to trigger submit manually on form.\n * @link https://developer.mozilla.org/docs/Web/API/HTMLFormElement/requestSubmit\n */\nconst useFormRequestSubmit =\n  (\n    ref: React.RefObject<HTMLFormElement>, // limit scope to avoid mistakes (allows for `{[string]: any}`)\n  ): HTMLFormElement['requestSubmit'] =>\n  (submitter) => {\n    // typeguard (should never happen at runtime when callback is called)\n    if (!ref.current) throw new Error();\n\n    requestSubmitByForm(ref.current, submitter);\n  };\n\nexport default useFormRequestSubmit;\n\n//\n\nconst requestSubmitByForm = (\n  form: Pick<HTMLFormElement, 'requestSubmit'>, // narrow to avoid `{[string]: any}` type\n  submitter?: HTMLElement | null,\n) => {\n  form.requestSubmit(submitter);\n};\n"],"names":["useFormRequestSubmit","ref","submitter","requestSubmitByForm","form"],"mappings":"AAIA,MAAMA,IACJ,CACEC,MAEF,CAACC,MAAc;AAEb,MAAI,CAACD,EAAI,QAAS,OAAM,IAAI,MAAM;AAEd,EAAAE,EAAAF,EAAI,SAASC,CAAS;AAC5C,GAMIC,IAAsB,CAC1BC,GACAF,MACG;AACH,EAAAE,EAAK,cAAcF,CAAS;AAC9B;"}

package/dist/esm/submit/error/FormSubmitError.mjs

@@ -6,3 +6,4 @@ class t extends Error {
 export {
   t as FormSubmitError
 };
+//# sourceMappingURL=FormSubmitError.mjs.map

package/dist/esm/submit/error/FormSubmitError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSubmitError.mjs","sources":["../../../../src/submit/error/FormSubmitError.ts"],"sourcesContent":["import type { SafeFieldValues } from '@/form/SafeFieldValues';\n\nimport type { FormSubmitErrors } from './FormSubmitErrors';\n\nexport class FormSubmitError<\n  TFieldValues extends SafeFieldValues = SafeFieldValues,\n> extends Error {\n  constructor(\n    public errors: FormSubmitErrors<TFieldValues>,\n    message?: string, // error message\n    // options?: ErrorOptions, // requires es2022\n  ) {\n    super(message);\n  }\n}\n"],"names":["FormSubmitError","errors","message"],"mappings":"AAIO,MAAMA,UAEH,MAAM;AAAA,EACd,YACSC,GACPC,GAEA;AACA,UAAMA,CAAO,GAJN,KAAA,SAAAD;AAAA,EAKT;AACF;"}

package/dist/esm/submit/error/setCtxErrorsByFormSubmitErrors.mjs

@@ -10,3 +10,4 @@ const s = (r, t) => {
 export {
   s as default
 };
+//# sourceMappingURL=setCtxErrorsByFormSubmitErrors.mjs.map

package/dist/esm/submit/error/setCtxErrorsByFormSubmitErrors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"setCtxErrorsByFormSubmitErrors.mjs","sources":["../../../../src/submit/error/setCtxErrorsByFormSubmitErrors.ts"],"sourcesContent":["import type { FieldPath, UseFormReturn } from 'react-hook-form';\n\nimport type { SafeFieldValues } from '@/form/SafeFieldValues';\n\nimport type { FormSubmitErrors } from './FormSubmitErrors';\n\n/**\n * Handle thrown {@link FormSubmitError}.\n * Add key/values as name/message to RHF context errors.\n */\nconst setCtxErrorsByFormSubmitErrors = <\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>(\n  ctx: UseFormReturn<TFieldValues, unknown, TTransformedValues>,\n  errors: FormSubmitErrors,\n) => {\n  // loop through error object and set errors in rhf context\n  Object.entries(errors).forEach(([name, fieldError]) => {\n    ctx.setError(name as FieldPath<TFieldValues>, {\n      type: 'FormSubmitError', // default\n      ...fieldError,\n    });\n  });\n};\n\nexport default setCtxErrorsByFormSubmitErrors;\n"],"names":["setCtxErrorsByFormSubmitErrors","ctx","errors","name","fieldError"],"mappings":"AAUM,MAAAA,IAAiC,CAIrCC,GACAC,MACG;AAEI,SAAA,QAAQA,CAAM,EAAE,QAAQ,CAAC,CAACC,GAAMC,CAAU,MAAM;AACrD,IAAAH,EAAI,SAASE,GAAiC;AAAA,MAC5C,MAAM;AAAA;AAAA,MACN,GAAGC;AAAA,IAAA,CACJ;AAAA,EAAA,CACF;AACH;"}

package/dist/esm/submit/useFormOnSubmitted.mjs

@@ -10,3 +10,4 @@ const c = (e, f) => {
 export {
   c as default
 };
+//# sourceMappingURL=useFormOnSubmitted.mjs.map

package/dist/esm/submit/useFormOnSubmitted.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormOnSubmitted.mjs","sources":["../../../src/submit/useFormOnSubmitted.ts"],"sourcesContent":["import type { MaybePromise } from '@trpc/server/unstable-core-do-not-import';\nimport React from 'react';\nimport { useFormState } from 'react-hook-form';\n\nimport useRefIfValueWasTrue from '@/utils/useRefIfValueWasTrue';\n\nconst useFormOnSubmitted = (\n  callback?: (success: boolean) => MaybePromise<unknown>,\n  options?: { successful?: boolean },\n) => {\n  const { isSubmitSuccessful, isSubmitting } = useFormState();\n\n  const [wasSubmitting, resetWasSubmitting] =\n    useRefIfValueWasTrue(isSubmitting);\n\n  // on successful submit, call callback\n  React.useEffect(() => {\n    if (!callback) return;\n\n    // if currently submitting, ignore\n    if (isSubmitting) return;\n\n    // wait for submit to finish\n    if (!wasSubmitting) return;\n\n    // always reset to wait for next submit\n    resetWasSubmitting();\n\n    // check success against options passed\n    if (\n      options?.successful === undefined || // if option not specified, call on any submit\n      isSubmitSuccessful === options.successful // otherwise, call only if matches\n    ) {\n      callback(isSubmitSuccessful);\n    }\n\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- only track isSubmitting -- so success is checked each time\n  }, [isSubmitting]);\n};\n\nexport default useFormOnSubmitted;\n"],"names":["useFormOnSubmitted","callback","options","isSubmitSuccessful","isSubmitting","useFormState","wasSubmitting","resetWasSubmitting","useRefIfValueWasTrue","React"],"mappings":";;;AAMM,MAAAA,IAAqB,CACzBC,GACAC,MACG;AACH,QAAM,EAAE,oBAAAC,GAAoB,cAAAC,EAAa,IAAIC,EAAa,GAEpD,CAACC,GAAeC,CAAkB,IACtCC,EAAqBJ,CAAY;AAGnC,EAAAK,EAAM,UAAU,MAAM;AACpB,IAAKR,MAGDG,KAGCE,MAGcC,KAOjBN,EAASE,CAAkB;AAAA,EAC7B,GAGC,CAACC,CAAY,CAAC;AACnB;"}

package/dist/esm/submit/useResetFormOnSubmitted.mjs

@@ -34,3 +34,4 @@ const p = (e) => {
 export {
   p as default
 };
+//# sourceMappingURL=useResetFormOnSubmitted.mjs.map

package/dist/esm/submit/useResetFormOnSubmitted.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResetFormOnSubmitted.mjs","sources":["../../../src/submit/useResetFormOnSubmitted.ts"],"sourcesContent":["import { useFormContext } from 'react-hook-form';\n\nimport useFormOnSubmitted from './useFormOnSubmitted';\n\n/**\n * Configuration options for {@link useResetFormOnSubmitted}.\n */\nexport type UseResetFormOnSubmittedOptions =\n  // disabled\n  | undefined\n\n  // enabled\n  | {\n      /**\n       * Reset values on successful submit.\n       * - `defaults`: reset current values to defaults\n       * - `current`: reset defaults to current values\n       */\n      success?: { values: 'defaults' | 'current' };\n\n      /**\n       * Reset values to defaults on submit error.\n       */\n      error?: { values: 'defaults' };\n    };\n\n/**\n * Control resetting of values and (some) state (e.g., `isDirty`) after form submitted.\n *\n * `isDirty` and other state is reset, but submit-related state is preserved, as well as errors.\n *\n * Use cases:\n * - on success:\n *   - `defaults`: reset current values to defaults (e.g., clear form)\n *   - `current`: reset defaults to current values (e.g., keep values)\n * - on error:\n *   - reset current values to default values (e.g., submitOnChange reset)\n *\n * See `Rules` section: https://react-hook-form.com/api/useform/reset/\n * Specifically: \"- It's recommended to reset inside useEffect after submission.\"\n */\nconst useResetFormOnSubmitted = (options: UseResetFormOnSubmittedOptions) => {\n  const { getValues, reset } = useFormContext();\n\n  useFormOnSubmitted((success) => {\n    if (!options) return;\n\n    const whichValues = options[success ? 'success' : 'error']?.values;\n\n    if (!whichValues) return;\n\n    const keepValues = whichValues === 'current';\n\n    const values = keepValues\n      ? getValues() // current values\n      : undefined; // default values\n\n    reset(values, {\n      // keep submit stuff for tracking relevant state (e.g., `useFormOnSubmitSuccessful`)\n      keepIsSubmitSuccessful: true,\n      keepIsSubmitted: true,\n      keepSubmitCount: true,\n\n      /**\n       * This is necessary when setting default values to current values (lest form stop updating).\n       *\n       * Technically, we are keeping values and resetting default values to same values.\n       *\n       * Steps to repro:\n       * - RhfUtilsClientConfig with resetOnSubmitted set to success values to current\n       * - remove `keepValues` prop from reset\n       * - create valid form, submit\n       * - form values should be unchanged\n       * - unexpectedly: can no longer type into input\n       */\n      keepValues,\n\n      // keep errors in the case of unsuccessful submit\n      keepErrors: true,\n    });\n  });\n};\n\nexport default useResetFormOnSubmitted;\n"],"names":["useResetFormOnSubmitted","options","getValues","reset","useFormContext","useFormOnSubmitted","success","whichValues","_a","keepValues","values"],"mappings":";;AAyCM,MAAAA,IAA0B,CAACC,MAA4C;AAC3E,QAAM,EAAE,WAAAC,GAAW,OAAAC,EAAM,IAAIC,EAAe;AAE5C,EAAAC,EAAmB,CAACC,MAAY;;AAC9B,QAAI,CAACL,EAAS;AAEd,UAAMM,KAAcC,IAAAP,EAAQK,IAAU,YAAY,OAAO,MAArC,gBAAAE,EAAwC;AAE5D,QAAI,CAACD,EAAa;AAElB,UAAME,IAAaF,MAAgB,WAE7BG,IAASD,IACXP,EACA,IAAA;AAEJ,IAAAC,EAAMO,GAAQ;AAAA;AAAA,MAEZ,wBAAwB;AAAA,MACxB,iBAAiB;AAAA,MACjB,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAcjB,YAAAD;AAAA;AAAA,MAGA,YAAY;AAAA,IAAA,CACb;AAAA,EAAA,CACF;AACH;"}

package/dist/esm/submit/useSubmitFormOnChange.mjs

@@ -17,3 +17,4 @@ const d = (t, e) => {
 export {
   d as default
 };
+//# sourceMappingURL=useSubmitFormOnChange.mjs.map

package/dist/esm/submit/useSubmitFormOnChange.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubmitFormOnChange.mjs","sources":["../../../src/submit/useSubmitFormOnChange.ts"],"sourcesContent":["import React from 'react';\n\nimport useFormRequestSubmit from '@/form/utils/useFormRequestSubmit';\n\nconst useSubmitFormOnChange = (\n  formRef: React.RefObject<HTMLFormElement>,\n  options?: {\n    /** Disable-able so that default behavior is enabled for sake of simplicity of usage. */\n    disabled?: boolean;\n  },\n) => {\n  const enabled = !options?.disabled;\n\n  const requestSubmit = useFormRequestSubmit(formRef);\n\n  // on mount, listen for event\n  React.useEffect(() => {\n    if (!enabled) return;\n\n    const form = formRef.current;\n\n    if (!form) throw new Error();\n\n    const onChange = () => {\n      requestSubmit();\n    };\n\n    form.addEventListener('change', onChange);\n\n    return () => {\n      form.removeEventListener('change', onChange);\n    };\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps -- on mount\n};\n\nexport default useSubmitFormOnChange;\n"],"names":["useSubmitFormOnChange","formRef","options","enabled","requestSubmit","useFormRequestSubmit","React","form","onChange"],"mappings":";;AAIM,MAAAA,IAAwB,CAC5BC,GACAC,MAIG;AACG,QAAAC,IAAU,EAACD,KAAA,QAAAA,EAAS,WAEpBE,IAAgBC,EAAqBJ,CAAO;AAGlD,EAAAK,EAAM,UAAU,MAAM;AACpB,QAAI,CAACH,EAAS;AAEd,UAAMI,IAAON,EAAQ;AAErB,QAAI,CAACM,EAAY,OAAA,IAAI;AAErB,UAAMC,IAAW,MAAM;AACP,MAAAJ;IAAA;AAGX,WAAAG,EAAA,iBAAiB,UAAUC,CAAQ,GAEjC,MAAM;AACN,MAAAD,EAAA,oBAAoB,UAAUC,CAAQ;AAAA,IAAA;AAAA,EAE/C,GAAG,CAAE,CAAA;AACP;"}

package/dist/esm/utils/PassthroughChildren.mjs

@@ -5,3 +5,4 @@ const a = ({
 export {
   a as default
 };
+//# sourceMappingURL=PassthroughChildren.mjs.map

package/dist/esm/utils/PassthroughChildren.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassthroughChildren.mjs","sources":["../../../src/utils/PassthroughChildren.tsx"],"sourcesContent":["/**\n * Component for simply passing through children.\n *\n * (Useful for conditional wrapping of children.)\n */\nconst PassthroughChildren: React.FC<React.PropsWithChildren> = ({\n  children,\n}) => <>{children}</>;\n\nexport default PassthroughChildren;\n"],"names":["PassthroughChildren","children"],"mappings":";AAKA,MAAMA,IAAyD,CAAC;AAAA,EAC9D,UAAAC;AACF,6BAAS,UAAAA,EAAS,CAAA;"}

package/dist/esm/utils/createContext.mjs

@@ -14,3 +14,4 @@ function i() {
 export {
   i as default
 };
+//# sourceMappingURL=createContext.mjs.map

package/dist/esm/utils/createContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContext.mjs","sources":["../../../src/utils/createContext.ts"],"sourcesContent":["import React from 'react';\n\n/**\n * Create a strictly-typed context that throws error if no provider is found.\n * @returns A tuple with a function to get the context and the context provider.\n */\nfunction createContext<T = unknown>() {\n  const context = React.createContext<T | undefined>(undefined);\n\n  const useMaybe = () => React.useContext(context);\n\n  const useRequired = () => {\n    const c = useMaybe();\n\n    // type guard\n    if (c === undefined) throw new Error();\n\n    return c;\n  };\n\n  return {\n    Provider: context.Provider,\n    useMaybe,\n    useRequired,\n  } as const;\n}\n\nexport default createContext;\n"],"names":["createContext","context","React","useMaybe","useRequired","c"],"mappings":";AAMA,SAASA,IAA6B;AAC9B,QAAAC,IAAUC,EAAM,cAA6B,MAAS,GAEtDC,IAAW,MAAMD,EAAM,WAAWD,CAAO,GAEzCG,IAAc,MAAM;AACxB,UAAMC,IAAIF;AAGV,QAAIE,MAAM,OAAiB,OAAA,IAAI,MAAM;AAE9B,WAAAA;AAAA,EAAA;AAGF,SAAA;AAAA,IACL,UAAUJ,EAAQ;AAAA,IAClB,UAAAE;AAAA,IACA,aAAAC;AAAA,EAAA;AAEJ;"}

package/dist/esm/utils/isEmptyObject.mjs

@@ -2,3 +2,4 @@ const e = (t) => Object.keys(t).length === 0;
 export {
   e as default
 };
+//# sourceMappingURL=isEmptyObject.mjs.map

package/dist/esm/utils/isEmptyObject.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEmptyObject.mjs","sources":["../../../src/utils/isEmptyObject.ts"],"sourcesContent":["const isEmptyObject = (obj: Record<string, unknown>) =>\n  Object.keys(obj).length === 0;\n\nexport default isEmptyObject;\n"],"names":["isEmptyObject","obj"],"mappings":"AAAA,MAAMA,IAAgB,CAACC,MACrB,OAAO,KAAKA,CAAG,EAAE,WAAW;"}

package/dist/esm/utils/useRefIfValueWasTrue.mjs

@@ -12,3 +12,4 @@ const f = (r) => {
 export {
   f as default
 };
+//# sourceMappingURL=useRefIfValueWasTrue.mjs.map

package/dist/esm/utils/useRefIfValueWasTrue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefIfValueWasTrue.mjs","sources":["../../../src/utils/useRefIfValueWasTrue.ts"],"sourcesContent":["import React from 'react';\n\nconst useRefIfValueWasTrue = (value: boolean) => {\n  const hasBooleanChanged = React.useRef(false);\n\n  // when value is true, set ref to true\n  React.useEffect(() => {\n    if (!value) return;\n\n    hasBooleanChanged.current = true;\n  }, [value]);\n\n  const reset = () => {\n    hasBooleanChanged.current = false;\n  };\n\n  return [hasBooleanChanged.current, reset] as const;\n};\n\nexport default useRefIfValueWasTrue;\n"],"names":["useRefIfValueWasTrue","value","hasBooleanChanged","React","reset"],"mappings":";AAEM,MAAAA,IAAuB,CAACC,MAAmB;AACzC,QAAAC,IAAoBC,EAAM,OAAO,EAAK;AAG5C,EAAAA,EAAM,UAAU,MAAM;AACpB,IAAKF,MAELC,EAAkB,UAAU;AAAA,EAAA,GAC3B,CAACD,CAAK,CAAC;AAEV,QAAMG,IAAQ,MAAM;AAClB,IAAAF,EAAkB,UAAU;AAAA,EAAA;AAGvB,SAAA,CAACA,EAAkB,SAASE,CAAK;AAC1C;"}

package/package.json

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