@paragrav/rhf-utils 0.66.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,13 +1,12 @@
 {
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
-  "version": "0.66.0",
+  "version": "0.67.0",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
   "files": [
-    "dist/esm/*",
-    "dist/dts/*"
+    "dist/tsdown/*"
   ],
   "exports": {
     ".": "./dist/tsdown/index.js",