@paragrav/rhf-utils 0.72.0 → 0.74.0

package/README.md

@@ -9,18 +9,23 @@ Integration and utility library for [react-hook-form](https://www.react-hook-for
 - TypeScript-first
 - global configuration (🔗 [`RhfUtilsClientConfig`](#config) section)
   - RHF (`UseFormProps`) and utilities (`RhfUtilsFormOptions`) options defaults
-  - inject your own hooks and UI (`FormInjector`)
+  - inject your own hooks and UI (`useFormHooks`, `FormOutlet`) ✨
   - server error transformation (`onSubmitErrorUnknown`) ✨
   - handle cancel prompt (`useCanFormBeCancelled`) ✨
   - RHF `FormState.errors` logging/throwing (`RhfUtilsClientConfig.fieldErrors`) ✨
 - form-level configuration (🔗 [`RhfUtilsZodForm`](#form-with-providers) section)
   - RHF and utilities options overrides
-    - extendable utilities options type (`RhfUtilsFormOptions`)
   - throw error (`FormSubmitError`) in submit handler to add errors to RHF context and fail submit
   - handle submit error (`onSubmitError` / `useLastSubmitError`)
   - context injection for children (`RhfUtilsZodForm.Children`), including:
-    - formId, formRef, RHF context, utilities options
+    - `RhfUtilsContext` (see section below)
     - schema-typed Controller component and FormSubmitError class
+    - RHF context
+- options (🔗 [`RhfUtilsFormOptions`](#rhfutilsformoptions) section) ✨
+  - extend with your own per-form options (e.g., `enableMyPrompter`)
+- context (🔗 [`RhfUtilsContext`](#rhfutilscontext) section) ✨
+  - use `useRhfUtilsContext` to access options in your hook/component structure
+    - `formId`, `formRef`, `options`
 - form state relay (🔗 [`FormRelayContextProvider`](#form-state-relay) section) ✨
   - access specific form's state from outside that form/provider
   - assign forms into groups and watch collectively
@@ -41,10 +46,12 @@ yarn add @paragrav/rhf-utils     # yarn
 
 ## Quick Start
 
-- 🔗 [Config](#config) (`RhfUtilsClientConfig`): define your global config (optional)
-  - 🔗 [Provider](#config-provider) (`RhfUtilsClientConfigProvider`): add to your global stack
-- 🔗 [Form With Providers](#form-with-providers) (`RhfUtilsZodFormWithProviders`): use as form component
-- 🔗 [Form State Relay](#form-state-relay) (`FormRelayContextProvider`): relay form state
+- 🔗 [Config](#config) (`RhfUtilsClientConfig`) - define your global config (optional)
+  - 🔗 [Provider](#config-provider) (`RhfUtilsClientConfigProvider`) - add to your global stack
+- 🔗 [Form With Providers](#form-with-providers) (`RhfUtilsZodFormWithProviders`) - use as form component
+- 🔗 [Options](#rhfutilsformoptions) (`RhfUtilsFormOptions`) - global, per-form flags
+- 🔗 [Context](#rhfutilscontext) (`RhfUtilsContext`) - utils context
+- 🔗 [Form State Relay](#form-state-relay) (`FormRelayContextProvider`) - relay form state
 
 ## Config
 
@@ -74,22 +81,17 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
   // optional form component to use (defaults to primitive HTML form)
   FormComponent: Form.Root,
 
-  // inject your own hooks and components
-  // into all RhfUtilsZodForm instances
-  FormInjector: (
-    // RhfUtilsFormInjectorProps
+  // inject your hooks across all RhfUtilsZodForm instances
+  useFormHooks: (
+    // RhfUtilsClientConfigUseFormHooksProps
     {
-      Outlet, //          Form instance (RhfUtilsZodForm.Children) "outlet"
-
-      formId, //          unique id string
-      formRef, //         form element ref
-      context, //         rhf UseFormReturn (without proxy `formState`)
-      options, //         RhfUtilsFormOptions (with any custom props)
-      Controller, //      rhf controller (SafeFieldValues-typed; no schema at this level)
-      FormSubmitError, // error class (SafeFieldValues-typed; no schema at this level)
+      formId, //              unique id string
+      formRef, //             form element ref
+      options, //             RhfUtilsFormOptions (with any custom props)
+      lastSubmit, //          last submit state (see "Last Submit" section)
+      rhf, //                 rhf UseFormReturn (without proxy `formState`)
     },
   ) => {
-    // hook injected across all instances
     useMyGlobalFormHook();
 
     // hook injected across all instances with per-instance opt-in flag via custom option props
@@ -97,17 +99,31 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
     useMyOptionalFormHook({
       enabled: !!options.enableMyOptionalFormHook,
     });
+  },
 
-    return (
-      <>
-        {/* Form instance (RhfUtilsZodForm.Children) "outlet" (see "Component Hierarchy" section). */}
-        <Outlet />
+  // inject your components across all RhfUtilsZodForm instances
+  FormOutlet: (
+    // RhfUtilsClientConfigOutletProps
+    {
+      formId, //             unique id string
+      formRef, //            form element ref
+      options, //            RhfUtilsFormOptions (with any custom props)
+      lastSubmit, //         current form submit state
+      rhf, //                rhf UseFormReturn (without proxy `formState`)
 
-        {/* root errors list */}
-        <RootErrorsList />
-      </>
-    );
-  },
+      Outlet, //          Form instance (RhfUtilsZodForm.Children) "outlet"
+      Controller, //      rhf controller (SafeFieldValues-typed; no schema at this level)
+      FormSubmitError, // error class (SafeFieldValues-typed; no schema at this level)
+    },
+  ) => (
+    <>
+      {/* Form instance (RhfUtilsZodForm.Children) "outlet" (see "Component Hierarchy" section). */}
+      <Outlet />
+
+      {/* root errors list */}
+      <RootErrorsList />
+    </>
+  ),
 
   // hook that returns callback to determine whether form can be cancelled
   // if `true`, `RhfUtilsZodForm.onCancel` at form-level is called (e.g., parent component hides form)
@@ -115,14 +131,16 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
   // NOTE: this library is router-agnostic, so navigation blocking should happen elsewhere
   // (i.e., calling your own hook in `FormComponent`)
   useCanFormBeCancelled: () => {
-    const { isDirty } = useFormState();
-    const myPrompter = useMyPrompter();
+    const { isDirty, isSubmitting } = useFormState();
+
+    const canFormBeCancelled = ({ utils, lastSubmit }) =>
+      !utils.options.enableMyPrompter || // my prompter option NOT enabled for this form
+      !isDirty || // or rhf form state NOT dirty
+      (isSubmitting && lastSubmit.statusRef.current === 'success') || // successful submit before form state updated
+      confirm('Are you sure?'); // or user confirms
 
     // return callback to be called at event-time
-    return ({ options }) =>
-      !options.enableMyPrompter || // my prompter option not enabled
-      !isDirty || // or rhf form state not dirty
-      confirm('Are you sure you want to cancel?'); // or user confirms
+    return canFormBeCancelled;
   },
 
   // non-FormSubmitError thrown in onSubmit
@@ -179,6 +197,7 @@ Currently, only `zod` schemas are supported.
     passwordConfirm: z.string().min(1),
   })}
   defaultValues={{ email: '', password: '', passwordConfirm: '' }}
+  // optional transformer for api -- supplied to on submit handlers
   getApiData={({ email, password }) => ({ email, password })}
   // cancel handler (passed to `Children` below)
   // execution routed through `RhfUtilsClientConfig.useCanFormBeCancelled`, if provided
@@ -202,10 +221,10 @@ Currently, only `zod` schemas are supported.
         email: { message: 'Email is invalid.' },
       });
   }}
-  // submit handler
+  // submit handler (return value supplied to onSubmitSuccess)
   onSubmit={({ input, output, api }, context, event) => registerService(api)}
-  onSubmitSuccess={(onSubmitResult, { input, output, api }, context, event) =>
-    navigate('/app/' + onSubmitResult.id)
+  onSubmitSuccess={(submitResult, { input, output, api }, context, event) =>
+    navigate('/app/' + submitResult.id)
   }
   // handle error declaratively (i.e., no throw/catch)
   onSubmitError={({ error, context, event }) => {
@@ -356,10 +375,6 @@ Any non-`FormSubmitError` error thrown from your submit handler (e.g., fetch/axi
 
 Most common use case will be transforming backend errors to frontend shape expected by RHF.
 
-### Last Submit Error
-
-Sometimes, perhaps outside any specific `FormContext`, you need direct access to the actual error object that was thrown, which caused the last submit to fail. The `useLastSubmitError` hook allows you to do just this. (You can probably handle most form-specific cases via `onSubmitErrorUnknown`, which receives error as well.)
-
 ## `RhfUtilsFormOptions`
 
 These built-in options can be set globally and/or per form.
@@ -370,7 +385,7 @@ type RhfUtilsFormOptions = {
   stopSubmitPropagation?: boolean;
 
   /** Request submit on change. */
-  submitOnChange?: { debounce?: number };
+  submitOnWatch?: { debounce?: number };
 
   /**
    * Reset form values and state (e.g., isDirty, etc.) after submit -- on success and/or error.
@@ -387,15 +402,9 @@ type RhfUtilsFormOptions = {
 };
 ```
 
-If you need access to options deeper in your component structure, use `useRhfUtilsContext` to receive `RhfUtilsContext` object, which includes `formId`, `formRef`, `options`, and `lastSubmitStateRef`.
+### Extend
 
-`lastSubmitStateRef` (a ref with possible value of `null | 'submitting' | 'success' | 'error'`) conveys current submit state via ref -- i.e., without needing to wait for next render cycle. If your form navigates away via `onSubmitSuccess`, RHF's `useFormContext` still shows form as `isDirty` and `isSubmitting`, which makes it difficult to distinguish from a user-initiated navigation before form is submitted successfully.
-
-Use `useRhfUtilsContextRequestSubmit` hook to get `requestSubmit` function for current form ref in context. This is useful when you need to trigger form submission programatically.
-
-## Extend `RhfUtilsFormOptions`
-
-Extend `RhfUtilsFormOptions` with custom options, which get passed to `RhfUtilsClientConfig`'s `ChildrenWrapper` and `RhfUtilsZodForm`'s `Children` components via `options` prop. These can take any shape, and allow you to override your own functionality at form-level.
+Extend `RhfUtilsFormOptions` with custom options, which get passed to `RhfUtilsClientConfig`'s `useFormHooks` and `FormOutlet`; and `RhfUtilsZodForm`'s `Children` components via `options` prop. These can take any shape, and allow you to override your own functionality at form-level.
 
 ```tsx
 import '@paragrav/rhf-utils';
@@ -412,7 +421,29 @@ declare module '@paragrav/rhf-utils' {
 }
 ```
 
-## <a id="form-state-relay"></a> Form State Relay
+## `RhfUtilsContext`
+
+If you need access to options deeper in your component structure, use `useRhfUtilsContext` to receive `RhfUtilsContext` object, which includes `formId`, `formRef`, `options` (with extended properties), and last submit status and error.
+
+## Last Submit Context
+
+If you need access to metadata about the last submit outside of form, use `useLastSubmit` to receive the following data.
+
+### Status (ref)
+
+The property `status` (a ref with possible value of `null | 'submitting' | 'success' | 'error'`) conveys current submit state via ref -- i.e., without needing to wait for next render cycle. If your form navigates away via `onSubmitSuccess`, RHF's `useFormContext` still shows form as `isDirty` and `isSubmitting`, which makes it difficult to distinguish from a user-initiated navigation before form is submitted successfully.
+
+### Error (state)
+
+Sometimes, such as outside any specific `FormContext`, you need direct access to the actual error object that was thrown, which caused the last submit to fail. The `useLastSubmitError` hook allows you to do just this. (You can probably handle most form-specific cases via `onSubmitErrorUnknown`, which receives error as well.)
+
+---
+
+### Request Submit
+
+Use `useRhfUtilsContextRequestSubmit` hook to get `requestSubmit` function for current form ref in context. This is useful when you need to trigger form submission programatically.
+
+## Form State Relay
 
 Sometimes you need to access one or more forms' state outside its respective context.
 

package/dist/tsdown/{FormRelayOptions-k7OaoAqV.d.ts → FormRelayOptions-B5CknIkX.d.ts}

@@ -1,6 +1,5 @@
-import { i as SafeFieldValues, t as RhfUtilsContext } from "./RhfUtilsContextType-DwlvEWjd.js";
+import { r as SafeFieldValues, t as RhfUtilsContext } from "./RhfUtilsContextType-DBOvBnPF.js";
 import { FormState } from "react-hook-form";
-
 //#region src/form/relay/types.d.ts
 type FormRelay<TFieldValues extends SafeFieldValues = SafeFieldValues> = {
   state: FormRelayStateSelected<TFieldValues>;
@@ -27,4 +26,4 @@ type FormRelayOptions = {
 };
 //#endregion
 export { FormRelay as n, FormRelayStateSelected as r, FormRelayOptions as t };
-//# sourceMappingURL=FormRelayOptions-k7OaoAqV.d.ts.map
+//# sourceMappingURL=FormRelayOptions-B5CknIkX.d.ts.map

package/dist/tsdown/FormRelayOptions-B5CknIkX.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormRelayOptions-B5CknIkX.d.ts","names":[],"sources":["../../src/form/relay/types.ts","../../src/form/relay/FormRelayOptions.ts"],"mappings":";;;KAOY,UAAU,qBAAqB,kBAAkB;EAEzD,OAAO,uBAAuB;EAC9B,SAAS;EACT,OAAO;;KAGC,uBACV,qBAAqB,kBAAkB,mBACrC,QACF,UAAU;EACR;;;;KCZQ;;;;;EAKV,SAAS,WAAW,UAAU,qBAAqB;;;;;;EAOnD"}

package/dist/tsdown/{FormRelaySetter-BKO0Wodf.js → FormRelaySetter-CLkDwgfH.js}

@@ -106,7 +106,8 @@ const flattenFieldErrors = (errors) => flatten(errors);
 */
 const getFlatFieldErrors = (errors) => {
 	const flattened = flattenFieldErrors(errors);
-	return Object.fromEntries(Object.keys(flattened).reduce((entriesAccumulator, flattenedKey) => {
+	const flattenedKeys = Object.keys(flattened);
+	return Object.fromEntries(flattenedKeys.reduce((entriesAccumulator, flattenedKey) => {
 		/**
 		* Maybe path.
 		*
@@ -135,9 +136,13 @@ const getFlatFieldErrors = (errors) => {
 /**
 * Regular expression to maybe match the end of a leaf node path.
 *
-* i.e., `name.type`, `address.street.message`
+* @example
+* - `name.type`
+* - `address.street.message`
+*
+* @description
 *
-* iow: dot [?: non-capturing]("type" | "message")[\b word boundary][$ end of string]
+* dot [?: non-capturing]("type" | "message")[\b word boundary][$ end of string]
 */
 const regexMaybeFieldErrorLeafNodeSuffix = /\.(?:type|message)\b$/;
 const getFlatFieldErrorsSansRef = (errors) => Object.fromEntries(Object.entries(getFlatFieldErrors(errors)).map(([name, error]) => [name, {
@@ -191,4 +196,4 @@ const FormRelaySetter = ({ options }) => {
 //#endregion
 export { _RhfUtilsContextProvider as a, FormRelayContextProvider as c, isEmptyObject as i, useFormRelayContext as l, useFormRelaySet as n, useRhfUtilsContext as o, getFlatFieldErrors as r, useRhfUtilsMaybeContext as s, FormRelaySetter as t, createContext as u };
 
-//# sourceMappingURL=FormRelaySetter-BKO0Wodf.js.map
+//# sourceMappingURL=FormRelaySetter-CLkDwgfH.js.map

package/dist/tsdown/FormRelaySetter-CLkDwgfH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormRelaySetter-CLkDwgfH.js","names":[],"sources":["../../src/utils/createContext.ts","../../src/form/relay/context/useFormRelayContext.ts","../../src/form/relay/context/FormRelayContextProvider.tsx","../../src/form/context/utils/useRhfUtilsContext.tsx","../../src/utils/isEmptyObject.ts","../../src/errors/flat/flattenFieldErrors.ts","../../src/errors/flat/getFlatFieldErrors.ts","../../src/form/relay/set/useFormRelaySet.ts","../../src/form/relay/set/FormRelaySetter.tsx"],"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 */\nexport function 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","import type { RhfUtilsContext } from '@/form/context/utils/RhfUtilsContextType';\n\nimport { createContext } from '@/utils/createContext';\n\nimport type { FormRelayOptions } from '../FormRelayOptions';\nimport type { FormRelay, FormRelayStateSelected } from '../types';\n\nexport type FormsRelayed = Record<\n  string, // form id\n  FormRelay\n>;\n\nexport type FormRelayContext = {\n  // set\n\n  add: (\n    state: FormRelayStateSelected,\n    utils: RhfUtilsContext,\n    options: FormRelayOptions,\n  ) => void;\n\n  update: (id: string, state: FormRelayStateSelected) => void;\n\n  remove: (id: string) => void;\n\n  // state\n\n  state: FormsRelayed;\n};\n\nexport const {\n  Provider: _FormRelayContextProvider,\n  useRequired: useFormRelayContext,\n} = createContext<FormRelayContext>();\n","import React from 'react';\n\nimport type { RhfUtilsContext } from '@/form/context/utils/RhfUtilsContextType';\n\nimport type { FormRelayOptions } from '../FormRelayOptions';\nimport type { FormRelayStateSelected } from '../types';\n\nimport type { FormsRelayed } from './useFormRelayContext';\nimport { _FormRelayContextProvider } from './useFormRelayContext';\n\ntype Props = React.PropsWithChildren;\n\nexport const FormRelayContextProvider: React.FC<Props> = ({ children }) => {\n  // state\n\n  const [state, setState] = React.useState<FormsRelayed>({});\n\n  // set\n\n  const add = React.useCallback(\n    (\n      formState: FormRelayStateSelected,\n      utils: RhfUtilsContext,\n      options: FormRelayOptions,\n    ) => {\n      if (state[utils.formId]) throw new Error('Form id already exists.');\n\n      setState((forms) => ({\n        ...forms,\n        [utils.formId]: { state: formState, utils, options },\n      }));\n    },\n\n    [state],\n  );\n\n  const update = React.useCallback(\n    (id: string, state: FormRelayStateSelected) => {\n      setState((forms) => {\n        const current = forms[id];\n\n        if (!current) throw new Error(\"Form id doesn't exist\");\n\n        return {\n          ...forms,\n          [id]: { ...current, state },\n        };\n      });\n    },\n    [],\n  );\n\n  const remove = React.useCallback((id: string) => {\n    setState((forms) =>\n      Object.fromEntries(\n        Object.entries(forms)\n          // keep only other ids\n          .filter(([entryId]) => entryId !== id),\n      ),\n    );\n  }, []);\n\n  //\n\n  return (\n    <_FormRelayContextProvider\n      value={{\n        // set\n\n        add,\n        update,\n        remove,\n\n        // get\n\n        state,\n      }}\n    >\n      {children}\n    </_FormRelayContextProvider>\n  );\n};\n","import { createContext } from '@/utils/createContext';\n\nimport type { RhfUtilsContext } from './RhfUtilsContextType';\n\nconst {\n  Provider: _RhfUtilsContextProvider,\n  useRequired: useRhfUtilsContext,\n  useMaybe: useRhfUtilsMaybeContext,\n} = createContext<RhfUtilsContext>();\n\nexport {\n  _RhfUtilsContextProvider,\n  useRhfUtilsContext,\n  useRhfUtilsMaybeContext,\n};\n","export const isEmptyObject = (obj: Record<string, unknown>) =>\n  Object.keys(obj).length === 0;\n","import { flatten } from 'flat';\nimport type { FieldErrors } from 'react-hook-form';\n\n/**\n * Flatten a {@link FieldErrors} object.\n *\n * @returns e.g.,\n * ```ts\n * {\n *   \"address.street.type\": \"too_short\",\n *   \"address.street.ref.value\": \"123\",\n *   \"address.street.message\": \"Required.\"\n * }\n * ```\n */\nexport const flattenFieldErrors = (errors: FieldErrors) =>\n  flatten<FieldErrors, Record<string, unknown>>(errors);\n","import type { FieldError, FieldErrors } from 'react-hook-form';\nimport { get } from 'react-hook-form';\n\nimport type { SafeFieldValues } from '@/form/rhf/SafeFieldValuesType';\n\nimport { flattenFieldErrors } from './flattenFieldErrors';\nimport type { FlatFieldErrors } from './types';\n\n/**\n * Get {@link FlatFieldErrors} from {@link FieldErrors}.\n * This makes it easy to work with potentially deeply-nested {@link FieldErrors}.\n *\n * @param errors {@link FieldErrors} object.\n *\n * @returns `FlatFieldErrors` object.\n *\n * @example\n * ```\n * {\n *   \"address.street\": {\n *     type: \"too_short\",\n *     ref: { value: \"123\" },\n *     message: \"Required.\" }\n *   }\n * }\n * ```\n */\nexport const getFlatFieldErrors = (errors: FieldErrors): FlatFieldErrors => {\n  // flatten object for simpler processing\n  const flattened = flattenFieldErrors(errors);\n\n  // get flattened keys (e.g., `name.message`), which we must transform back to actual paths (e.g., `name`)\n  const flattenedKeys = Object.keys(flattened);\n\n  // rebuild FlatFieldErrors\n  return Object.fromEntries(\n    flattenedKeys.reduce<[PropertyKey, FieldError][]>(\n      (entriesAccumulator, flattenedKey) => {\n        /**\n         * Maybe path.\n         *\n         * Derived from flattened key by removing leaf node suffix (if present).\n         *\n         * @example\n         * path: `address.street.message` -> `address.street`\n         * @example\n         * not path: `address.street.ref` -> `address.street.ref` (no suffix match to replace)\n         */\n        const maybePath = flattenedKey.replace(\n          regexMaybeFieldErrorLeafNodeSuffix,\n          '',\n        );\n\n        // if nothing replaced, then it's not a leaf node; return early\n        if (maybePath === flattenedKey) return entriesAccumulator;\n\n        // find field error in original FieldErrors object\n        // has dual-purpose of confirming that each path is valid\n        const fieldError = get(errors, maybePath, undefined) as\n          FieldError | undefined;\n\n        // if no field error found, then derived path was wrong; return early\n        if (!fieldError) return entriesAccumulator;\n\n        /**\n         * Add entry to accumulator.\n         *\n         * (If it's a duplicate (e.g., `.type` leaf node matched before `.message`),\n         * it doesn't matter because `Object.fromEntries` will just overwrite\n         * first entry with second matching key/value.)\n         */\n        entriesAccumulator.push([maybePath, fieldError]);\n\n        return entriesAccumulator;\n      },\n\n      [], // entries\n    ),\n  );\n};\n\n//\n\n/**\n * Regular expression to maybe match the end of a leaf node path.\n *\n * @example\n * - `name.type`\n * - `address.street.message`\n *\n * @description\n *\n * dot [?: non-capturing](\"type\" | \"message\")[\\b word boundary][$ end of string]\n */\nexport const regexMaybeFieldErrorLeafNodeSuffix = /\\.(?:type|message)\\b$/;\n\n//\n\nexport type FieldErrorsSansRef<\n  TFieldValues extends SafeFieldValues = SafeFieldValues,\n> = Record<\n  keyof TFieldValues | 'root',\n  Partial<Pick<FieldError, 'message' | 'type'>> & {\n    hasRef: boolean;\n  }\n>;\n\nexport const getFlatFieldErrorsSansRef = <TFieldValues extends SafeFieldValues>(\n  errors: FieldErrors<TFieldValues>,\n) =>\n  Object.fromEntries(\n    Object.entries(getFlatFieldErrors(errors)).map(([name, error]) => [\n      name,\n      {\n        type: error.type,\n        message: error.message,\n        hasRef: !!error.ref, // strip out actual ref, etc. (avoid circular JSON error)\n      },\n    ]),\n  ) as FieldErrorsSansRef<TFieldValues>;\n","import React from 'react';\nimport { useFormState } from 'react-hook-form';\n\nimport { getFlatFieldErrorsSansRef } from '@/errors/flat/getFlatFieldErrors';\n\nimport { useRhfUtilsContext } from '@/form/context/utils/useRhfUtilsContext';\n\nimport { useFormRelayContext } from '../context/useFormRelayContext';\nimport type { FormRelayOptions } from '../FormRelayOptions';\nimport type { FormRelayStateSelected } from '../types';\n\nexport const useFormRelaySet = (options?: FormRelayOptions) => {\n  if (!options) return;\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const [memoOptions] = React.useState(options);\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  useFormRelayOnMount(memoOptions);\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  useFormRelayOnChange(memoOptions);\n};\n\n// HELPERS\n\n// mount\n\nconst useFormRelayOnMount = (options: FormRelayOptions) => {\n  const utils = useRhfUtilsContext();\n  const relay = useFormRelayContext();\n  const formStateForRelay = useFormStateForRelay(options);\n\n  React.useEffect(\n    () => {\n      relay.add(formStateForRelay, utils, options);\n\n      // unmount\n      return () => {\n        relay.remove(utils.formId);\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n};\n\n// update\n\nconst useFormRelayOnChange = (options: FormRelayOptions) => {\n  const utils = useRhfUtilsContext();\n  const relay = useFormRelayContext();\n  const formStateForRelay = useFormStateForRelay(options);\n\n  React.useEffect(\n    // when form state changes, publish to relay context\n    () => {\n      relay.update(utils.formId, formStateForRelay);\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [formStateForRelay],\n  );\n};\n\n// relayed form state\n\n/** Transform, memo-ize {@link useFormState}'s return to {@link FormRelayed} */\nconst useFormStateForRelay = (\n  options: FormRelayOptions,\n): FormRelayStateSelected => {\n  const formState = useFormState();\n\n  const formStateSelected = options.select(formState);\n\n  const formStateSelectedJson = JSON.stringify({\n    ...formStateSelected,\n    errors:\n      formStateSelected.errors &&\n      getFlatFieldErrorsSansRef(formStateSelected.errors),\n  });\n\n  const memoFormStateSelected = React.useMemo(\n    // when watch JSON changes, update memo\n    () => formStateSelected,\n\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [formStateSelectedJson],\n  );\n\n  return memoFormStateSelected;\n};\n","import type { FormRelayOptions } from '../FormRelayOptions';\n\nimport { useFormRelaySet } from './useFormRelaySet';\n\ntype Props = {\n  options?: FormRelayOptions;\n};\n\nexport const FormRelaySetter: React.FC<Props> = ({ options }) => {\n  useFormRelaySet(options);\n\n  return null;\n};\n"],"mappings":"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"}

package/dist/tsdown/{RhfUtilsClientConfigType-BaedoEQY.d.ts → RhfUtilsClientConfigType-CRy_vYef.d.ts}

@@ -1,7 +1,6 @@
-import { a as RhfUtilsFormOptions, i as SafeFieldValues, t as RhfUtilsContext } from "./RhfUtilsContextType-DwlvEWjd.js";
+import { i as RhfUtilsFormOptions, r as SafeFieldValues, t as RhfUtilsContext } from "./RhfUtilsContextType-DBOvBnPF.js";
 import React$1 from "react";
 import { ControllerProps, FieldError, FieldPath, UseFormProps, UseFormReturn } from "react-hook-form";
-
 //#region src/errors/output/types.d.ts
 /**
  * Config object for error output.
@@ -96,11 +95,38 @@ type FormSubmitFieldErrors<TFieldValues extends SafeFieldValues = SafeFieldValue
 }>;
 //#endregion
 //#region src/submit/error/FormSubmitError.d.ts
-declare class FormSubmitError<TFieldValues extends SafeFieldValues = SafeFieldValues, TApiValues extends undefined | SafeFieldValues = undefined, TAllValues extends SafeFieldValues = (TApiValues extends undefined ? TFieldValues : TFieldValues | TApiValues)> extends Error {
+declare class FormSubmitError<TFieldValues extends SafeFieldValues = SafeFieldValues, TApiValues extends undefined | SafeFieldValues = undefined, TAllValues extends SafeFieldValues = TApiValues extends undefined ? TFieldValues : TFieldValues | TApiValues> extends Error {
   errors: FormSubmitFieldErrors<TAllValues>;
   constructor(errors: FormSubmitFieldErrors<TAllValues>, message?: string);
 }
 //#endregion
+//#region src/submit/last/error/LastSubmitErrorType.d.ts
+type LastSubmitError = {
+  error: unknown;
+  event: React.BaseSyntheticEvent;
+};
+//#endregion
+//#region src/submit/last/status/LastSubmitStatusType.d.ts
+/** Last submit state. */
+type LastSubmitStatus = null | 'submitting' | 'success' | 'error';
+//#endregion
+//#region src/submit/last/context/LastSubmitContextType.d.ts
+type LastSubmitContext = {
+  status: {
+    ref: React.RefObject<LastSubmitStatus | null>;
+  };
+  error: {
+    /** Last submit error (with event). */
+    state: LastSubmitError | undefined;
+    set: (error: unknown, event: React.BaseSyntheticEvent) => void;
+    reset: () => void;
+  };
+};
+type LastSubmitContextRead = {
+  statusRef: LastSubmitContext['status']['ref'];
+  error: LastSubmitContext['error']['state'];
+};
+//#endregion
 //#region src/submit/UseRhfUtilsFormOnSubmitContextType.d.ts
 /**
  * Props for onSubmit other than `data` and `event`.
@@ -109,6 +135,7 @@ declare class FormSubmitError<TFieldValues extends SafeFieldValues = SafeFieldVa
  */
 type UseRhfUtilsFormOnSubmitContext<TFieldValues extends SafeFieldValues = SafeFieldValues, TTransformedValues extends SafeFieldValues = TFieldValues, TApiValues extends undefined | SafeFieldValues = undefined> = {
   utils: RhfUtilsContext;
+  lastSubmit: LastSubmitContextRead;
   rhf: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
   FormSubmitError: typeof FormSubmitError<TFieldValues, TApiValues>;
 };
@@ -117,6 +144,7 @@ type UseRhfUtilsFormOnSubmitContext<TFieldValues extends SafeFieldValues = SafeF
  */
 type UseRhfUtilsFormOnSubmitErrorContext<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = {
   utils: RhfUtilsContext;
+  lastSubmit: LastSubmitContextRead;
   rhf: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
   errors?: FormSubmitFieldErrors;
 };
@@ -130,15 +158,25 @@ type Merge<A, B, C = unknown, D = unknown> = D & Omit<C, keyof D> & Omit<Omit<B,
 type _ControllerProps<TFieldValues extends SafeFieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = Omit<ControllerProps<TFieldValues, TName>, 'control'>;
 declare const _Controller: <TFieldValues extends SafeFieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>(props: _ControllerProps<TFieldValues, TName>) => import("react").JSX.Element;
 //#endregion
-//#region src/client/config/RhfUtilsFormInjectorProps.d.ts
+//#region src/client/config/RhfUtilsClientConfigUseFormHooksProps.d.ts
 /**
- * RhfUtilsClientConfig's FormComponent props.
+ * RhfUtilsClientConfig's `useFormHooks` props.
  */
-type RhfUtilsFormInjectorProps<TFieldValues extends SafeFieldValues = SafeFieldValues, TTransformedValues extends SafeFieldValues = TFieldValues> = Merge<{
-  /** Form instance children (`RhfUtilsZodForm.Children`) to output amid globally-injected code. */Outlet: React.FC;
-}, RhfUtilsContext, {
+type RhfUtilsClientConfigUseFormHooksProps<TFieldValues extends SafeFieldValues = SafeFieldValues, TTransformedValues extends SafeFieldValues = TFieldValues> = Merge<RhfUtilsContext, {
+  lastSubmit: LastSubmitContextRead;
   rhf: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
+}>;
+//#endregion
+//#region src/client/config/RhfUtilsClientConfigFormOutletProps.d.ts
+/**
+ * RhfUtilsClientConfig's FormComponent props.
+ */
+type RhfUtilsClientConfigFormOutletProps<TFieldValues extends SafeFieldValues = SafeFieldValues, TTransformedValues extends SafeFieldValues = TFieldValues> = Merge<RhfUtilsClientConfigUseFormHooksProps<TFieldValues, TTransformedValues>, {
+  /** Form instance children (`RhfUtilsZodForm.Children`) to output amid globally-injected code. */
+  Outlet: React.FC;
+  /** RHF Controller (SafeFieldValues-typed; no schema at this level). */
   Controller: typeof _Controller<TFieldValues>;
+  /** Error class (SafeFieldValues-typed; no schema at this level). */
   FormSubmitError: typeof FormSubmitError<TFieldValues>;
 }>;
 //#endregion
@@ -160,7 +198,19 @@ type RhfUtilsClientConfig = {
    */
   FormComponent?: React.FC<React.PropsWithChildren<React.HTMLAttributes<HTMLFormElement>>>;
   /**
-   * Inject your own hooks, components, etc., into every form instance.
+   * Inject your own hooks across all form instances.
+   *
+   * @description
+   *
+   * (NOTE: context params are not schema-typed as not possible at this level.)
+   *
+   * @example
+   *
+   * See README.
+   */
+  useFormHooks?: (props: RhfUtilsClientConfigUseFormHooksProps) => void;
+  /**
+   * Inject your components across all form instances.
    *
    * @description
    *
@@ -170,7 +220,7 @@ type RhfUtilsClientConfig = {
    *
    * See README.
    */
-  FormInjector?: React.FC<RhfUtilsFormInjectorProps>;
+  FormOutlet?: React.FC<RhfUtilsClientConfigFormOutletProps>;
   /**
    * A hook that returns a callback that determines whether form can be cancelled at event-time.
    *
@@ -209,5 +259,5 @@ type RhfUtilsClientConfig = {
   };
 };
 //#endregion
-export { UseRhfUtilsFormOnSubmitContext as a, FormSubmitFieldErrors as c, MaybePromise as i, RhfUseFormInstanceProps as l, RhfUtilsFormInjectorProps as n, UseRhfUtilsFormOnSubmitErrorContext as o, _Controller as r, FormSubmitError as s, RhfUtilsClientConfig as t, useFlatFieldErrorsContext as u };
-//# sourceMappingURL=RhfUtilsClientConfigType-BaedoEQY.d.ts.map
+export { UseRhfUtilsFormOnSubmitContext as a, LastSubmitStatus as c, FormSubmitFieldErrors as d, RhfUseFormInstanceProps as f, MaybePromise as i, LastSubmitError as l, RhfUtilsClientConfigFormOutletProps as n, UseRhfUtilsFormOnSubmitErrorContext as o, useFlatFieldErrorsContext as p, _Controller as r, LastSubmitContextRead as s, RhfUtilsClientConfig as t, FormSubmitError as u };
+//# sourceMappingURL=RhfUtilsClientConfigType-CRy_vYef.d.ts.map

package/dist/tsdown/RhfUtilsClientConfigType-CRy_vYef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RhfUtilsClientConfigType-CRy_vYef.d.ts","names":[],"sources":["../../src/errors/output/types.ts","../../src/errors/flat/types.ts","../../src/errors/flat/context/useFlatFieldErrorsContext.ts","../../src/errors/flat/context/FlatFieldErrorsOutputConfig.ts","../../src/form/rhf/UseFormPropsType.ts","../../src/form/defaults/UseRhfUtilsFormGlobalDefaults.ts","../../src/submit/error/FormSubmitFieldErrors.ts","../../src/submit/error/FormSubmitError.ts","../../src/submit/last/error/LastSubmitErrorType.ts","../../src/submit/last/status/LastSubmitStatusType.ts","../../src/submit/last/context/LastSubmitContextType.ts","../../src/submit/UseRhfUtilsFormOnSubmitContextType.ts","../../src/utils/types.ts","../../src/form/_Controller.tsx","../../src/client/config/RhfUtilsClientConfigUseFormHooksProps.ts","../../src/client/config/RhfUtilsClientConfigFormOutletProps.ts","../../src/client/config/RhfUtilsClientConfigType.ts"],"mappings":";;;;;;;KAGY;EACV;EACA;;;;;;;;;;;;;;KCOU,kBAAkB,eAAe;;;KCRjC;EACV,KAAK;EACL,QAAQ;EACR,OAAO;EACP,SAAS;EAET;EACA;;cAIU,gDAA8B,SAAA,qCAC3B,iCAAyB;;;KCZ5B;;;;;;;;EAQV,WACE,SAAS,2BACN;;;;;;;EAQL,SACE,SAAS;;;;KCnBD,wBAAwB,KAClC;KAaU,wBACV,qBAAqB,iBACrB,2BAA2B,mBACzB,KACF,aAAa,uBAAuB;;;;;;KCd1B;;;;;;EAMV,MAAM;;;;;;EAON,UAAU;;;;EAKV,OAAO,KACL,QAAM,gBAAgB,QAAM,IAAI;;;;;;;;;;;;KCfxB,sBACV,qBAAqB,kBAAkB,mBACrC,OAEF,UAAU;EAGR;EACA;;;;cChBS,gBACX,qBAAqB,kBAAkB,iBACvC,+BAA+B,6BAC/B,mBAAmB,kBAAkB,+BACjC,eACA,eAAe,oBACX;EAEC,QAAQ,sBAAsB;cAA9B,QAAQ,sBAAsB,aACrC;;;;KCbQ;EACV;EACA,OAAO,MAAM;;;;;KCDH;;;KCEA;EACV;IACE,KAAK,MAAM,UAAU;;EAGvB;;IAEE,OAAO;IAEP,MAAM,gBAAgB,OAAO,MAAM;IAEnC;;;KAIQ;EACV,WAAW;EACX,OAAO;;;;;;;;;KCLG,+BACV,qBAAqB,kBAAkB,iBACvC,2BAA2B,kBAAkB,cAC7C,+BAA+B;EAE/B,OAAO;EACP,YAAY;EACZ,KAAK,cAAc,uBAAuB;EAC1C,wBAAwB,gBAAgB,cAAc;;;;;KAM5C,oCACV,qBAAqB,iBACrB,2BAA2B;EAE3B,OAAO;EACP,YAAY;EACZ,KAAK,cAAc,uBAAuB;EAC1C,SAAS;;;;KCpCC,aAAa,KAAK,IAAI,QAAQ;;KAG9B,MAAM,GAAG,GAAG,aAAa,eAAe,IAClD,KAAK,SAAS,KACd,KAAK,KAAK,SAAS,UAAU,KAC7B,KAAK,KAAK,KAAK,SAAS,UAAU,UAAU;;;KCDlC,iBACV,qBAAqB,iBACrB,cAAc,UAAU,gBAAgB,UAAU,iBAChD,KAAK,gBAAgB,cAAc;cAE1B,cACX,qBAAqB,iBACrB,cAAc,UAAU,gBAAgB,UAAU,eAElD,OAAO,iBAAiB,cAAc,2BAAM,IAAA;;;;;;KCFlC,sCACV,qBAAqB,kBAAkB,iBACvC,2BAA2B,kBAAkB,gBAC3C,MACF;EAEE,YAAY;EACZ,KAAK,cAAc,uBAAuB;;;;;;;KCPlC,oCACV,qBAAqB,kBAAkB,iBACvC,2BAA2B,kBAAkB,gBAC3C,MACF,sCAAsC,cAAc;;EAGlD,QAAQ,MAAM;;EAGd,mBAAmB,YAAY;;EAE/B,wBAAwB,gBAAgB;;;;;;;;;KCPhC;;;;EAIV,WAAW;;;;;;EAOX,gBAAgB,MAAM,GACpB,MAAM,kBAAkB,MAAM,eAAe;;;;;;;;;;;;EAc/C,gBAAgB,OAAO;;;;;;;;;;;;EAavB,aAAa,MAAM,GAAG;;;;;;;;;;;;;;;;EAiBtB,+BACE,OAAO,mCACJ;;;;;;;;;;;EAYL,wBAAwB,mBAAmB;;;;EAK3C;;;;IAIE,SAAS"}

package/dist/tsdown/{RhfUtilsContextType-DwlvEWjd.d.ts → RhfUtilsContextType-DBOvBnPF.d.ts}

@@ -1,6 +1,5 @@
-import React, { RefObject } from "react";
+import React from "react";
 import { DevtoolUIProps } from "@hookform/devtools/dist/devToolUI";
-
 //#region src/Register.d.ts
 /**
  * Use this to extend internal types.
@@ -42,7 +41,8 @@ type UseResetFormOnSubmittedOptions = undefined | {
 //#endregion
 //#region src/submit/useSubmitFormOnWatch.d.ts
 type UseSubmitFormOnWatchOptions = {
-  /** Milliseconds to debounce form submission. (Default is none.) */debounce: number;
+  /** Milliseconds to debounce form submission. (Default is none.) */
+  debounce: number;
 };
 //#endregion
 //#region src/form/options/RhfUtilsFormOptionsType.d.ts
@@ -52,11 +52,13 @@ type UseSubmitFormOnWatchOptions = {
  * Can be extended via {@link Register}.
  */
 type RhfUtilsFormOptions = {
-  /** Stop propagation of submit event. */stopSubmitPropagation?: boolean;
+  /** Stop propagation of submit event. */
+  stopSubmitPropagation?: boolean;
   /**
    * Request submit when user changes form values.
    */
-  submitOnWatch?: UseSubmitFormOnWatchOptions; /** Reset form values and state (e.g., `isDirty`) after submit -- on success and/or error. */
+  submitOnWatch?: UseSubmitFormOnWatchOptions;
+  /** Reset form values and state (e.g., `isDirty`) after submit -- on success and/or error. */
   resetOnSubmitted?: UseResetFormOnSubmittedOptions;
   /**
    * Control dev tool options.
@@ -74,26 +76,16 @@ type RhfUtilsFormOptions = {
  */
 type SafeFieldValues = Record<string, unknown>;
 //#endregion
-//#region src/form/context/utils/LastSubmitStateType.d.ts
-type LastSubmitState = null | 'submitting' | 'success' | 'error';
-//#endregion
 //#region src/form/context/utils/RhfUtilsContextProvider.d.ts
 type RhfUtilsContextProviderProps = {
   formId: string;
-  formRef: React.RefObject<HTMLFormElement | null>; /** Consumer-supplied options and values. */
+  formRef: React.RefObject<HTMLFormElement | null>;
+  /** Consumer-supplied options and values. */
   options: RhfUtilsFormOptions;
 };
 //#endregion
 //#region src/form/context/utils/RhfUtilsContextType.d.ts
-type RhfUtilsContext = RhfUtilsContextProviderProps & {
-  /**
-   * Current form submit state.
-   *
-   * e.g., can be used to determine whether safe to redirect (navigate) without prompter.
-   * Unlike RHF's `isSubmitSuccessful`, is computed/set immediately after `onSubmit` succeeds/fails.
-   */
-  lastSubmitStateRef: RefObject<LastSubmitState>;
-};
+type RhfUtilsContext = RhfUtilsContextProviderProps;
 //#endregion
-export { RhfUtilsFormOptions as a, SafeFieldValues as i, RhfUtilsContextProviderProps as n, Register as o, LastSubmitState as r, RhfUtilsContext as t };
-//# sourceMappingURL=RhfUtilsContextType-DwlvEWjd.d.ts.map
+export { Register as a, RhfUtilsFormOptions as i, RhfUtilsContextProviderProps as n, SafeFieldValues as r, RhfUtilsContext as t };
+//# sourceMappingURL=RhfUtilsContextType-DBOvBnPF.d.ts.map

package/dist/tsdown/RhfUtilsContextType-DBOvBnPF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RhfUtilsContextType-DBOvBnPF.d.ts","names":[],"sources":["../../src/Register.d.ts","../../src/submit/useResetFormOnSubmitted.ts","../../src/submit/useSubmitFormOnWatch.ts","../../src/form/options/RhfUtilsFormOptionsType.ts","../../src/form/rhf/SafeFieldValuesType.ts","../../src/form/context/utils/RhfUtilsContextProvider.tsx","../../src/form/context/utils/RhfUtilsContextType.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAeiB;;;;;;KCRL;;;;;;EAWN;IAAY;;;;;EAKZ;IAAU;;;;;KChBJ;;EAEV;;;;;;;;;KCGU;;EAIR;;;;EAKA,gBAAgB;;EAGhB,mBAAmB;;;;;;EAOnB,oBAAoB,KAAK;KAGxB;EACC,2BAA2B;IAGzB;;;;;;KCnCI,kBAAkB;;;KCUlB;EACV;EACA,SAAS,MAAM,UAAU;;EAGzB,SAAS;;;;KChBC,kBAAkB"}