@paragrav/rhf-utils 0.64.0 → 0.66.0

package/README.md

@@ -9,7 +9,7 @@ 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 (`FormChildren`)
+  - inject your own hooks and UI (`FormInjector`)
   - server error transformation (`onSubmitErrorUnknown`) ✨
   - handle cancel prompt (`useCanFormBeCancelled`) ✨
   - RHF `FormState.errors` logging/throwing (`RhfUtilsClientConfig.fieldErrors`) ✨
@@ -76,7 +76,7 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
 
   // inject your own hooks and components
   // into all RhfUtilsZodForm instances
-  FormChildren: (
+  FormInjector: (
     // RhfUtilsFormInjectorProps
     {
       Outlet, //          Form instance (RhfUtilsZodForm.Children) "outlet"
@@ -116,6 +116,7 @@ export const rhfUtilsClientConfig: RhfUtilsClientConfig = {
   // (i.e., calling your own hook in `FormComponent`)
   useCanFormBeCancelled: () => {
     const { isDirty } = useFormState();
+    const myPrompter = useMyPrompter();
 
     // return callback to be called at event-time
     return ({ options }) =>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
-  "version": "0.64.0",
+  "version": "0.66.0",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -9,27 +9,11 @@
     "dist/esm/*",
     "dist/dts/*"
   ],
-  "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,
@@ -60,50 +44,53 @@
     }
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.5",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/config-helpers": "^0.6.0",
     "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^9.39.4",
-    "@playwright/experimental-ct-react": "^1.59.1",
-    "@playwright/test": "^1.59.1",
+    "@playwright/experimental-ct-react": "^1.60.0",
+    "@playwright/test": "^1.60.0",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^24.12.2",
-    "@typescript-eslint/eslint-plugin": "^8.59.0",
-    "@typescript-eslint/parser": "^8.59.0",
-    "@vitejs/plugin-react": "^6.0.1",
-    "clean-publish": "^6.0.5",
+    "@types/node": "^24.13.1",
+    "@typescript-eslint/eslint-plugin": "8.61.0",
+    "@typescript-eslint/parser": "8.61.0",
+    "@vitejs/plugin-react": "^6.0.2",
+    "clean-publish": "^7.1.0",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-alias": "^1.1.2",
-    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.2",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
-    "globals": "^17.5.0",
-    "happy-dom": "^20.9.0",
+    "eslint-plugin-simple-import-sort": "^13.0.0",
+    "globals": "^17.6.0",
+    "happy-dom": "^20.10.2",
     "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
-    "prettier": "^3.8.3",
-    "rollup": "^4.60.2",
+    "lint-staged": "^17.0.7",
+    "prettier": "^3.8.4",
+    "rollup": "^4.61.1",
     "safe-stable-stringify": "^2.5.0",
-    "terser": "^5.46.2",
+    "terser": "^5.48.0",
+    "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.0",
-    "vite": "^8.0.10",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.1.5"
+    "typescript-eslint": "8.61.0",
+    "unplugin-dts": "^1.0.2",
+    "vite": "^8.0.16",
+    "vitest": "^4.1.8"
   },
   "resolutions": {
+    "unrs-resolver": "1.11.1",
     "eslint": "^9.39.4",
     "@types/react": "^19.0.4",
     "@types/react-dom": "^19.0.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "typescript": "^6.0.2",
+    "typescript": "^6.0.3",
     "vite": "^8.0.2"
   },
   "repository": {
@@ -125,7 +112,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 {};

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

@@ -1,10 +0,0 @@
-type Props = {
-    /** Field name as flat path. (e.g., "address.street") */
-    path: string;
-    /** Optional component to use to display message. (Defaults to {@link FormErrorMessage}) */
-    Component?: React.FC<{
-        message: string;
-    }>;
-};
-export declare const RhfUtilsFieldErrorMessage: React.FC<Props>;
-export {};

package/dist/dts/errors/nonfield/RhfUtilsNonFieldErrorMarker.d.ts

@@ -1,13 +0,0 @@
-type Props = {
-    /** Flat field name. (e.g., `address.street`) */
-    path: string;
-};
-/**
- * Empty, hidden marker to indicate a non-field/non-root error is being displayed to user.
- *
- * 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.)
- */
-export declare const RhfUtilsNonFieldErrorMarker: React.FC<Props>;
-export {};

package/dist/dts/errors/nonfield/RhfUtilsNonFieldErrorMarker.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/dts/errors/nonfield/RhfUtilsNonFieldErrorMarker.utils.d.ts

@@ -1,18 +0,0 @@
-/**
- * Returns query selector for matching non-field error marker.
- * By default includes nested field matching. (See `options.excludeNested`.)
- *
- * @returns One or more selectors in a comma-separated list.
- */
-export declare const getRhfUtilsNonFieldErrorMarkerQuerySelector: (path: string, options?: {
-    /**
-     * Do not look for match as nested field.
-     *
-     * By default this is enabled to facilitate looking for fields that may be nested inside objects.
-     * This is only a problem when a front-end field is nested more deeply than back-end.
-     * For example, field arrays require objects as items, so actual field may be `field.value`.
-     * This should be safe, as fields are by definition leaf nodes, so will not have nested fields.
-     * (If this check should need to be more precise in the future, it may be ideal to distinguish between client/server errors or paths.)
-     */
-    excludeNested?: boolean;
-}) => string;

package/dist/dts/errors/nonfield/RhfUtilsNonFieldErrorMarkerHtmlAttribute.d.ts

@@ -1,4 +0,0 @@
-/**
- * HTML data attribute for {@link RhfUtilsNonFieldErrorMarker}.
- */
-export declare const RhfUtilsNonFieldErrorMarkerHtmlAttribute = "data-rhfutils-nonfield-error-marker-path";

package/dist/dts/errors/nonfield/isNonFieldError.d.ts

@@ -1,17 +0,0 @@
-import { FieldError } from 'react-hook-form';
-/**
- * Determine if {@link FieldError} is a non-field error (i.e., has no `ref`).
- *
- * A non-field error has no association to an input via {@link FieldError.ref}.
- *
- * These fall into one of two categories:
- * - Root, which are typically displayed to user at bottom/top of form.
- * - Non-root, which fall into two main sub-sets:
- *   - Non-orphan (displayed -- typically manually)
- *     - e.g., array min/max validation
- *   - Orphan (undisplayed), which are typically caused by one of the following cases:
- *      - The input is missing.
- *      - The schema is incorrect.
- *      - The error is not displayed to user with `FormErrorNonFieldMarker`.
- */
-export declare const isNonFieldError: (error: FieldError) => boolean;

package/dist/dts/errors/nonfield/isNonFieldErrorMarkerInDOM.d.ts

@@ -1,5 +0,0 @@
-/**
- * Determine if a non-field error marker is in the DOM.
- * Note: this will also look for nested markers to accommodate field arrays
- */
-export declare const isNonFieldErrorMarkerInDOM: (path: string, parentElement: Pick<HTMLElement, "querySelector">) => boolean;

package/dist/dts/errors/orphan/getIsOrphanFormErrorWithParentElement.d.ts

@@ -1,5 +0,0 @@
-import { FlatFieldErrorEntry } from '../flat/types';
-/**
- * Util wrapper for {@link isOrphanFormError} for usage with {@link FlatFieldErrorEntry}.
- */
-export declare const getIsFlatFieldErrorEntryOrphanByParentElement: (parentElement: Pick<HTMLElement, "querySelector">) => ([path, error]: FlatFieldErrorEntry) => boolean;

package/dist/dts/errors/orphan/getOrphansFromFlatFieldErrors.d.ts

@@ -1,2 +0,0 @@
-import { FlatFieldErrors } from '../flat/types';
-export declare const getOrphansFromFlatFieldErrors: (errors: FlatFieldErrors, parentElement: Pick<HTMLElement, "querySelector">) => FlatFieldErrors;

package/dist/dts/errors/orphan/isOrphanFormError.d.ts

@@ -1,2 +0,0 @@
-import { FieldError } from 'react-hook-form';
-export declare const isOrphanFormError: (path: string, error: FieldError, parentElement: Pick<HTMLElement, "querySelector">) => boolean;

package/dist/dts/errors/output/consoleErrors.d.ts

@@ -1,5 +0,0 @@
-import { SafeFieldValues } from '../../form/rhf/SafeFieldValuesType';
-/**
- * Output form values and errors to console.
- */
-export declare const consoleErrors: (message: string, values: SafeFieldValues, errors: Record<string, unknown>, type?: "debug" | "error") => void;

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

@@ -1,7 +0,0 @@
-/**
- * Config object for error output.
- */
-export type RhfUtilsErrorsOutputConsoleConfig = {
-    type?: 'debug' | 'error';
-    message?: string;
-};

package/dist/dts/errors/root/RootErrorsListFromFlatFieldErrorsContext.d.ts

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