@paragrav/rhf-utils 0.65.0 → 0.67.0

package/dist/tsdown/relay.d.ts

@@ -0,0 +1,56 @@
+import { a as RhfUtilsFormOptions, i as SafeFieldValues } from "./RhfUtilsContextType-BFmDtONY.js";
+import { n as FormRelay, r as FormRelayStateSelected, t as FormRelayOptions } from "./FormRelayOptions-mBqiP41Z.js";
+import React$1 from "react";
+import { FormState } from "react-hook-form";
+
+//#region src/form/relay/context/FormRelayContextProvider.d.ts
+type Props$1 = React$1.PropsWithChildren;
+declare const FormRelayContextProvider: React$1.FC<Props$1>;
+//#endregion
+//#region src/form/relay/get/FormRelayGroupType.d.ts
+type FormRelayGroup = Partial<Omit<FormState<SafeFieldValues>, 'defaultValues' | 'dirtyFields' | 'touchedFields' | 'validatingFields' | 'errors' | 'submitErrors'> & {
+  hasErrors: boolean;
+  hasDirtyFields: boolean;
+  hasTouchedFields: boolean;
+  hasValidatingFields: boolean; /** Sum of all submit counts. */
+  submitCount: number;
+  /**
+   * Consider form flagged when mounted.
+   *
+   * (To use, return via `FormRelayOptions`'s `select`'s return's `FormRelayStateSelected`'s `isMounted` property.)
+   */
+  isMounted: boolean;
+}>;
+//#endregion
+//#region src/form/relay/get/grouper/useFirstFormStateGroup.d.ts
+/**
+ * Use this when you don't (want to) know whether component is wrapped
+ * with RHF context, `FormRelayGrouperContext`, or `FormRelayContext`.
+ * Will return `FormRelayGroup`, regardless.
+ *
+ * Allows you to build naive components that are not tied to one specific context.
+ */
+declare const useFirstFormStateGroup: () => FormRelayGroup;
+//#endregion
+//#region src/form/relay/get/useFormRelay.d.ts
+declare const useFormRelayId: (formId: string) => FormRelay | undefined;
+type FormRelayGroupCriteria = {
+  groups: string[];
+} | {
+  predicate: (context: {
+    groups: FormRelayOptions['groups'];
+    options: RhfUtilsFormOptions;
+  }) => boolean;
+};
+declare const useFormRelayGroup: (criteria?: FormRelayGroupCriteria) => FormRelayGroup;
+//#endregion
+//#region src/form/relay/set/FormRelaySetter.d.ts
+type Props = {
+  options?: FormRelayOptions;
+};
+declare const FormRelaySetter: React.FC<Props>;
+//#endregion
+//#region src/form/relay/set/useFormRelaySet.d.ts
+declare const useFormRelaySet: (options?: FormRelayOptions) => void;
+//#endregion
+export { type FormRelay, FormRelayContextProvider, type FormRelayGroup, FormRelaySetter, type FormRelayStateSelected, useFirstFormStateGroup, useFormRelayGroup, useFormRelayId, useFormRelaySet };

package/dist/tsdown/relay.js

@@ -0,0 +1,71 @@
+import { c as FormRelayContextProvider, i as isEmptyObject, l as useFormRelayContext, n as useFormRelaySet, s as useRhfUtilsMaybeContext, t as FormRelaySetter, u as createContext } from "./FormRelaySetter-BKO0Wodf.js";
+import React from "react";
+import { useFormState } from "react-hook-form";
+//#region src/form/relay/context/utils.ts
+/** Condense list of form states to singular booleans. */
+const getFormRelayedAggregatedByRelayedItem = (formStates) => formStates.reduce((acc, curr) => ({
+	isDirty: acc.isDirty || curr.isDirty,
+	isSubmitting: acc.isSubmitting || curr.isSubmitting,
+	isLoading: acc.isLoading || curr.isLoading,
+	isSubmitted: acc.isSubmitted || curr.isSubmitted,
+	isSubmitSuccessful: acc.isSubmitSuccessful || curr.isSubmitSuccessful,
+	isValidating: acc.isValidating || curr.isValidating,
+	isValid: acc.isValid || curr.isValid,
+	isReady: acc.isReady || curr.isReady,
+	disabled: acc.disabled || curr.disabled,
+	hasErrors: acc.hasErrors || curr.errors && !isEmptyObject(curr.errors),
+	hasDirtyFields: acc.hasDirtyFields || curr.dirtyFields && !isEmptyObject(curr.dirtyFields),
+	hasTouchedFields: acc.hasTouchedFields || curr.touchedFields && !isEmptyObject(curr.touchedFields),
+	hasValidatingFields: acc.hasValidatingFields || curr.validatingFields && !isEmptyObject(curr.validatingFields),
+	submitCount: (acc.submitCount ?? 0) + (curr.submitCount ?? 0),
+	isMounted: acc.isMounted || curr.isMounted
+}), {
+	isDirty: void 0,
+	isSubmitting: void 0,
+	isLoading: void 0,
+	isSubmitted: void 0,
+	isSubmitSuccessful: void 0,
+	isValidating: void 0,
+	isReady: void 0,
+	isValid: void 0,
+	disabled: void 0,
+	hasErrors: void 0,
+	hasDirtyFields: void 0,
+	hasTouchedFields: void 0,
+	hasValidatingFields: void 0,
+	submitCount: void 0,
+	isMounted: void 0
+});
+//#endregion
+//#region src/form/relay/get/useFormRelay.ts
+const useFormRelayId = (formId) => useFormRelayContext().state[formId];
+const useFormRelayGroup = (criteria) => {
+	const relayState = useFormRelayContext().state;
+	const state = getFormRelayedAggregatedByRelayedItem(getFormRelaysByCriteria(relayState, criteria).map(({ state }) => state));
+	const jsonState = JSON.stringify(state);
+	return React.useMemo(() => state, [jsonState]);
+};
+const getFormRelaysByCriteria = (relayState, criteria) => Object.values(relayState).filter(({ options, utils }) => !criteria || "groups" in criteria && criteria.groups.filter((group) => options.groups?.includes(group)).length || "predicate" in criteria && criteria.predicate({
+	groups: options.groups,
+	options: utils.options
+}));
+//#endregion
+//#region src/form/relay/get/grouper/context/index.ts
+const { Provider: _FormRelayGrouperContextProvider, useRequired: _useFormRelayGrouperContext, useMaybe: _useFormRelayGrouperMaybeContext } = createContext();
+//#endregion
+//#region src/form/relay/get/grouper/useFirstFormStateGroup.ts
+/**
+* Use this when you don't (want to) know whether component is wrapped
+* with RHF context, `FormRelayGrouperContext`, or `FormRelayContext`.
+* Will return `FormRelayGroup`, regardless.
+*
+* Allows you to build naive components that are not tied to one specific context.
+*/
+const useFirstFormStateGroup = () => {
+	if (useRhfUtilsMaybeContext()) return getFormRelayedAggregatedByRelayedItem([useFormState()]);
+	const maybeRelayCtx = _useFormRelayGrouperMaybeContext();
+	if (maybeRelayCtx) return maybeRelayCtx.state;
+	return useFormRelayGroup();
+};
+//#endregion
+export { FormRelayContextProvider, FormRelaySetter, useFirstFormStateGroup, useFormRelayGroup, useFormRelayId, useFormRelaySet };

package/dist/tsdown/trpc.d.ts

@@ -0,0 +1,36 @@
+import { c as FormSubmitFieldErrors, t as RhfUtilsClientConfig } from "./RhfUtilsClientConfigType-CeOJzNAc.js";
+import { TRPCClientErrorLike } from "@trpc/client";
+import { z } from "zod";
+import { AnyTRPCRouter } from "@trpc/server";
+
+//#region src/errors/trpc/makeOnSubmitTrpcClientErrorHandler.d.ts
+/**
+ * HOF that returns submit error handler for {@link RhfUtilsClientConfig.onSubmitErrorUnknown}.
+ *
+ * @param onError Fallback for handling non-TRPC errors.
+ * @returns FormSubmitError
+ */
+declare const makeOnSubmitTrpcClientErrorHandler: (onNotTrpcClientError: NonNullable<RhfUtilsClientConfig["onSubmitErrorUnknown"]>) => (error: unknown) => FormSubmitFieldErrors | undefined;
+//#endregion
+//#region src/errors/trpc/trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer.d.ts
+/**
+ * Schema that transforms {@link TRPCClientError} to RHF {@link FormSubmitFieldErrors}.
+ */
+declare const trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer: z.ZodEffects<z.ZodEffects<z.ZodPipeline<z.ZodEffects<z.ZodEffects<z.ZodType<TRPCClientErrorLike<AnyTRPCRouter>, z.ZodTypeDef, TRPCClientErrorLike<AnyTRPCRouter>>, string, TRPCClientErrorLike<AnyTRPCRouter>>, unknown, TRPCClientErrorLike<AnyTRPCRouter>>, z.ZodArray<z.ZodObject<{
+  code: z.ZodString;
+  message: z.ZodString;
+  path: z.ZodArray<z.ZodString, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+  code: z.ZodString;
+  message: z.ZodString;
+  path: z.ZodArray<z.ZodString, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+  code: z.ZodString;
+  message: z.ZodString;
+  path: z.ZodArray<z.ZodString, "many">;
+}, z.ZodTypeAny, "passthrough">>, "many">>, (readonly [string, {
+  type: string;
+  message: string;
+}])[], TRPCClientErrorLike<AnyTRPCRouter>>, FormSubmitFieldErrors, TRPCClientErrorLike<AnyTRPCRouter>>;
+//#endregion
+export { makeOnSubmitTrpcClientErrorHandler, trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer };

package/dist/tsdown/trpc.js

@@ -0,0 +1,47 @@
+import { TRPCClientError } from "@trpc/client";
+import { z } from "zod";
+//#region src/errors/trpc/trpcClientErrorMessageSchema.ts
+/**
+* Schema for {@link TRPCClientError} message.
+*
+* (Sent from backend as JSON string.)
+*/
+const trpcClientErrorMessageSchema = z.object({
+	code: z.string(),
+	message: z.string(),
+	path: z.array(z.string())
+}).passthrough();
+//#endregion
+//#region src/errors/trpc/trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer.ts
+/**
+* Schema that transforms {@link TRPCClientError} to RHF {@link FormSubmitFieldErrors}.
+*/
+const trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer = z.custom((error) => error instanceof TRPCClientError).transform((error) => error.message).transform((json) => {
+	try {
+		return JSON.parse(json);
+	} catch (error) {
+		return [{
+			validation: "root",
+			code: "server",
+			message: json,
+			path: ["root"]
+		}];
+	}
+}).pipe(z.array(trpcClientErrorMessageSchema)).transform((errors) => errors.map((error) => [error.path.join("."), {
+	type: error.code,
+	message: error.message
+}])).transform((errors) => Object.fromEntries(errors));
+//#endregion
+//#region src/errors/trpc/makeOnSubmitTrpcClientErrorHandler.ts
+/**
+* HOF that returns submit error handler for {@link RhfUtilsClientConfig.onSubmitErrorUnknown}.
+*
+* @param onError Fallback for handling non-TRPC errors.
+* @returns FormSubmitError
+*/
+const makeOnSubmitTrpcClientErrorHandler = (onNotTrpcClientError) => (error) => {
+	if (error instanceof TRPCClientError) return trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer.parse(error);
+	return onNotTrpcClientError(error);
+};
+//#endregion
+export { makeOnSubmitTrpcClientErrorHandler, trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer };

package/package.json

@@ -1,35 +1,18 @@
 {
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
-  "version": "0.65.0",
+  "version": "0.67.0",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
   "files": [
-    "dist/esm/*",
-    "dist/dts/*"
+    "dist/tsdown/*"
   ],
-  "module": "./dist/esm/index.mjs",
-  "types": "./dist/dts/_exports/types.d.ts",
   "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/dts/_exports/index.d.ts",
-        "default": "./dist/esm/index.mjs"
-      }
-    },
-    "./relay": {
-      "import": {
-        "types": "./dist/dts/_exports/relay.d.ts",
-        "default": "./dist/esm/relay.mjs"
-      }
-    },
-    "./trpc": {
-      "import": {
-        "types": "./dist/dts/_exports/trpc.d.ts",
-        "default": "./dist/esm/trpc.mjs"
-      }
-    }
+    ".": "./dist/tsdown/index.js",
+    "./relay": "./dist/tsdown/relay.js",
+    "./trpc": "./dist/tsdown/trpc.js",
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "withoutPublish": true,
@@ -92,6 +75,7 @@
     "rollup": "^4.61.1",
     "safe-stable-stringify": "^2.5.0",
     "terser": "^5.48.0",
+    "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "typescript-eslint": "8.61.0",
     "unplugin-dts": "^1.0.2",
@@ -127,7 +111,7 @@
     "zod"
   ],
   "scripts": {
-    "build": "tsc -b && vite build",
+    "build": "tsc -b && tsdown",
     "build:dev": "vite build --config vite.config.dev.ts",
     "dev": "vite --config vite.config.dev.ts --force",
     "lint": "eslint . --cache --cache-strategy content",

package/dist/dts/Register.d.ts

@@ -1,16 +0,0 @@
-/**
- * Use this to extend internal types.
- *
- * @example
- * ```ts
- * declare module '@paragrav/rhf-utils' {
- *   export interface Register {
- *     RhfUtilsFormOptions: {
- *       myCustomOption?: boolean;
- *     };
- *   }
- * }
- * ```
- */
-// eslint-disable-next-line @typescript-eslint/consistent-type-definitions, @typescript-eslint/no-empty-object-type
-export interface Register {}

package/dist/dts/_exports/config.d.ts

@@ -1,2 +0,0 @@
-export { RhfUtilsClientConfigProvider } from '../client/config/context/RhfUtilsClientConfigProvider';
-export type { RhfUtilsClientConfig } from '../client/config/RhfUtilsClientConfigType';

package/dist/dts/_exports/errors.d.ts

@@ -1,3 +0,0 @@
-export { useFlatFieldErrorsContext } from '../errors/flat/context/useFlatFieldErrorsContext';
-export { useFlatFieldErrorsContextHasOnlyOrphans } from '../errors/flat/context/useFlatFieldErrorsContextHasOnlyOrphans';
-export { RhfUtilsNonFieldErrorMarker } from '../errors/nonfield/RhfUtilsNonFieldErrorMarker';

package/dist/dts/_exports/form.d.ts

@@ -1,7 +0,0 @@
-export { useRhfUtilsContext } from '../form/context/utils/useRhfUtilsContext';
-export type { RhfUtilsFormOptions } from '../form/options/RhfUtilsFormOptionsType';
-export type { SafeFieldValues } from '../form/rhf/SafeFieldValuesType';
-export type { RHF_UseFormReturnWithoutProxies as UseFormReturnWithoutProxies } from '../form/RHF_UseFormReturnWithoutProxiesType';
-export type { RhfUtilsFormInjectorProps } from '../form/RhfUtilsFormInjectorProps';
-export type { UseRhfUtilsFormChildrenProps } from '../form/UseRhfUtilsFormChildrenPropsType';
-export { useFormRequestSubmit } from '../form/utils/useFormRequestSubmit';

package/dist/dts/_exports/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * @license @paragrav/rhf-utils
- *
- * Copyright (c) 2024-present paragrav.dev
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-export * from './config';
-export * from './errors';
-export * from './form';
-export * from './submit';
-export * from './zod';
-export type { Register } from '../Register';

package/dist/dts/_exports/relay.d.ts

@@ -1,7 +0,0 @@
-export { FormRelayContextProvider } from '../form/relay/context/FormRelayContextProvider';
-export type { FormRelayGroup } from '../form/relay/get/FormRelayGroupType';
-export { useFirstFormStateGroup } from '../form/relay/get/grouper/useFirstFormStateGroup';
-export { useFormRelayGroup, useFormRelayId, } from '../form/relay/get/useFormRelay';
-export { FormRelaySetter } from '../form/relay/set/FormRelaySetter';
-export { useFormRelaySet } from '../form/relay/set/useFormRelaySet';
-export type { FormRelay, FormRelayStateSelected } from '../form/relay/types';

package/dist/dts/_exports/submit.d.ts

@@ -1,4 +0,0 @@
-export { FormSubmitError } from '../submit/error/FormSubmitError';
-export type { FormSubmitFieldErrors } from '../submit/error/FormSubmitFieldErrors';
-export { useLastSubmitError } from '../submit/last-error/useLastSubmitError';
-export type { UseRhfUtilsFormOnSubmitContext, UseRhfUtilsFormOnSubmitErrorContext, } from '../submit/UseRhfUtilsFormOnSubmitContextType';

package/dist/dts/_exports/trpc.d.ts

@@ -1,2 +0,0 @@
-export { makeOnSubmitTrpcClientErrorHandler } from '../errors/trpc/makeOnSubmitTrpcClientErrorHandler';
-export { trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer } from '../errors/trpc/trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer';

package/dist/dts/_exports/types.d.ts

@@ -1,7 +0,0 @@
-export type * from './errors';
-export type * from './form';
-export type * from './relay';
-export type * from './submit';
-export type * from './trpc';
-export type * from './zod';
-export type { FlatFieldErrors } from '../errors/flat/types';

package/dist/dts/_exports/zod.d.ts

@@ -1,6 +0,0 @@
-export { RhfUtilsZodForm } from '../resolvers/zod/form/RhfUtilsZodForm';
-export { RhfUtilsZodFormProviders } from '../resolvers/zod/providers/RhfUtilsZodFormProviders';
-export { RhfUtilsZodFormWithProviders } from '../resolvers/zod/with-providers/RhfUtilsZodFormWithProviders';
-export type { RhfUtilsUseZodFormChildrenFC } from '../resolvers/zod/RhfUtilsUseZodFormChildrenFCType';
-export type { RhfUtilsUseZodFormChildrenProps } from '../resolvers/zod/RhfUtilsUseZodFormChildrenPropsType';
-export type { ZodTypeSafeFieldValues } from '../resolvers/zod/ZodTypeSafeFieldValuesType';

package/dist/dts/client/config/RhfUtilsClientConfigType.d.ts

@@ -1,71 +0,0 @@
-import { FlatFieldErrorsOutputConfig } from '../../errors/flat/context/FlatFieldErrorsOutputConfig';
-import { UseRhfUtilsFormGlobalDefaults } from '../../form/defaults/UseRhfUtilsFormGlobalDefaults';
-import { RhfUtilsFormInjectorProps } from '../../form/RhfUtilsFormInjectorProps';
-import { FormSubmitFieldErrors } from '../../submit/error/FormSubmitFieldErrors';
-import { UseRhfUtilsFormOnSubmitContext } from '../../submit/UseRhfUtilsFormOnSubmitContextType';
-import { MaybePromise } from '../../utils/types';
-/**
- * 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?: UseRhfUtilsFormGlobalDefaults;
-    /**
-     * Supply your own `<form>` component.
-     *
-     * (By default, a native {@link HTMLFormElement} is used.)
-     */
-    FormComponent?: React.FC<React.PropsWithChildren<React.HTMLAttributes<HTMLFormElement>>>;
-    /**
-     * Inject your own hooks, components, etc., into every form instance.
-     *
-     * @description
-     *
-     * (NOTE: context params are not schema-typed as not possible at this level.)
-     *
-     * @example
-     *
-     * See README.
-     */
-    FormInjector?: React.FC<RhfUtilsFormInjectorProps>;
-    /**
-     * A hook that returns a callback that determines whether form can be cancelled at event-time.
-     *
-     * @description
-     *
-     * Cancellation of forms often doesn't involve navigation, making it more challenging to centrally handle.
-     * Your hook's returned callback should internally prompt user and return response as `boolean`
-     * indicating whether cancellation should be blocked. See `README.md` for example.
-     *
-     * @returns Callback that, given {@link RhfUtilsFormContext} at event-time, returns `boolean` value indicating whether form can be cancelled.
-     *
-     * Callback should return:
-     * `true`: if form can be cancelled (e.g., form not dirty or user confirmed via prompt); {@link UseRhfUtilsFormProps.onCancel} is called.
-     * `false`: form cannot be cancelled (e.g., user denied); {@link UseRhfUtilsFormProps.onCancel} is not called.
-     */
-    useCanFormBeCancelled?: () => (props: UseRhfUtilsFormOnSubmitContext) => MaybePromise<boolean>;
-    /**
-     * 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;
-    /**
-     * Configuration regarding RHF form state errors (`useFormContext().formState.errors`).
-     */
-    fieldErrors?: {
-        /**
-         * Configure how/if errors should be outputted for debugging/reporting (i.e., console and/or throwing).
-         */
-        output?: FlatFieldErrorsOutputConfig;
-    };
-};

package/dist/dts/client/config/context/RhfUtilsClientConfigContext.d.ts

@@ -1,3 +0,0 @@
-import { default as React } from 'react';
-import { RhfUtilsClientConfig } from '../RhfUtilsClientConfigType';
-export declare const RhfUtilsClientConfigContext_Internal: React.Context<RhfUtilsClientConfig | undefined>;

package/dist/dts/client/config/context/RhfUtilsClientConfigProvider.d.ts

@@ -1,7 +0,0 @@
-import { default as React } from 'react';
-import { RhfUtilsClientConfig } from '../RhfUtilsClientConfigType';
-type Props = React.PropsWithChildren<{
-    config?: RhfUtilsClientConfig;
-}>;
-export declare const RhfUtilsClientConfigProvider: React.FC<Props>;
-export {};

package/dist/dts/client/config/context/useRhfUtilsClientConfig.d.ts

@@ -1 +0,0 @@
-export declare const useRhfUtilsClientConfig: () => import('../RhfUtilsClientConfigType').RhfUtilsClientConfig;

package/dist/dts/devtool/LazyDevTool.d.ts

@@ -1,10 +0,0 @@
-import { DevtoolUIProps } from '@hookform/devtools/dist/devToolUI';
-import { default as React } from 'react';
-type LazyDevToolProps = {
-    config?: boolean | Pick<DevtoolUIProps, 'placement' | 'styles'>;
-};
-/**
- * Lazy-loaded RHF DevTool.
- */
-export declare const LazyDevTool: React.FC<LazyDevToolProps>;
-export {};

package/dist/dts/devtool/LazyDevToolViaProviders.d.ts

@@ -1 +0,0 @@
-export declare const LazyDevToolViaProviders: React.FC;

package/dist/dts/errors/flat/FlatFieldErrorsList.d.ts

@@ -1,6 +0,0 @@
-import { FlatFieldErrors } from './types';
-export type Props = {
-    errors: FlatFieldErrors | null | undefined;
-    className?: string;
-};
-export declare const FlatFieldErrorsList: React.FC<Props>;

package/dist/dts/errors/flat/context/FlatFieldErrorsContextProvider.d.ts

@@ -1,10 +0,0 @@
-import { default as React } from 'react';
-type Props = React.PropsWithChildren<{
-    formRef: React.RefObject<HTMLFormElement | null>;
-}>;
-/**
- * Provides a flattened version of the form errors.
- * Allows flattening and filtering to happen once per errors change.
- */
-export declare const FlatFieldErrorsContextProvider: React.FC<Props>;
-export {};

package/dist/dts/errors/flat/context/FlatFieldErrorsOutputConfig.d.ts

@@ -1,19 +0,0 @@
-import { RhfUtilsErrorsOutputConsoleConfig } from '../../output/types';
-import { FlatFieldErrorsContext } from './useFlatFieldErrorsContext';
-export type FlatFieldErrorsOutputConfig = {
-    /**
-     * Configure how/if errors should be outputted to console.
-     *
-     * Example use cases:
-     * - console.debug errors in development environment.
-     * - console.error certain errors in production environment.
-     */
-    console?: (context: FlatFieldErrorsContext) => RhfUtilsErrorsOutputConsoleConfig | null | false | undefined;
-    /**
-     * Configure how/if errors should be thrown.
-     *
-     * Example use case:
-     * - bring attention to certain errors in development environment.
-     */
-    throw?: (context: FlatFieldErrorsContext) => true | string | false | undefined;
-};

package/dist/dts/errors/flat/context/useFlatFieldErrorsContext.d.ts

@@ -1,11 +0,0 @@
-import { FlatFieldErrors } from '../types';
-export type FlatFieldErrorsContext = {
-    all: FlatFieldErrors;
-    fields: FlatFieldErrors;
-    roots: FlatFieldErrors;
-    orphans: FlatFieldErrors;
-    hasErrors: boolean;
-    hasOrphans: boolean;
-};
-declare const _FormErrorsFlatContextProvider: import('react').Provider<FlatFieldErrorsContext | undefined>, useFlatFieldErrorsContext: () => FlatFieldErrorsContext;
-export { _FormErrorsFlatContextProvider, useFlatFieldErrorsContext };

package/dist/dts/errors/flat/context/useFlatFieldErrorsContextHasOnlyOrphans.d.ts

@@ -1,6 +0,0 @@
-/**
- * Returns `true` if all errors are orphans.
- *
- * You may want to treat this case specifically.
- */
-export declare const useFlatFieldErrorsContextHasOnlyOrphans: () => boolean;

package/dist/dts/errors/flat/context/useFlatFieldErrorsContextOutput.d.ts

@@ -1,5 +0,0 @@
-import { FlatFieldErrorsOutputConfig } from './FlatFieldErrorsOutputConfig';
-/**
- * Outputs (e.g., console, throw) errors based on config.
- */
-export declare const useFlatFieldErrorsContextOutput: (config?: FlatFieldErrorsOutputConfig) => void;

package/dist/dts/errors/flat/filterFlatFieldErrors.d.ts

@@ -1,7 +0,0 @@
-import { FlatFieldErrorEntry, FlatFieldErrors } from './types';
-/**
- * Filter {@link FlatFieldErrors} by a predicate.
- *
- * (Encapsulates to and from Object entries.)
- */
-export declare const makeFlatFieldErrorsFilter: (predicate: (entry: FlatFieldErrorEntry, index: number) => boolean) => (errors: FlatFieldErrors) => FlatFieldErrors;

package/dist/dts/errors/flat/flattenFieldErrors.d.ts

@@ -1,14 +0,0 @@
-import { FieldErrors } from 'react-hook-form';
-/**
- * Flatten a {@link FieldErrors} object.
- *
- * @returns e.g.,
- * ```ts
- * {
- *   "address.street.type": "too_short",
- *   "address.street.ref.value": "123",
- *   "address.street.message": "Required."
- * }
- * ```
- */
-export declare const flattenFieldErrors: (errors: FieldErrors) => Record<string, unknown>;

package/dist/dts/errors/flat/getFlatFieldErrors.d.ts

@@ -1,35 +0,0 @@
-import { FieldError, FieldErrors } from 'react-hook-form';
-import { SafeFieldValues } from '../../form/rhf/SafeFieldValuesType';
-import { FlatFieldErrors } from './types';
-/**
- * Get {@link FlatFieldErrors} from {@link FieldErrors}.
- * This makes it easy to work with potentially deeply-nested {@link FieldErrors}.
- *
- * @param errors {@link FieldErrors} object.
- *
- * @returns `FlatFieldErrors` object.
- *
- * @example
- * ```
- * {
- *   "address.street": {
- *     type: "too_short",
- *     ref: { value: "123" },
- *     message: "Required." }
- *   }
- * }
- * ```
- */
-export declare const getFlatFieldErrors: (errors: FieldErrors) => FlatFieldErrors;
-/**
- * Regular expression to maybe match the end of a leaf node path.
- *
- * i.e., `name.type`, `address.street.message`
- *
- * iow: dot [?: non-capturing]("type" | "message")[\b word boundary][$ end of string]
- */
-export declare const regexMaybeFieldErrorLeafNodeSuffix: RegExp;
-export type FieldErrorsSansRef<TFieldValues extends SafeFieldValues = SafeFieldValues> = Record<keyof TFieldValues | 'root', Partial<Pick<FieldError, 'message' | 'type'>> & {
-    hasRef: boolean;
-}>;
-export declare const getFlatFieldErrorsSansRef: <TFieldValues extends SafeFieldValues>(errors: FieldErrors<TFieldValues>) => FieldErrorsSansRef<TFieldValues>;

package/dist/dts/errors/flat/types.d.ts

@@ -1,16 +0,0 @@
-import { FieldError } from 'react-hook-form';
-/**
- * Flattened field errors object.
- *
- * @example
- * ```ts
- * {
- *   'address.street': FieldError
- * }
- * ```
- */
-export type FlatFieldErrors = Record<string, FieldError>;
-/**
- * Return from `Object.entries` on {@link FlatFieldErrors}.
- */
-export type FlatFieldErrorEntry = [path: string, error: FieldError];

package/dist/dts/errors/getRefdFromFlatFieldErrors.d.ts

@@ -1 +0,0 @@
-export declare const getRefdFromFlatFieldErrors: (errors: import('./flat/types').FlatFieldErrors) => import('./flat/types').FlatFieldErrors;

package/dist/dts/errors/isFieldErrorRefd.d.ts

@@ -1,5 +0,0 @@
-import { FieldError } from 'react-hook-form';
-/**
- * Determine if {@link FieldError} is a `ref`'d field error.
- */
-export declare const isFieldErrorRefd: (error: FieldError) => boolean;

package/dist/dts/errors/isFlatFieldErrorEntryRefd.d.ts

@@ -1,5 +0,0 @@
-import { FlatFieldErrorEntry } from './flat/types';
-/**
- * Determine if {@link FieldError} is a `ref`'d field error.
- */
-export declare const isFlatFieldErrorEntryRefd: ([, error,]: FlatFieldErrorEntry) => boolean;

package/dist/dts/errors/message/FormErrorMessage.d.ts

@@ -1,7 +0,0 @@
-import { default as React } from 'react';
-type Props = {
-    message: string;
-    className?: string;
-};
-export declare const FormErrorMessage: React.FC<Props>;
-export {};