@paragrav/rhf-utils 0.61.0 → 0.63.0

package/dist/esm/relay.mjs

@@ -1,222 +1,49 @@
-import { jsx as v } from "react/jsx-runtime";
-import a from "react";
-import { c as V, i as f, a as x, u as R, b as M } from "./getFlatFieldErrors.mjs";
-import { useFormState as h } from "react-hook-form";
-const {
-  Provider: j,
-  useRequired: y
-} = V(), p = (s) => s.reduce(
-  (t, e) => ({
-    // booleans
-    isDirty: t.isDirty || e.state.isDirty,
-    isSubmitting: t.isSubmitting || e.state.isSubmitting,
-    isLoading: t.isLoading || e.state.isLoading,
-    isSubmitted: t.isSubmitted || e.state.isSubmitted,
-    isSubmitSuccessful: t.isSubmitSuccessful || e.state.isSubmitSuccessful,
-    isValidating: t.isValidating || e.state.isValidating,
-    isValid: t.isValid || e.state.isValid,
-    isReady: t.isReady || e.state.isReady,
-    disabled: t.disabled || e.state.disabled,
-    // objects
-    errors: t.errors || !f(e.state.errors),
-    dirtyFields: t.dirtyFields || !f(e.state.dirtyFields),
-    touchedFields: t.touchedFields || !f(e.state.touchedFields),
-    validatingFields: t.validatingFields || !f(e.state.validatingFields),
-    // counts
-    submitCount: t.submitCount + e.state.submitCount,
-    // composites
-    isSubmitUnsuccessful: t.isSubmitUnsuccessful || e.state.isSubmitted && !e.state.isSubmitSuccessful,
-    isMountedFlagged: t.isMountedFlagged || !!e.options?.flaggedState?.isMounted
-  }),
-  // initial values
-  {
-    isDirty: !1,
-    isSubmitting: !1,
-    isLoading: !1,
-    isSubmitted: !1,
-    isSubmitSuccessful: !1,
-    isValidating: !1,
-    isReady: !1,
-    isValid: !1,
-    disabled: !1,
-    // objects
-    errors: !1,
-    dirtyFields: !1,
-    touchedFields: !1,
-    validatingFields: !1,
-    // counts
-    submitCount: 0,
-    // composites
-    isSubmitUnsuccessful: !1,
-    isMountedFlagged: !1
-  }
-), A = ({
-  children: s
-}) => {
-  const [t, e] = a.useState({}), o = a.useCallback(
-    (i, l, r) => {
-      if (t[l.formId]) throw new Error("Form id already exists.");
-      e((m) => ({
-        ...m,
-        [l.formId]: { state: i, utils: l, options: r }
-      }));
-    },
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    []
-  ), n = a.useCallback((i, l) => {
-    e((r) => {
-      const m = r[i];
-      if (!m) throw new Error("Form id doesn't exist");
-      return {
-        ...r,
-        [i]: { ...m, state: l }
-      };
-    });
-  }, []), u = a.useCallback((i) => {
-    e(
-      (l) => Object.fromEntries(
-        Object.entries(l).filter(([r]) => r !== i)
-      )
-    );
-  }, []), d = a.useCallback((i) => t[i], [t]), b = a.useCallback(() => {
-    const i = Object.values(t);
-    if (i.length > 1) throw new Error("More than one form.");
-    return i[0];
-  }, [t]), S = P(t), F = a.useCallback(
-    (i) => S[i],
-    [S]
-  ), c = E(t);
-  return /* @__PURE__ */ v(
-    j,
-    {
-      value: {
-        // push
-        add: o,
-        update: n,
-        remove: u,
-        // pull
-        get: d,
-        getOnly: b,
-        getGroup: F,
-        any: c
-      },
-      children: s
-    }
-  );
-}, E = (s) => a.useMemo(
-  () => p(Object.values(s)),
-  [s]
-), P = (s) => a.useMemo(() => {
-  const t = Object.values(s).reduce(
-    (o, n) => (
-      // wrap (to flatten -- instead of distinguishing between `undefined|string|string[]`)
-      [n.options?.group].filter((u) => !!u).flat().reduce(
-        (u, d) => ({
-          ...u,
-          // existing list of states for this group PLUS this form
-          [d]: [...u[d] ?? [], n]
-        }),
-        // initial value (parent accumulator)
-        o
-      )
-    ),
-    // initial value
-    {}
-  );
-  return Object.fromEntries(
-    Object.entries(t).map(([o, n]) => [
-      // preserve key
-      o,
-      // condense states to "any" for this group
-      p(n)
-    ])
-  );
-}, [s]), w = () => y().getOnly(), q = () => y().any, J = (s) => y().get(s), N = (s) => y().getGroup(s), T = () => {
-  const s = x();
-  if (s)
-    return {
-      state: h(),
-      utils: s
-    };
-  const t = w();
-  return t && // normalize for compatibility with rhf above
-  {
-    state: t.state,
-    utils: t.utils
-  };
-}, G = (s) => {
-  const [t] = a.useState(s);
-  U(t), k();
-}, U = (s) => {
-  const t = R(), e = y(), o = C();
-  a.useEffect(
-    () => (e.add(o, t, s), () => {
-      e.remove(t.formId);
-    }),
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    []
-  );
-}, k = () => {
-  const s = R(), t = y(), e = C();
-  a.useEffect(
-    // when form state changes, publish to relay context
-    () => {
-      t.update(s.formId, e);
-    },
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [e]
-  );
-}, C = () => {
-  const {
-    errors: s,
-    isDirty: t,
-    isSubmitting: e,
-    isValid: o,
-    isReady: n,
-    isSubmitted: u,
-    isSubmitSuccessful: d,
-    dirtyFields: b,
-    disabled: S,
-    isLoading: F,
-    isValidating: c,
-    submitCount: i,
-    touchedFields: l,
-    validatingFields: r,
-    defaultValues: m
-  } = h(), g = {
-    errors: s,
-    isDirty: t,
-    isSubmitting: e,
-    isValid: o,
-    isReady: n,
-    isSubmitted: u,
-    isSubmitSuccessful: d,
-    dirtyFields: b,
-    disabled: S,
-    isLoading: F,
-    isValidating: c,
-    submitCount: i,
-    touchedFields: l,
-    validatingFields: r,
-    defaultValues: m
-  }, O = JSON.stringify({
-    ...g,
-    errors: M(s)
-  });
-  return a.useMemo(
-    // when watch JSON changes, update memo
-    () => g,
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [O]
-  );
-}, W = (s) => (G(s), null);
-export {
-  A as FormStateRelayContextProvider,
-  W as FormStateRelayPusher,
-  q as useFormStateRelayPullAny,
-  J as useFormStateRelayPullById,
-  N as useFormStateRelayPullGroup,
-  w as useFormStateRelayPullOnlyOrThrow,
-  G as useFormStateRelayPusher,
-  T as useFormStateWithUtilsViaRhfOrRelay
+import { c as e, i as t, l as n, n as r, s as i, t as a, u as o } from "./FormRelaySetter.mjs";
+import s from "react";
+import { useFormState as c } from "react-hook-form";
+//#region src/form/relay/context/utils.ts
+var l = (e) => e.reduce((e, n) => ({
+	isDirty: e.isDirty || n.isDirty,
+	isSubmitting: e.isSubmitting || n.isSubmitting,
+	isLoading: e.isLoading || n.isLoading,
+	isSubmitted: e.isSubmitted || n.isSubmitted,
+	isSubmitSuccessful: e.isSubmitSuccessful || n.isSubmitSuccessful,
+	isValidating: e.isValidating || n.isValidating,
+	isValid: e.isValid || n.isValid,
+	isReady: e.isReady || n.isReady,
+	disabled: e.disabled || n.disabled,
+	hasErrors: e.hasErrors || n.errors && !t(n.errors),
+	hasDirtyFields: e.hasDirtyFields || n.dirtyFields && !t(n.dirtyFields),
+	hasTouchedFields: e.hasTouchedFields || n.touchedFields && !t(n.touchedFields),
+	hasValidatingFields: e.hasValidatingFields || n.validatingFields && !t(n.validatingFields),
+	submitCount: (e.submitCount ?? 0) + (n.submitCount ?? 0),
+	isMounted: e.isMounted || n.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
+}), u = (e) => n().state[e], d = (e) => {
+	let t = n().state, r = l(f(t, e).map(({ state: e }) => e)), i = JSON.stringify(r);
+	return s.useMemo(() => r, [i]);
+}, f = (e, t) => Object.values(e).filter(({ options: e, utils: n }) => !t || "groups" in t && t.groups.filter((t) => e.groups?.includes(t)).length || "predicate" in t && t.predicate({
+	groups: e.groups,
+	options: n.options
+})), { Provider: p, useRequired: m, useMaybe: h } = o(), g = () => {
+	if (i()) return l([c()]);
+	let e = h();
+	return e ? e.state : d();
 };
+//#endregion
+export { e as FormRelayContextProvider, a as FormRelaySetter, g as useFirstFormStateGroup, d as useFormRelayGroup, u as useFormRelayId, r as useFormRelaySet };

package/dist/esm/trpc.mjs

@@ -1,40 +1,24 @@
-import { TRPCClientError as s } from "@trpc/client";
-import { z as e } from "zod";
-const a = e.object({
-  code: e.string(),
-  message: e.string(),
-  path: e.array(e.string())
-}).passthrough(), o = e.custom(
-  (r) => r instanceof s
-  // check instance type
-).transform((r) => r.message).transform((r) => {
-  try {
-    return JSON.parse(r);
-  } catch {
-    return [
-      {
-        validation: "root",
-        code: "server",
-        message: r,
-        path: ["root"]
-      }
-    ];
-  }
-}).pipe(e.array(a)).transform(
-  (r) => r.map(
-    (t) => [
-      t.path.join("."),
-      // flatten path (e.g., "street.name")
-      {
-        type: t.code,
-        message: t.message
-      }
-    ]
-  )
-).transform((r) => Object.fromEntries(r)), i = (r) => (t) => t instanceof s ? o.parse(
-  t
-) : r(t);
-export {
-  i as makeOnSubmitTrpcClientErrorHandler,
-  o as trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer
-};
+import { TRPCClientError as e } from "@trpc/client";
+import { z as t } from "zod";
+//#region src/errors/trpc/trpcClientErrorMessageSchema.ts
+var n = t.object({
+	code: t.string(),
+	message: t.string(),
+	path: t.array(t.string())
+}).passthrough(), r = t.custom((t) => t instanceof e).transform((e) => e.message).transform((e) => {
+	try {
+		return JSON.parse(e);
+	} catch {
+		return [{
+			validation: "root",
+			code: "server",
+			message: e,
+			path: ["root"]
+		}];
+	}
+}).pipe(t.array(n)).transform((e) => e.map((e) => [e.path.join("."), {
+	type: e.code,
+	message: e.message
+}])).transform((e) => Object.fromEntries(e)), i = (t) => (n) => n instanceof e ? r.parse(n) : t(n);
+//#endregion
+export { i as makeOnSubmitTrpcClientErrorHandler, r as trpcClientErrorToFormSubmitFieldErrorsSchemaTransformer };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
-  "version": "0.61.0",
+  "version": "0.63.0",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,
@@ -60,19 +60,19 @@
     }
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.1",
-    "@eslint/eslintrc": "^3.3.3",
-    "@eslint/js": "^9.39.2",
-    "@playwright/experimental-ct-react": "^1.57.0",
-    "@playwright/test": "^1.57.0",
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^9.39.4",
+    "@playwright/experimental-ct-react": "^1.58.2",
+    "@playwright/test": "^1.58.2",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^24.10.8",
-    "@typescript-eslint/eslint-plugin": "^8.53.0",
-    "@typescript-eslint/parser": "^8.53.0",
-    "@vitejs/plugin-react": "^5.1.2",
-    "clean-publish": "^6.0.1",
+    "@types/node": "^24.12.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
+    "@vitejs/plugin-react": "^6.0.1",
+    "clean-publish": "^6.0.4",
     "cross-env": "^10.1.0",
-    "eslint": "^9.39.2",
+    "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-alias": "^1.1.2",
     "eslint-import-resolver-typescript": "^4.4.4",
@@ -81,31 +81,30 @@
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.26",
+    "eslint-plugin-react-refresh": "^0.5.2",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "globals": "^17.0.0",
-    "happy-dom": "^20.1.0",
+    "globals": "^17.4.0",
+    "happy-dom": "^20.8.8",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "prettier": "^3.7.4",
-    "rollup": "^4.55.1",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.8.1",
+    "rollup": "^4.60.0",
     "safe-stable-stringify": "^2.5.0",
-    "terser": "^5.44.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.53.0",
-    "vite": "^7.3.1",
+    "terser": "^5.46.1",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.57.2",
+    "vite": "^8.0.2",
     "vite-plugin-dts": "^4.5.4",
-    "vite-tsconfig-paths": "^6.0.4",
-    "vitest": "^4.0.17"
+    "vitest": "^4.1.1"
   },
   "resolutions": {
-    "esbuild": "^0.25.0",
-    "eslint": "^9.22.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
+    "eslint": "^9.39.4",
     "@types/react": "^19.0.4",
     "@types/react-dom": "^19.0.2",
-    "vite": "^7.1.3"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.2"
   },
   "repository": {
     "type": "git",

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

@@ -1,7 +0,0 @@
-import { FormState } from 'react-hook-form';
-import { RhfUtilsContextProps } from './context/utils/RhfUtilsContextPropsType';
-import { SafeFieldValues } from './rhf/SafeFieldValuesType';
-export type RhfUtilsFormStateWithUtilsType<TFieldValues extends SafeFieldValues = SafeFieldValues> = {
-    state: FormState<TFieldValues>;
-    utils: RhfUtilsContextProps;
-};

package/dist/dts/form/state/relay/FormStateRelayedAggregatedType.d.ts

@@ -1,10 +0,0 @@
-import { Merge } from '../../../utils/types';
-import { FormStateRelayed } from './FormStateRelayedType';
-export type FormStateRelayedAggregated = Merge<Omit<FormStateRelayed, 'defaultValues'>, Record<Extract<keyof FormStateRelayed, 'dirtyFields' | 'touchedFields' | 'validatingFields' | 'errors'>, boolean> & {
-    /** Sum of all submit counts. */
-    submitCount: number;
-    /** Any submitted and not successful? */
-    isSubmitUnsuccessful: boolean;
-    /** Consider form flagged when mounted. (Corresponds to {@link FormStateRelayedOptions.flaggedState.isMounted}.) */
-    isMountedFlagged: boolean;
-}>;

package/dist/dts/form/state/relay/FormStateRelayedItemType.d.ts

@@ -1,11 +0,0 @@
-import { SafeFieldValues } from '../../rhf/SafeFieldValuesType';
-import { RhfUtilsFormStateWithUtilsType } from '../../RhfUtilsFormStateWithUtilsType';
-import { FormStateRelayedOptions } from './FormStateRelayedOptionsType';
-import { FormStateRelayed } from './FormStateRelayedType';
-export type FormStateRelayedItem<TFieldValues extends SafeFieldValues = SafeFieldValues> = {
-    state: FormStateRelayed<TFieldValues>;
-    options?: FormStateRelayedOptions;
-};
-export type FormStateRelayedItemWithUtils<TFieldValues extends SafeFieldValues = SafeFieldValues> = RhfUtilsFormStateWithUtilsType<TFieldValues> & {
-    options?: FormStateRelayedOptions;
-};

package/dist/dts/form/state/relay/FormStateRelayedOptionsType.d.ts

@@ -1,20 +0,0 @@
-export type FormStateRelayedOptions = {
-    /**
-     * Arbitrary group name(s) for this form.
-     *
-     * Think of it like class or category names.
-     * (e.g., "parent" or "children")
-     */
-    group?: string | string[];
-    /**
-     * Denote certain state(s) as flagged.
-     */
-    flaggedState?: {
-        /**
-         * Flag when mounted.
-         *
-         * (e.g., forms that are unmounted by default)
-         */
-        isMounted?: true;
-    };
-};

package/dist/dts/form/state/relay/FormStateRelayedType.d.ts

@@ -1,3 +0,0 @@
-import { FormState } from 'react-hook-form';
-import { SafeFieldValues } from '../../rhf/SafeFieldValuesType';
-export type FormStateRelayed<TFieldValues extends SafeFieldValues = SafeFieldValues> = FormState<TFieldValues>;

package/dist/dts/form/state/relay/pull/hooks.d.ts

@@ -1,31 +0,0 @@
-import { SafeFieldValues } from '../../../rhf/SafeFieldValuesType';
-import { RhfUtilsFormStateWithUtilsType } from '../../../RhfUtilsFormStateWithUtilsType';
-import { FormStateRelayedAggregated } from '../FormStateRelayedAggregatedType';
-import { FormStateRelayedItemWithUtils } from '../FormStateRelayedItemType';
-/**
- * Watch only form -- without worrying about ID.
- *
- * @throws If more than one form is being tracked.
- */
-export declare const useFormStateRelayPullOnlyOrThrow: () => FormStateRelayedItemWithUtils | undefined;
-/**
- * Watch all forms via {@link FormStateRelayedAggregated}.
- */
-export declare const useFormStateRelayPullAny: () => FormStateRelayedAggregated;
-/**
- * Watch single form's state.
- *
- * @param formId Watched form identifier.
- */
-export declare const useFormStateRelayPullById: (formId: string) => FormStateRelayedItemWithUtils | undefined;
-/**
- * Compute single boolean for group's form state to denote whether it's flagged via default algorithm.
- * (i.e., is dirty or submitting or submit unsuccessful or mounted flagged)
- *
- * @param group Group name to watch.
- */
-export declare const useFormStateRelayPullGroup: (group: string) => FormStateRelayedAggregated | undefined;
-/**
- * Use form state with utils either through RHF or relay.
- */
-export declare const useFormStateWithUtilsViaRhfOrRelay: <TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues>() => RhfUtilsFormStateWithUtilsType<TFieldValues> | undefined;

package/dist/dts/form/state/relay/push/FormStateRelayPusher.d.ts

@@ -1,4 +0,0 @@
-import { FormStateRelayPushOptions } from './useFormStateRelayPusher';
-type Props = FormStateRelayPushOptions;
-export declare const FormStateRelayPusher: React.FC<Props>;
-export {};

package/dist/dts/form/state/relay/push/useFormStateRelayPusher.d.ts

@@ -1,3 +0,0 @@
-import { FormStateRelayedOptions } from '../FormStateRelayedOptionsType';
-export type FormStateRelayPushOptions = FormStateRelayedOptions;
-export declare const useFormStateRelayPusher: (options?: FormStateRelayPushOptions) => void;

package/dist/dts/form/state/relay/useFormStateRelayContext.d.ts

@@ -1,20 +0,0 @@
-import { RhfUtilsContextProps } from '../../context/utils/RhfUtilsContextPropsType';
-import { FormStateRelayedAggregated } from './FormStateRelayedAggregatedType';
-import { FormStateRelayedItemWithUtils } from './FormStateRelayedItemType';
-import { FormStateRelayedOptions } from './FormStateRelayedOptionsType';
-import { FormStateRelayed } from './FormStateRelayedType';
-export type FormStateRelayContext = {
-    add: (state: FormStateRelayed, utils: RhfUtilsContextProps, options?: FormStateRelayedOptions) => void;
-    update: (id: string, state: FormStateRelayed) => void;
-    remove: (id: string) => void;
-    /**
-     * Get form state by ID.
-     *
-     * @throws Error if not found.
-     */
-    get: (id: string) => FormStateRelayedItemWithUtils | undefined;
-    getOnly: () => FormStateRelayedItemWithUtils | undefined;
-    any: FormStateRelayedAggregated;
-    getGroup: (group: string) => FormStateRelayedAggregated | undefined;
-};
-export declare const _FormStateRelayContextProvider: import('react').Provider<FormStateRelayContext | undefined>, useFormStateRelayContext: () => FormStateRelayContext;

package/dist/dts/form/state/relay/utils.d.ts

@@ -1,4 +0,0 @@
-import { FormStateRelayedAggregated } from './FormStateRelayedAggregatedType';
-import { FormStateRelayedItem } from './FormStateRelayedItemType';
-/** Condense list of form states to singular booleans. */
-export declare const getFormContextRelayReducedFormState: (forms: FormStateRelayedItem[]) => FormStateRelayedAggregated;

package/dist/esm/getFlatFieldErrors.mjs

@@ -1,55 +0,0 @@
-import a from "react";
-import { get as c } from "react-hook-form";
-import { flatten as f } from "flat";
-function d() {
-  const e = a.createContext(void 0), r = () => a.useContext(e), s = () => {
-    const t = r();
-    if (t === void 0) throw new Error();
-    return t;
-  };
-  return {
-    Provider: e.Provider,
-    useMaybe: r,
-    useRequired: s
-  };
-}
-const {
-  Provider: x,
-  useRequired: g,
-  useMaybe: E
-} = d(), h = (e) => Object.keys(e).length === 0, u = (e) => f(e), b = (e) => {
-  const r = u(e), s = Object.keys(r);
-  return Object.fromEntries(
-    s.reduce(
-      (t, n) => {
-        const o = n.replace(
-          l,
-          ""
-        );
-        if (o === n) return t;
-        const i = c(e, o, void 0);
-        return i && t.push([o, i]), t;
-      },
-      []
-      // entries
-    )
-  );
-}, l = /\.(?:type|message)\b$/, v = (e) => Object.fromEntries(
-  Object.entries(b(e)).map(([r, s]) => [
-    r,
-    {
-      type: s.type,
-      message: s.message
-      // strip out ref, etc. (avoid circular JSON error)
-    }
-  ])
-);
-export {
-  x as _,
-  E as a,
-  v as b,
-  d as c,
-  b as g,
-  h as i,
-  g as u
-};