@paragrav/rhf-utils 0.0.138 → 0.0.140

package/dist/esm/exports.mjs

@@ -1,46 +0,0 @@
-import { default as e } from "./client/zod/context/RhfUtilsClientForZodContextProvider.mjs";
-import { default as s } from "./client/zod/context/RhfUtilsZodForm.mjs";
-import { default as u } from "./client/zod/context/useRhfUtilsZodForm.mjs";
-import { default as m } from "./errors/flat/context/useFlatFieldErrorsContext.mjs";
-import { default as d } from "./errors/flat/context/useFlatFieldErrorsContextHasOnlyOrphans.mjs";
-import { default as x } from "./errors/message/RhfUtilsFieldErrorMessage.mjs";
-import { default as F } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
-import { default as C } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
-import { default as R } from "./form/context/utils/useRhfUtilsContext.mjs";
-import { default as E } from "./form/context/utils/useRhfUtilsContextRequestSubmit.mjs";
-import { default as I } from "./form/context/group/FormGroupContextProvider.mjs";
-import { default as b } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
-import { default as B } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
-import { default as S } from "./form/context/group/useFormGroupChildTracker.mjs";
-import { default as T } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
-import { default as M } from "./form/context/group/useFormGroupIsChildBusy.mjs";
-import { default as Z } from "./form/context/group/useFormGroupIsParentBusy.mjs";
-import { default as v } from "./form/context/group/useFormGroupParentTracker.mjs";
-import { default as D } from "./form/context/group/useFormOrParentIsBusy.mjs";
-import { default as L } from "./form/utils/getSubmitterButtonData.mjs";
-import { default as j } from "./form/utils/useFormRequestSubmit.mjs";
-import { FormSubmitError as z } from "./submit/error/FormSubmitError.mjs";
-export {
-  I as FormGroupContextProvider,
-  F as FormNonFieldErrorMarker,
-  z as FormSubmitError,
-  e as RhfUtilsClientForZodContextProvider,
-  x as RhfUtilsFieldErrorMessage,
-  s as RhfUtilsZodForm,
-  C as RootErrorsListFromFlatFieldErrorsContext,
-  L as getSubmitterButtonData,
-  m as useFlatFieldErrorsContext,
-  d as useFlatFieldErrorsContextHasOnlyOrphans,
-  b as useFormGroupChildIsMountedTracker,
-  B as useFormGroupChildIsSubmittingTracker,
-  S as useFormGroupChildTracker,
-  T as useFormGroupIsAnyBusy,
-  M as useFormGroupIsChildBusy,
-  Z as useFormGroupIsParentBusy,
-  v as useFormGroupParentTracker,
-  D as useFormOrParentIsBusy,
-  j as useFormRequestSubmit,
-  R as useRhfUtilsContext,
-  E as useRhfUtilsContextRequestSubmit,
-  u as useRhfUtilsZodForm
-};

package/dist/esm/form/Form.mjs

@@ -1,86 +0,0 @@
-import { jsx as s, jsxs as j } from "react/jsx-runtime";
-import "react";
-import { useFormContext as W } from "react-hook-form";
-import w from "../client/config/useRhfUtilsClientConfigContext.mjs";
-import E from "../devtool/LazyDevTool.mjs";
-import { FormSubmitError as c } from "../submit/error/FormSubmitError.mjs";
-import S from "../submit/error/setCtxErrorsByFormSubmitFieldErrors.mjs";
-import U from "../utils/PassthroughChildren.mjs";
-import _ from "./_Controller.mjs";
-function G({
-  formId: m,
-  formRef: p,
-  //
-  onSubmit: a,
-  onSubmitError: d,
-  onSubmitInvalid: l,
-  Children: x,
-  //
-  form: F,
-  utils: r
-}) {
-  const e = W(), t = w(), y = async (o) => {
-    r != null && r.stopSubmitPropagation && o.stopPropagation();
-    try {
-      await e.handleSubmit(f, l)(o);
-    } catch (n) {
-      P(n, o);
-    }
-  }, f = (o, n) => a == null ? void 0 : a(
-    o,
-    {
-      formId: m,
-      formRef: p,
-      context: e,
-      utils: r,
-      FormSubmitError: c
-    },
-    n
-  ), P = (o, n) => {
-    var i;
-    const C = o instanceof c ? (
-      // consumer can manually throw FormSubmitError (e.g., manual validation)
-      o.errors
-    ) : (
-      // if error is not FormSubmitError, consumer can provide global handler
-      (i = t == null ? void 0 : t.onSubmitErrorUnknown) == null ? void 0 : i.call(t, o)
-    );
-    C && S(e, C), d == null || d(
-      o,
-      {
-        formId: m,
-        formRef: p,
-        context: e,
-        utils: r
-      },
-      n
-    );
-  }, h = {
-    formId: m,
-    formRef: p,
-    context: e,
-    utils: r,
-    Controller: _,
-    FormSubmitError: c
-  }, b = h, v = (t == null ? void 0 : t.FormComponent) ?? "form", T = (t == null ? void 0 : t.FormChildrenWrapper) ?? U;
-  return /* @__PURE__ */ s(
-    v,
-    {
-      ...F,
-      ref: p,
-      onSubmit: (o) => void y(o),
-      children: /* @__PURE__ */ j(T, { ...b, children: [
-        (r == null ? void 0 : r.devTool) && /* @__PURE__ */ s(
-          E,
-          {
-            props: typeof r.devTool == "object" ? r.devTool : void 0
-          }
-        ),
-        /* @__PURE__ */ s(x, { ...h })
-      ] })
-    }
-  );
-}
-export {
-  G as default
-};

package/dist/esm/form/FormWithProviders.mjs

@@ -1,11 +0,0 @@
-import { jsx as o } from "react/jsx-runtime";
-import i from "./Form.mjs";
-import t from "./RhfUtilsFormProviders.mjs";
-import f from "./useRhfUtilsForm.mjs";
-function n(m) {
-  const r = f(m);
-  return /* @__PURE__ */ o(t, { ...r.providerProps, children: /* @__PURE__ */ o(i, { ...r.formProps }) });
-}
-export {
-  n as default
-};

package/dist/esm/form/RhfUtilsFormProviders.mjs

@@ -1,24 +0,0 @@
-import { jsx as r } from "react/jsx-runtime";
-import { FormProvider as d } from "react-hook-form";
-import n from "../errors/flat/context/FlatFieldErrorsContextProvider.mjs";
-import l from "./context/utils/RhfUtilsContextProvider.mjs";
-function v({
-  formId: t,
-  formRef: o,
-  rhfForm: i,
-  utils: e,
-  children: m
-}) {
-  return /* @__PURE__ */ r(d, { ...i, children: /* @__PURE__ */ r(n, { formRef: o, children: /* @__PURE__ */ r(
-    l,
-    {
-      formId: t,
-      formRef: o,
-      options: e,
-      children: m
-    }
-  ) }) });
-}
-export {
-  v as default
-};

package/dist/esm/form/_Controller.mjs

@@ -1,8 +0,0 @@
-import { jsx as o } from "react/jsx-runtime";
-import { Controller as t } from "react-hook-form";
-function n(r) {
-  return /* @__PURE__ */ o(t, { ...r });
-}
-export {
-  n as default
-};

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

@@ -1,30 +0,0 @@
-import { jsx as y } from "react/jsx-runtime";
-import s from "react";
-import { _FormGroupContextProvider as m } from "./index.mjs";
-const B = ({ children: o }) => {
-  const [t, u] = s.useState([]), n = t.length, a = s.useCallback((e, l) => {
-    u(
-      (r) => l ? (
-        // add to array
-        [...r, e]
-      ) : (
-        // remove from array
-        r.filter((c) => c !== e)
-      )
-    );
-  }, []), [d, i] = s.useState(!1);
-  return /* @__PURE__ */ y(m, { value: {
-    children: {
-      busyCount: n,
-      busyIds: t,
-      setBusyId: a
-    },
-    parent: {
-      isBusy: d,
-      setIsBusy: i
-    }
-  }, children: o });
-}, h = B;
-export {
-  h as default
-};

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

@@ -1,11 +0,0 @@
-import e from "../../../utils/createContext.mjs";
-const {
-  Provider: r,
-  useRequired: t,
-  useMaybe: u
-} = e();
-export {
-  r as _FormGroupContextProvider,
-  t as _useFormGroupContext,
-  u as _useFormGroupContextMaybe
-};

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

@@ -1,6 +0,0 @@
-import r from "./useFormGroupChildTracker.mjs";
-import o from "./useFormGroupIsParentBusy.mjs";
-const e = () => (r(!0), o()), t = e;
-export {
-  t as default
-};

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

@@ -1,10 +0,0 @@
-import { useFormState as o } from "react-hook-form";
-import t from "./useFormGroupChildTracker.mjs";
-import u from "./useFormGroupIsParentBusy.mjs";
-const m = () => {
-  const { isSubmitting: r } = o();
-  return t(r), u();
-}, n = m;
-export {
-  n as default
-};

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

@@ -1,13 +0,0 @@
-import o from "react";
-import { _useFormGroupContext as t } from "./index.mjs";
-const u = (s) => {
-  const { setBusyId: e } = t().children, r = o.useId();
-  o.useEffect(() => {
-    e(r, s);
-  }, [s, r, e]), o.useEffect(() => () => {
-    e(r, !1);
-  }, []);
-}, d = u;
-export {
-  d as default
-};

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

@@ -1,8 +0,0 @@
-import { _useFormGroupContextMaybe as s } from "./index.mjs";
-const r = () => {
-  const o = s();
-  return !!(o != null && o.children.busyCount) || !!(o != null && o.parent.isBusy);
-}, e = r;
-export {
-  e as default
-};

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

@@ -1,8 +0,0 @@
-import { _useFormGroupContextMaybe as r } from "./index.mjs";
-const s = () => {
-  const o = r();
-  return !!(o != null && o.children.busyCount);
-}, e = s;
-export {
-  e as default
-};

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

@@ -1,8 +0,0 @@
-import { _useFormGroupContextMaybe as o } from "./index.mjs";
-const s = () => {
-  const r = o();
-  return !!(r != null && r.parent.isBusy);
-};
-export {
-  s as default
-};

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

@@ -1,13 +0,0 @@
-import s from "react";
-import t from "../../useFormIsBusy.mjs";
-import { _useFormGroupContext as e } from "./index.mjs";
-import u from "./useFormGroupIsChildBusy.mjs";
-const m = () => {
-  const r = t(), { setIsBusy: o } = e().parent;
-  return s.useEffect(() => {
-    o(r);
-  }, [o, r]), u();
-}, f = m;
-export {
-  f as default
-};

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

@@ -1,10 +0,0 @@
-import t from "../../useFormIsBusy.mjs";
-import { _useFormGroupContextMaybe as e } from "./index.mjs";
-const u = () => {
-  var s;
-  const r = t(), o = (s = e()) == null ? void 0 : s.parent.isBusy;
-  return !!(r || o);
-}, a = u;
-export {
-  a as default
-};

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

@@ -1,23 +0,0 @@
-import { jsx as f } from "react/jsx-runtime";
-import l from "../../../client/config/useRhfUtilsClientConfigContext.mjs";
-import d from "../../../errors/flat/context/useFlatFieldErrorsContextOutput.mjs";
-import b from "../../../submit/useResetFormOnSubmitted.mjs";
-import C from "../../../submit/useSubmitFormOnChange.mjs";
-import { _RhfUtilsContextProvider as h } from "./useRhfUtilsContext.mjs";
-const v = ({
-  formId: u,
-  formRef: t,
-  options: e,
-  children: a
-}) => {
-  var m;
-  const r = l();
-  return d((m = r == null ? void 0 : r.fieldErrors) == null ? void 0 : m.output), C(t, {
-    // check for false/undefined
-    disabled: ((e == null ? void 0 : e.submitOnChange) ?? !1) === !1,
-    debounce: typeof (e == null ? void 0 : e.submitOnChange) == "number" ? e.submitOnChange : void 0
-  }), b(e == null ? void 0 : e.resetOnSubmitted), /* @__PURE__ */ f(h, { value: { formId: u, formRef: t, options: e }, children: a });
-};
-export {
-  v as default
-};

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

@@ -1,6 +0,0 @@
-import t from "../../../utils/createContext.mjs";
-const { Provider: r, useRequired: e } = t(), o = e, i = o;
-export {
-  r as _RhfUtilsContextProvider,
-  i as default
-};

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

@@ -1,9 +0,0 @@
-import e from "../../utils/useFormRequestSubmit.mjs";
-import s from "./useRhfUtilsContext.mjs";
-const o = () => {
-  const t = s();
-  return e(t.formRef);
-}, m = o;
-export {
-  m as default
-};

package/dist/esm/form/useFormIsBusy.mjs

@@ -1,8 +0,0 @@
-import { useFormState as o } from "react-hook-form";
-const e = () => {
-  const { isSubmitting: t, isLoading: s } = o();
-  return t || s;
-};
-export {
-  e as default
-};

package/dist/esm/form/useRhfUtilsForm.mjs

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

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

@@ -1,12 +0,0 @@
-import "react";
-const e = (t) => {
-  if (t.nativeEvent instanceof SubmitEvent && !(!(t.nativeEvent.submitter instanceof HTMLButtonElement) && // not button
-  !(t.nativeEvent.submitter instanceof HTMLInputElement)) && t.nativeEvent.submitter.name)
-    return [
-      t.nativeEvent.submitter.name,
-      t.nativeEvent.submitter.value
-    ];
-}, i = e;
-export {
-  i as default
-};

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

@@ -1,13 +0,0 @@
-import e from "react";
-const s = (t) => e.useCallback(
-  (r) => {
-    if (!t.current) throw new Error();
-    u(t.current, r);
-  },
-  [t]
-), u = (t, r) => {
-  t.requestSubmit(r);
-};
-export {
-  s as default
-};

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

@@ -1,8 +0,0 @@
-class t extends Error {
-  constructor(r, o) {
-    super(o), this.errors = r;
-  }
-}
-export {
-  t as FormSubmitError
-};

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

@@ -1,12 +0,0 @@
-const s = (r, t) => {
-  Object.entries(t).forEach(([e, o]) => {
-    r.setError(e, {
-      type: "FormSubmitFieldError",
-      // default
-      ...o
-    });
-  });
-};
-export {
-  s as default
-};

package/dist/esm/submit/useFormOnSubmitted.mjs

@@ -1,12 +0,0 @@
-import u from "react";
-import { useFormState as o } from "react-hook-form";
-import m from "../utils/useRefIfValueWasTrue.mjs";
-const c = (e, f) => {
-  const { isSubmitSuccessful: i, isSubmitting: t } = o(), [r, s] = m(t);
-  u.useEffect(() => {
-    e && (t || r && (s(), e(i)));
-  }, [t]);
-};
-export {
-  c as default
-};

package/dist/esm/submit/useResetFormOnSubmitted.mjs

@@ -1,36 +0,0 @@
-import { useFormContext as n } from "react-hook-form";
-import i from "./useFormOnSubmitted.mjs";
-const p = (e) => {
-  const { getValues: s, reset: o } = n();
-  i((m) => {
-    var u;
-    if (!e) return;
-    const t = (u = e[m ? "success" : "error"]) == null ? void 0 : u.values;
-    if (!t) return;
-    const r = t === "current", c = r ? s() : void 0;
-    o(c, {
-      // keep submit stuff for tracking relevant state (e.g., `useFormOnSubmitSuccessful`)
-      keepIsSubmitSuccessful: !0,
-      keepIsSubmitted: !0,
-      keepSubmitCount: !0,
-      /**
-       * This is necessary when setting default values to current values (lest form stop updating).
-       *
-       * Technically, we are keeping values and resetting default values to same values.
-       *
-       * Steps to repro:
-       * - RhfUtilsClientConfig with resetOnSubmitted set to success values to current
-       * - remove `keepValues` prop from reset
-       * - create valid form, submit
-       * - form values should be unchanged
-       * - unexpectedly: can no longer type into input
-       */
-      keepValues: r,
-      // keep errors in the case of unsuccessful submit
-      keepErrors: !0
-    });
-  });
-};
-export {
-  p as default
-};

package/dist/esm/submit/useSubmitFormOnChange.mjs

@@ -1,26 +0,0 @@
-import d from "react";
-import b from "../form/utils/useFormRequestSubmit.mjs";
-import { useDebouncedOnChangeValue as h } from "../utils/useDebouncedOnChangeValue.mjs";
-const l = (n, e) => {
-  const u = !(e != null && e.disabled), a = b(n), [c] = h({
-    // on change value after debounce
-    onChange: () => {
-      a();
-    },
-    delay: (e == null ? void 0 : e.debounce) ?? 0
-  });
-  d.useEffect(() => {
-    if (!u) return;
-    const r = n.current;
-    if (!r) throw new Error();
-    const t = (m) => {
-      c(m);
-    };
-    return r.addEventListener("change", t), () => {
-      r.removeEventListener("change", t);
-    };
-  }, []);
-};
-export {
-  l as default
-};

package/dist/esm/utils/PassthroughChildren.mjs

@@ -1,7 +0,0 @@
-import { jsx as t, Fragment as o } from "react/jsx-runtime";
-const a = ({
-  children: r
-}) => /* @__PURE__ */ t(o, { children: r });
-export {
-  a as default
-};

package/dist/esm/utils/isEmptyObject.mjs

@@ -1,4 +0,0 @@
-const e = (t) => Object.keys(t).length === 0;
-export {
-  e as default
-};

package/dist/esm/utils/useDebouncedOnChangeValue.mjs

@@ -1,26 +0,0 @@
-import r from "react";
-const a = ({
-  onChange: u,
-  delay: n
-}) => {
-  const e = r.useRef(), c = () => {
-    e.current && (u(e.current.value), e.current = void 0);
-  }, t = () => {
-    e.current && clearTimeout(e.current.timer);
-  };
-  return r.useEffect(
-    // return timeout clearer
-    () => t,
-    []
-  ), [(o) => {
-    t(), e.current = {
-      // value being tracked
-      value: o,
-      // new timer
-      timer: setTimeout(c, n)
-    };
-  }];
-};
-export {
-  a as useDebouncedOnChangeValue
-};

package/dist/esm/utils/useRefIfValueWasTrue.mjs

@@ -1,14 +0,0 @@
-import t from "react";
-const f = (r) => {
-  const e = t.useRef(!1);
-  t.useEffect(() => {
-    r && (e.current = !0);
-  }, [r]);
-  const s = () => {
-    e.current = !1;
-  };
-  return [e.current, s];
-};
-export {
-  f as default
-};

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

@@ -1,71 +0,0 @@
-import { UseFormProps } from 'react-hook-form';
-import { FlatFieldErrorsOutputConfig } from '../../errors/flat/context/FlatFieldErrorsOutputConfig';
-import { RhfUtilsFormOptions } from '../../form/RhfUtilsFormOptions';
-import { UseRhfUtilsFormChildrenProps } from '../../form/UseRhfUtilsFormChildrenProps';
-import { FormSubmitFieldErrors } from '../../submit/error/FormSubmitFieldErrors';
-
-/**
- * Client configuration object.
- *
- * Options under `defaults` can be overridden at form level.
- */
-export type RhfUtilsClientConfig = {
-    /**
-     * Default options for all forms. (Are overridden by form-specific options.)
-     */
-    defaults?: {
-        /**
-         * Default RHF `useForm` settings.
-         *
-         * (Exposes only non-local props.)
-         */
-        rhf?: Pick<UseFormProps, 'mode' | 'reValidateMode' | 'resetOptions' | 'context' | 'shouldFocusError' | 'shouldUnregister' | 'shouldUseNativeValidation' | 'progressive' | 'criteriaMode' | 'delayError'>;
-        /**
-         * Global settings and defaults.
-         *
-         * (Extend this type via `Register` type to inject custom options/functionality via `Children` component.)
-         */
-        utils?: RhfUtilsFormOptions;
-        /**
-         * Default props for form element.
-         */
-        form?: Omit<React.PropsWithoutRef<JSX.IntrinsicElements['form']>, 'onSubmit'>;
-    };
-    /**
-     * Supply your own `<form>` component.
-     *
-     * By default, a primitive `<form>` element is used.
-     */
-    FormComponent?: React.FC<React.PropsWithChildren<React.HTMLAttributes<HTMLFormElement>>>;
-    /**
-     * Wrap all form bodies with your own hooks, components, etc.
-     *
-     * (NOTE: not schema-typed as not possible at this level)
-     *
-     * Use cases:
-     * - custom hooks/behaviors based on `options`
-     * - shared header, footer
-     */
-    FormChildrenWrapper?: (props: RhfUtilsFormChildrenWrapperProps) => React.ReactNode;
-    /**
-     * Global submit error handler when/if submit handler throws an error other than {@link FormSubmitError}.
-     *
-     * Example use case:
-     * - transform API errors to {@link FormSubmitFieldErrors}.
-     *
-     * @returns
-     * - if {@link FormSubmitFieldErrors}: merge into context errors.
-     * - if `undefined`: do nothing.
-     */
-    onSubmitErrorUnknown?: (error: unknown) => FormSubmitFieldErrors | undefined;
-    fieldErrors?: {
-        /**
-         * Configure how/if errors should be outputted.
-         */
-        output?: FlatFieldErrorsOutputConfig;
-    };
-};
-/**
- * Non-schema-typed version of `UseRhfUtilsFormChildrenProps` for global config.
- */
-export type RhfUtilsFormChildrenWrapperProps = React.PropsWithChildren<UseRhfUtilsFormChildrenProps>;