@paragrav/rhf-utils 0.0.133 → 0.0.135

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present paragrav.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,20 +4,27 @@
 
 Integration and utility library for [react-hook-form](https://www.react-hook-form.com/).
 
-If you have multiple forms and would like a more declarative API to manage their behavior (via built-in and custom options), including transformation of backend errors, and debugging logging/errors.
+If you have multiple forms and would like a more declarative API to manage their behavior via global and form-level options, including transformation of backend errors, and debugging field errors.
 
 ## Features
 
 - built with and for [TypeScript](https://www.typescriptlang.org/)
-- global and form-specific configuration/options
-  - with support for extendable options
+- global configuration, such as:
+  - injecting your own hooks and UI (`FormChildrenWrapper`)
+  - server error transformation (`onSubmitErrorUnknown`)
+  - FieldErrors logging/throwing (`RhfUtilsClientConfig.FieldErrors`)
+  - extendable options type (`RhfUtilsFormOptions`)
+- form-specific overrides
 - schema-typed Controller component
 - schema-typed FormSubmitError class
-- safer `FieldValues` type (i.e., `SafeFieldValues`)
-- flatter `FieldErrors` structure (i.e., `FlatFieldErrors`)
+  - throw in submit handler to add errors to RHF context and fail submit
+- simpler/flatter `FieldErrors` structure (`FlatFieldErrors`)
+  - context groups errors into `all`, `fields`, `roots`, and `orphans` (`useFlatFieldErrorsContext`)
+  - `FormErrorMessageByPath` for displaying error message
 - `zod` support
-  - includes distinction between `z.input` and `z.output` types for transformations support
-- 3.3kB gzip core functionality (excluding [peer dependencies](#peer-dependencies))
+  - including input/output types for transformations
+- safer `FieldValues` type (`SafeFieldValues`)
+- 3.3kB min+gzip core functionality (excluding [peer dependencies](#peer-dependencies))
 
 ## Install
 
@@ -65,8 +72,8 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
       formRef, //         ref
       context, //         rhf UseFormReturn
       options, //         RhfUtilsFormOptions (with any custom props)
-      Controller, //      strictly-typed rhf controller
-      FormSubmitError, // strictly-typed error class
+      Controller, //      rhf controller (SafeFieldValues-typed; no schema at this level)
+      FormSubmitError, // error class (SafeFieldValues-typed; no schema at this level)
       children, //        RhfUtilsZodForm's Children instance
     },
   ) => {
@@ -147,7 +154,7 @@ Currently, only `zod` is supported.
   // submit handler
   onSubmit={async (
     data, //    schema output
-    context, // UseRhfUtilsFormOnSubmitContext (id, ref, rhf context, utils options, strictly-typed FormSubmitError class)
+    context, // UseRhfUtilsFormOnSubmitContext (id, ref, rhf context, utils options, schema-typed FormSubmitError class)
     event, //   SubmitEvent
   ) => {
     await loginService(data);
@@ -168,12 +175,12 @@ Currently, only `zod` is supported.
     formRef, //         ref
     context, //         rhf UseFormReturn
     options, //         RhfUtilsFormOptions
-    Controller, //      strictly-typed rhf controller
-    FormSubmitError, // strictly-typed error class
+    Controller, //      schema-typed rhf controller
+    FormSubmitError, // schema-typed error class
   }) => (
     <>
       <Controller
-        name="email" // strictly-typed field name
+        name="email" // schema-typed field name
         render={({ field, formState: { isSubmitting } }) => (
           <label>
             Email
@@ -214,12 +221,12 @@ Currently, only `zod` is supported.
 If you prefer to define your `Children` component as standalone:
 
 ```tsx
-const Children: RhfUtilsUseFormChildrenZodFC<typeof schema> = ({ ... }) => { };
+const Children: RhfUtilsUseFormChildrenZodFC<typeof schema> = ({...}) => { };
 
 function Children({...}: RhfUtilsUseFormChildrenZodProps<typeof schema>) { }
 ```
 
-## Component Hierarchy
+## Form Component Hierarchy
 
 ```tsx
 <ReactHookForm.FormProvider>
@@ -235,9 +242,9 @@ function Children({...}: RhfUtilsUseFormChildrenZodProps<typeof schema>) { }
 
 ## `FormSubmitError`
 
-This is an `Error`-based class you can use to throw a structured error in your submit handler. It is strictly-typed, so it only allows field names from your schema and `root`/`root.{string}` keys.
+This is an extended `Error` class that you can use to throw a structured error in your submit handler. It uses `FormSubmitErrors` (with an "s") type's structure, which is a flat, simplified version of RHF's `FieldErrors`.
 
-It uses `FormSubmitErrors` type's structure, which is a flat, simplified version of RHF's `FieldErrors`.
+It differs from `FlatFieldError` only in that it is narrower. Namely, it is schema-typed, so it allows field names from your schema and `root.${string}` keys. And only `type` (optional) and `message` props for error.
 
 Example:
 
@@ -255,7 +262,7 @@ Example:
 />
 ```
 
-Any non-`FormSubmitError`s thrown from submit handler (e.g., fetch/axios error) can be transformed by `RhfUtilsClientConfig`'s `onSubmitErrorUnknown` callback. This takes an `unknown` error and can return a `FormSubmitErrors` object, which is merged in RHF's context errors.
+Any non-`FormSubmitError` error thrown from your submit handler (e.g., fetch/axios error) can be transformed by `RhfUtilsClientConfig`'s `onSubmitErrorUnknown` callback. This takes an `unknown` error and can return a `FormSubmitErrors` object, which is merged into RHF's form state errors.
 
 Most common use case will be transforming backend errors to frontend shape. (You can use `getOnSubmitTrpcClientErrorHandler` HOF provided by this library for TRPC backends.)
 
@@ -265,7 +272,7 @@ These options can be set globally and/or per form.
 
 ```ts
 type RhfUtilsFormOptions = {
-  /** Stop propagation of submit event. Useful for portals. */
+  /** Stop propagation of submit event. */
   stopSubmitPropagation?: boolean;
 
   /** Request submit via listener on form change. */
@@ -286,7 +293,7 @@ type RhfUtilsFormOptions = {
 };
 ```
 
-If you need access to options deeper in component structure, use `useRhfUtilsContext` to receive `RhfUtilsContext` object, which includes `formId`, `formRef`, and `options` settings.
+If you need access to options deeper in your component structure, use `useRhfUtilsContext` to receive `RhfUtilsContext` object, which includes `formId`, `formRef`, and `options` settings.
 
 Use `useRhfUtilsContextRequestSubmit` hook to get `requestSubmit` function for current form ref in context. This is useful when you need to trigger form submission programatically.
 
@@ -307,39 +314,56 @@ declare module '@paragrav/rhf-utils' {
 }
 ```
 
-## Errors
+## Field Errors
 
-You can configure via `RhfUtilsClientConfig` (example at the top) when form context errors are outputted -- i.e., via console and/or thrown error.
+### FlatFieldErrors
+
+`FlatFieldErrors` type is a flattened, simplified version of RHF's `FieldErrors`. Keys represent flattened, dot-notation field paths.
 
 Use `useFlatFieldErrorsContext()` hook, which returns an object with errors grouped by `all`, `fields`, `roots`, `orphans` records, and `hasErrors` and `hasErrors` and `hasOrphans` booleans.
 
-`FlatFieldErrors` type is a flattened, simplified version of RHF's `FieldErrors`. Keys represent flattened, dot-notation field paths.
+### Output
+
+For the purposes of debugging and/or logging, you can configure when form state errors are outputted (i.e., console log and/or thrown) via `RhfUtilsClientConfig` (example at the top).
 
 ### Orphan Errors
 
-The concept of orphan errors is any error that is not being shown to user. An example would be a stray field in a schema that is prohibiting users from successfully submitting a form.
+The concept of "orphan" errors is any field error that is not being shown to user. (For example, a field in a schema that is prohibiting users from submitting a valid form.)
 
-The criteria for an orphan is any form context error that meets all of the following criteria:
+More technically, an "orphan" is any form state error that meets ALL of the following criteria:
 
-- not a root error -- e.g., `root` or `root.${string}`
-- has no `ref` -- RHF includes `ref` to the associated input on each error object (when applicable)
-- has no marker in DOM (e.g., `FormNonFieldErrorMarker`)
+- not a root error -- i.e., `root` and `root.${string}` paths
+  - these are assumed to be listed for users somewhere
+- has no `ref` -- RHF includes `ref` to the associated input for each error (when applicable)
+  - these are assumed to be shown next to their input fields
+- has no marker in DOM (i.e., `FormNonFieldErrorMarker`)
+  - see section further below for more information
 
-To get accurate orphan analysis, you must either use `FormNonFieldErrorMarker` in any error you are displaying to user that is not "root" and doesn't have a `ref`. (There is no harm in using this consistently across all errors, even those expected to have a ref.)
+Detected orphans can be accessed via any of the following:
 
-Alternatively, you can use `FormErrorMessageByPath` to display error message to user:
+- via `RhfUtilsClientConfig.FieldErrors.output`; e.g.:
+  - console log to facilitate debugging on development
+  - console error to facilitate reporting on production (via your own error reporting service)
+  - throw error for developer during development
+- `useFlatFieldErrorsContext()` hook
+  - returns an object with list of errors grouped by `all`, `fields` (with `ref`), `roots`, `orphans` records, and includes computed booleans `hasErrors` and `hasOrphans`
+- boolean value from `useFlatFieldErrorsContextHasOnlyOrphans`
 
-```tsx
-<FormErrorMessageByPath path="street.address" />
-```
+### FormNonFieldErrorMarker
 
-Example use case: Field array with minimum items. When there are no items, the error is not associated with a field and is displayed separately.
+To get accurate orphan detection, you must use `FormNonFieldErrorMarker` in all errors you are displaying to user. (Technically, "root" errors and field errors with a `ref` do not need the marker, because those do not match the first two criteria of an orphan (as listed above). But there is no harm in including it consistently for all error displayed.)
 
-Orphans are exposed in a few places.
+#### When is the marker required?
 
-- In errors outputted via console. (Configurable via `RhfUtilsClientConfig['errors']['output']`.)
-- And `useFlatFieldErrorsContext()` hook, which returns an object with errors grouped by `all`, `fields`, `roots`, `orphans` records, and `hasErrors` and `hasOrphans` boolean.
-- Boolean value from `useFlatFieldErrorsContextHasOnlyOrphans`.
+For example, a field array with a minimum number of items -- e.g., `items: z.array(...).min(1)`.
+
+When there are zero items, the error is not "root" and is not associated with a specific field. Therefore, in order to NOT detect this as an orphan, it must be "marked" as displayed using `FormNonFieldErrorMarker`.
+
+You can incorporate `FormNonFieldErrorMarker` into your own component library, or use this library's `FormErrorMessageByPath` to display error message to user, which includes this marker.
+
+```tsx
+<FormErrorMessageByPath path="items" />
+```
 
 ## Form Groups
 

package/dist/esm/client/utils.mjs

@@ -1,30 +1,39 @@
-const i = (l, ...t) => (
+const u = (n, ...r) => (
   // sequentially merge each set of props into defaults
-  t.reduce(
-    (s, e) => {
-      var f, o;
+  r.reduce(
+    (t, e) => {
+      var s, i, l, m, o, f;
       return {
         rhf: {
-          ...s == null ? void 0 : s.rhf,
+          ...t == null ? void 0 : t.rhf,
           ...e.rhf
         },
         utils: {
-          ...s == null ? void 0 : s.utils,
-          ...e.utils
+          ...t == null ? void 0 : t.utils,
+          ...e.utils,
+          // manual merges
+          // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- false positive
+          ...(((s = t == null ? void 0 : t.utils) == null ? void 0 : s.resetOnSubmitted) || ((i = e.utils) == null ? void 0 : i.resetOnSubmitted)) && {
+            resetOnSubmitted: {
+              ...(l = t == null ? void 0 : t.utils) == null ? void 0 : l.resetOnSubmitted,
+              ...(m = e.utils) == null ? void 0 : m.resetOnSubmitted
+            }
+          }
         },
         form: {
-          ...s == null ? void 0 : s.form,
+          ...t == null ? void 0 : t.form,
           ...e.form,
-          className: [(f = s == null ? void 0 : s.form) == null ? void 0 : f.className, (o = e.form) == null ? void 0 : o.className].filter(Boolean).join(" ")
-          // stringify
+          // manual merges
+          className: [(o = t == null ? void 0 : t.form) == null ? void 0 : o.className, (f = e.form) == null ? void 0 : f.className].filter(Boolean).join(" ") || void 0
+          // stringify (replace empty string with undefined)
         }
       };
     },
     // start with defaults
-    l
+    n
   )
 );
 export {
-  i as mergeRhfUtilsClientConfigDefaultsWithUseRhfUtilsFormProps
+  u as mergeRhfUtilsClientConfigDefaultsWithUseRhfUtilsFormProps
 };
 //# sourceMappingURL=utils.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sources":["../../../src/client/utils.ts"],"sourcesContent":["import type { RhfUtilsFormOptions } from '@/form/RhfUtilsFormOptions';\nimport type { SafeFieldValues } from '@/form/SafeFieldValues';\nimport type { UseRhfUtilsFormProps } from '@/form/UseRhfUtilsFormProps';\n\nimport type { RhfUtilsClientConfig } from './config/RhfUtilsClientConfig';\n\n/**\n * Merge {@link RhfUtilsClientConfig.defaults} with array of {@link UseRhfUtilsFormProps}'s overrides.\n */\nexport const mergeRhfUtilsClientConfigDefaultsWithUseRhfUtilsFormProps = <\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>(\n  defaults: RhfUtilsClientConfig['defaults'],\n  ...props: Pick<\n    UseRhfUtilsFormProps<TFieldValues, TTransformedValues>,\n    'rhf' | 'utils' | 'form'\n  >[]\n) =>\n  // sequentially merge each set of props into defaults\n  props.reduce(\n    (acc, curr) => ({\n      rhf: {\n        ...acc?.rhf,\n        ...curr.rhf,\n      },\n\n      utils: {\n        ...acc?.utils,\n        ...curr.utils,\n      } satisfies RhfUtilsFormOptions,\n\n      form: {\n        ...acc?.form,\n        ...curr.form,\n        className: [acc?.form?.className, curr.form?.className]\n          .filter(Boolean) // filter out falsy values\n          .join(' '), // stringify\n      },\n    }),\n\n    // start with defaults\n    defaults,\n  );\n"],"names":["mergeRhfUtilsClientConfigDefaultsWithUseRhfUtilsFormProps","defaults","props","acc","curr","_a","_b"],"mappings":"AASa,MAAAA,IAA4D,CAIvEC,MACGC;AAAA;AAAA,EAMHA,EAAM;AAAA,IACJ,CAACC,GAAKC,MAAU;AAZP,UAAAC,GAAAC;AAYO;AAAA,QACd,KAAK;AAAA,UACH,GAAGH,KAAA,gBAAAA,EAAK;AAAA,UACR,GAAGC,EAAK;AAAA,QACV;AAAA,QAEA,OAAO;AAAA,UACL,GAAGD,KAAA,gBAAAA,EAAK;AAAA,UACR,GAAGC,EAAK;AAAA,QACV;AAAA,QAEA,MAAM;AAAA,UACJ,GAAGD,KAAA,gBAAAA,EAAK;AAAA,UACR,GAAGC,EAAK;AAAA,UACR,WAAW,EAACC,IAAAF,KAAA,gBAAAA,EAAK,SAAL,gBAAAE,EAAW,YAAWC,IAAAF,EAAK,SAAL,gBAAAE,EAAW,SAAS,EACnD,OAAO,OAAO,EACd,KAAK,GAAG;AAAA;AAAA,QACb;AAAA,MAAA;AAAA;AAAA;AAAA,IAIFL;AAAA,EACF;AAAA;"}
+{"version":3,"file":"utils.mjs","sources":["../../../src/client/utils.ts"],"sourcesContent":["import type { RhfUtilsFormOptions } from '@/form/RhfUtilsFormOptions';\nimport type { SafeFieldValues } from '@/form/SafeFieldValues';\nimport type { UseRhfUtilsFormProps } from '@/form/UseRhfUtilsFormProps';\n\nimport type { RhfUtilsClientConfig } from './config/RhfUtilsClientConfig';\n\n/**\n * Merge {@link RhfUtilsClientConfig.defaults} with array of {@link UseRhfUtilsFormProps}'s overrides.\n */\nexport const mergeRhfUtilsClientConfigDefaultsWithUseRhfUtilsFormProps = <\n  TFieldValues extends SafeFieldValues,\n  TTransformedValues extends SafeFieldValues,\n>(\n  defaults: RhfUtilsClientConfig['defaults'],\n  ...props: Pick<\n    UseRhfUtilsFormProps<TFieldValues, TTransformedValues>,\n    'rhf' | 'utils' | 'form'\n  >[]\n) =>\n  // sequentially merge each set of props into defaults\n  props.reduce(\n    (acc, curr) => ({\n      rhf: {\n        ...acc?.rhf,\n        ...curr.rhf,\n      },\n\n      utils: {\n        ...acc?.utils,\n        ...curr.utils,\n\n        // manual merges\n\n        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- false positive\n        ...((acc?.utils?.resetOnSubmitted || curr.utils?.resetOnSubmitted) && {\n          resetOnSubmitted: {\n            ...acc?.utils?.resetOnSubmitted,\n            ...curr.utils?.resetOnSubmitted,\n          },\n        }),\n      } satisfies RhfUtilsFormOptions,\n\n      form: {\n        ...acc?.form,\n        ...curr.form,\n\n        // manual merges\n\n        className:\n          [acc?.form?.className, curr.form?.className]\n            .filter(Boolean) // filter out falsy values\n            .join(' ') || undefined, // stringify (replace empty string with undefined)\n      },\n    }),\n\n    // start with defaults\n    defaults,\n  );\n"],"names":["mergeRhfUtilsClientConfigDefaultsWithUseRhfUtilsFormProps","defaults","props","acc","curr","_a","_b","_c","_d","_e","_f"],"mappings":"AASa,MAAAA,IAA4D,CAIvEC,MACGC;AAAA;AAAA,EAMHA,EAAM;AAAA,IACJ,CAACC,GAAKC,MAAU;AAZP,UAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;AAYO;AAAA,QACd,KAAK;AAAA,UACH,GAAGP,KAAA,gBAAAA,EAAK;AAAA,UACR,GAAGC,EAAK;AAAA,QACV;AAAA,QAEA,OAAO;AAAA,UACL,GAAGD,KAAA,gBAAAA,EAAK;AAAA,UACR,GAAGC,EAAK;AAAA;AAAA;AAAA,UAKR,MAAKC,IAAAF,KAAA,gBAAAA,EAAK,UAAL,gBAAAE,EAAY,uBAAoBC,IAAAF,EAAK,UAAL,gBAAAE,EAAY,sBAAqB;AAAA,YACpE,kBAAkB;AAAA,cAChB,IAAGC,IAAAJ,KAAA,gBAAAA,EAAK,UAAL,gBAAAI,EAAY;AAAA,cACf,IAAGC,IAAAJ,EAAK,UAAL,gBAAAI,EAAY;AAAA,YACjB;AAAA,UACF;AAAA,QACF;AAAA,QAEA,MAAM;AAAA,UACJ,GAAGL,KAAA,gBAAAA,EAAK;AAAA,UACR,GAAGC,EAAK;AAAA;AAAA,UAIR,WACE,EAACK,IAAAN,KAAA,gBAAAA,EAAK,SAAL,gBAAAM,EAAW,YAAWC,IAAAN,EAAK,SAAL,gBAAAM,EAAW,SAAS,EACxC,OAAO,OAAO,EACd,KAAK,GAAG,KAAK;AAAA;AAAA,QACpB;AAAA,MAAA;AAAA;AAAA;AAAA,IAIFT;AAAA,EACF;AAAA;"}

package/dist/esm/errors/message/FormErrorMessageByPath.mjs

@@ -5,8 +5,8 @@ import c from "./FormErrorMessage.mjs";
 const f = ({ path: o, Component: s }) => {
   const { errors: t } = g(), r = i(t, o, void 0), m = s ?? c;
   return r != null && r.message ? /* @__PURE__ */ n(a, { children: [
-    /* @__PURE__ */ e(F, { path: o }),
-    /* @__PURE__ */ e(m, { message: r.message })
+    /* @__PURE__ */ e(m, { message: r.message }),
+    /* @__PURE__ */ e(F, { path: o })
   ] }) : null;
 }, E = f;
 export {

package/dist/esm/errors/message/FormErrorMessageByPath.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"FormErrorMessageByPath.mjs","sources":["../../../../src/errors/message/FormErrorMessageByPath.tsx"],"sourcesContent":["import type { FieldError } from 'react-hook-form';\nimport { get, useFormState } from 'react-hook-form';\n\nimport FormNonFieldErrorMarker from '../nonfield/FormNonFieldErrorMarker';\n\nimport FormErrorMessage from './FormErrorMessage';\n\ntype Props = {\n  /** Field name as flat path. (e.g., \"address.street\") */\n  path: string;\n  /** Optional component to use to display message. (Defaults to {@link FormErrorMessage}) */\n  Component?: React.FC<{ message: string }>;\n};\n\nconst FormErrorMessageByPath: React.FC<Props> = ({ path, Component }) => {\n  const { errors } = useFormState();\n\n  const error = get(errors, path, undefined) as FieldError | undefined;\n\n  const _Component = Component ?? FormErrorMessage;\n\n  if (!error?.message) return null;\n\n  return (\n    <>\n      {/* marker (only required for non-root non-field errors) */}\n      <FormNonFieldErrorMarker path={path} />\n\n      {/* error message */}\n      <_Component message={error.message} />\n    </>\n  );\n};\n\nexport default FormErrorMessageByPath;\n"],"names":["FormErrorMessageByPath","path","Component","errors","useFormState","error","get","_Component","FormErrorMessage","jsxs","Fragment","jsx","FormNonFieldErrorMarker","FormErrorMessageByPath$1"],"mappings":";;;;AAcA,MAAMA,IAA0C,CAAC,EAAE,MAAAC,GAAM,WAAAC,QAAgB;AACjE,QAAA,EAAE,QAAAC,MAAWC,KAEbC,IAAQC,EAAIH,GAAQF,GAAM,MAAS,GAEnCM,IAAaL,KAAaM;AAE5B,SAACH,KAAA,QAAAA,EAAO,UAKR,gBAAAI,EAAAC,GAAA,EAAA,UAAA;AAAA,IAAA,gBAAAC,EAACC,KAAwB,MAAAX,GAAY;AAAA,IAGpC,gBAAAU,EAAAJ,GAAA,EAAW,SAASF,EAAM,QAAS,CAAA;AAAA,EACtC,EAAA,CAAA,IAT0B;AAW9B,GAEAQ,IAAeb;"}
+{"version":3,"file":"FormErrorMessageByPath.mjs","sources":["../../../../src/errors/message/FormErrorMessageByPath.tsx"],"sourcesContent":["import type { FieldError } from 'react-hook-form';\nimport { get, useFormState } from 'react-hook-form';\n\nimport FormNonFieldErrorMarker from '../nonfield/FormNonFieldErrorMarker';\n\nimport FormErrorMessage from './FormErrorMessage';\n\ntype Props = {\n  /** Field name as flat path. (e.g., \"address.street\") */\n  path: string;\n  /** Optional component to use to display message. (Defaults to {@link FormErrorMessage}) */\n  Component?: React.FC<{ message: string }>;\n};\n\nconst FormErrorMessageByPath: React.FC<Props> = ({ path, Component }) => {\n  const { errors } = useFormState();\n\n  const error = get(errors, path, undefined) as FieldError | undefined;\n\n  const _Component = Component ?? FormErrorMessage;\n\n  if (!error?.message) return null;\n\n  return (\n    <>\n      {/* error message */}\n      <_Component message={error.message} />\n\n      {/* marker (only required for non-root non-field errors) */}\n      <FormNonFieldErrorMarker path={path} />\n    </>\n  );\n};\n\nexport default FormErrorMessageByPath;\n"],"names":["FormErrorMessageByPath","path","Component","errors","useFormState","error","get","_Component","FormErrorMessage","jsxs","Fragment","jsx","FormNonFieldErrorMarker","FormErrorMessageByPath$1"],"mappings":";;;;AAcA,MAAMA,IAA0C,CAAC,EAAE,MAAAC,GAAM,WAAAC,QAAgB;AACjE,QAAA,EAAE,QAAAC,MAAWC,KAEbC,IAAQC,EAAIH,GAAQF,GAAM,MAAS,GAEnCM,IAAaL,KAAaM;AAE5B,SAACH,KAAA,QAAAA,EAAO,UAKR,gBAAAI,EAAAC,GAAA,EAAA,UAAA;AAAA,IAAC,gBAAAC,EAAAJ,GAAA,EAAW,SAASF,EAAM,QAAS,CAAA;AAAA,IAGpC,gBAAAM,EAACC,KAAwB,MAAAX,GAAY;AAAA,EACvC,EAAA,CAAA,IAT0B;AAW9B,GAEAY,IAAeb;"}

package/dist/esm/form/Form.mjs

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

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

@@ -1 +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;"}
+{"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 type { RhfUtilsFormChildrenWrapperProps } from '@/client/config/RhfUtilsClientConfig';\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  // children wrapper is not specific to schema (not possible)\n  const childrenWrapperProps =\n    childrenProps as RhfUtilsFormChildrenWrapperProps;\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 {...childrenWrapperProps}>\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","childrenWrapperProps","FormComponent","FormChildrenWrapper","PassthroughChildren","jsx","e","jsxs","LazyDevTool"],"mappings":";;;;;;;;;AA2CA,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,GAIIM,IACJF,GAEIG,KAAgBf,KAAA,gBAAAA,EAAQ,kBAAiB,QAEzCgB,KACJhB,KAAA,gBAAAA,EAAQ,wBAAuBiB;AAG/B,SAAA,gBAAAC;AAAA,IAACH;AAAA,IAAA;AAAA,MACE,GAAGnB;AAAA,MACJ,KAAKL;AAAA,MACL,UAAU,CAAC4B,MAAM,KAAKjB,EAAaiB,CAAC;AAAA,MAEpC,UAAA,gBAAAC,EAACJ,GAAqB,EAAA,GAAGF,GACtB,UAAA;AAAA,SAAAjB,KAAA,gBAAAA,EAAO,YACN,gBAAAqB;AAAA,UAACG;AAAA,UAAA;AAAA,YACC,OACE,OAAOxB,EAAM,WAAY,WAAWA,EAAM,UAAU;AAAA,UAAA;AAAA,QAExD;AAAA,QAGF,gBAAAqB,EAACvB,GAAU,EAAA,GAAGiB,GAAe;AAAA,MAAA,GAC/B;AAAA,IAAA;AAAA,EAAA;AAGN;"}

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

@@ -1,7 +1,6 @@
 import { UseFormProps } from 'react-hook-form';
 import { FlatFieldErrorsOutputConfig } from '../../errors/flat/context/FlatFieldErrorsOutputConfig';
 import { RhfUtilsFormOptions } from '../../form/RhfUtilsFormOptions';
-import { SafeFieldValues } from '../../form/SafeFieldValues';
 import { UseRhfUtilsFormChildrenProps } from '../../form/UseRhfUtilsFormChildrenProps';
 import { FormSubmitErrors } from '../../submit/error/FormSubmitErrors';
 
@@ -41,11 +40,13 @@ export type RhfUtilsClientConfig = {
     /**
      * 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?: <TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>(props: React.PropsWithChildren<UseRhfUtilsFormChildrenProps<TFieldValues, TTransformedValues>>) => React.ReactNode;
+    FormChildrenWrapper?: (props: RhfUtilsFormChildrenWrapperProps) => React.ReactNode;
     /**
      * Global submit error handler when/if submit handler throws an error other than {@link FormSubmitError}.
      *
@@ -64,3 +65,7 @@ export type RhfUtilsClientConfig = {
         output?: FlatFieldErrorsOutputConfig;
     };
 };
+/**
+ * Non-schema-typed version of `UseRhfUtilsFormChildrenProps` for global config.
+ */
+export type RhfUtilsFormChildrenWrapperProps = React.PropsWithChildren<UseRhfUtilsFormChildrenProps>;

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

@@ -8,7 +8,7 @@ import { Register } from '../register';
  * Can be extended using {@link Register.RhfUtilsFormOptions}.
  */
 export type RhfUtilsFormOptions = {
-    /** Stop propagation of submit event. Useful for portals. */
+    /** Stop propagation of submit event. */
     stopSubmitPropagation?: boolean;
     /** Request submit via listener on form change. */
     submitOnChange?: boolean;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
   "license": "MIT",
-  "version": "0.0.133",
+  "version": "0.0.135",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -30,6 +30,10 @@
     "react-hook-form": "7",
     "zod": "3"
   },
+  "resolutions": {
+    "@playwright/experimental-ct-react": "1.44.1",
+    "@playwright/test": "1.44.1"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/paragrav/rhf-utils.git"