remix-validated-form 4.1.1 → 4.1.4

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 $ npm run build:browser && npm run build:main
 
-> remix-validated-form@4.1.0 build:browser
+> remix-validated-form@4.1.2 build:browser
 > tsc --module ESNext --outDir ./browser
 
 
-> remix-validated-form@4.1.0 build:main
+> remix-validated-form@4.1.2 build:main
 > tsc --module CommonJS --outDir ./build
 

package/browser/ValidatedForm.js

@@ -187,9 +187,9 @@ export function ValidatedForm({ validator, onSubmit, children, fetcher, action,
                 clickedButtonRef.current = submitButton;
             }
         }
-        window.addEventListener("click", handleClick);
+        window.addEventListener("click", handleClick, { capture: true });
         return () => {
-            window.removeEventListener("click", handleClick);
+            window.removeEventListener("click", handleClick, { capture: true });
         };
     }, []);
     const handleSubmit = async (e) => {
@@ -209,10 +209,15 @@ export function ValidatedForm({ validator, onSubmit, children, fetcher, action,
                 endSubmit({ formAtom });
                 return;
             }
+            // We deviate from the remix code here a bit because of our async submit.
+            // In remix's `FormImpl`, they use `event.currentTarget` to get the form,
+            // but we already have the form in `formRef.current` so we can just use that.
+            // If we use `event.currentTarget` here, it will break because `currentTarget`
+            // will have changed since the start of the submission.
             if (fetcher)
-                fetcher.submit(clickedButtonRef.current || e.currentTarget);
+                fetcher.submit(clickedButtonRef.current || formRef.current);
             else
-                submit(clickedButtonRef.current || e.currentTarget, {
+                submit(clickedButtonRef.current || formRef.current, {
                     method,
                     replace,
                 });

package/browser/internal/hooks-valtio.d.ts

@@ -0,0 +1,18 @@
+import { useUpdateAtom } from "jotai/utils";
+import { FieldErrors, ValidationErrorResponseData } from "..";
+import { InternalFormContextValue } from "./formContext";
+import { Hydratable } from "./hydratable";
+export declare const useInternalFormContext: (formId?: string | symbol | undefined, hookName?: string | undefined) => InternalFormContextValue;
+export declare function useErrorResponseForForm({ fetcher, subaction, formId, }: InternalFormContextValue): ValidationErrorResponseData | null;
+export declare const useFieldErrorsForForm: (context: InternalFormContextValue) => Hydratable<FieldErrors | undefined>;
+export declare const useDefaultValuesFromLoader: ({ formId, }: InternalFormContextValue) => any;
+export declare const useDefaultValuesForForm: (context: InternalFormContextValue) => Hydratable<{
+    [fieldName: string]: any;
+}>;
+export declare const useHasActiveFormSubmit: ({ fetcher, }: InternalFormContextValue) => boolean;
+export declare const useFieldTouched: (name: string, { formId }: InternalFormContextValue) => boolean;
+export declare const useFieldError: (name: string, context: InternalFormContextValue) => string | undefined;
+export declare const useFieldDefaultValue: (name: string, context: InternalFormContextValue) => any;
+export declare const useFormUpdateAtom: typeof useUpdateAtom;
+export declare const useClearError: (context: InternalFormContextValue) => (name: string) => void;
+export declare const useSetTouched: (context: InternalFormContextValue) => (name: string, touched: boolean) => void;

package/browser/internal/hooks-valtio.js

@@ -0,0 +1,110 @@
+import { useActionData, useMatches, useTransition } from "@remix-run/react";
+import { useUpdateAtom } from "jotai/utils";
+import lodashGet from "lodash/get";
+import { useCallback, useContext } from "react";
+import invariant from "tiny-invariant";
+import { formDefaultValuesKey } from "./constants";
+import { InternalFormContext } from "./formContext";
+import { hydratable } from "./hydratable";
+import { ATOM_SCOPE, clearErrorAtom, formRegistry, setTouchedAtom, } from "./state";
+import { useFormData } from "./state-valtio";
+export const useInternalFormContext = (formId, hookName) => {
+    const formContext = useContext(InternalFormContext);
+    if (formId)
+        return { formId };
+    if (formContext)
+        return formContext;
+    throw new Error(`Unable to determine form for ${hookName}. Please use it inside a form or pass a 'formId'.`);
+};
+export function useErrorResponseForForm({ fetcher, subaction, formId, }) {
+    var _a;
+    const actionData = useActionData();
+    if (fetcher) {
+        if ((_a = fetcher.data) === null || _a === void 0 ? void 0 : _a.fieldErrors)
+            return fetcher.data;
+        return null;
+    }
+    if (!(actionData === null || actionData === void 0 ? void 0 : actionData.fieldErrors))
+        return null;
+    // If there's an explicit id, we should ignore data that has the wrong id
+    if (typeof formId === "string" && actionData.formId)
+        return actionData.formId === formId ? actionData : null;
+    if ((!subaction && !actionData.subaction) ||
+        actionData.subaction === subaction)
+        return actionData;
+    return null;
+}
+export const useFieldErrorsForForm = (context) => {
+    const response = useErrorResponseForForm(context);
+    const form = useFormData(context.formId);
+    return hydratable.from(response === null || response === void 0 ? void 0 : response.fieldErrors, form.hydrated);
+};
+export const useDefaultValuesFromLoader = ({ formId, }) => {
+    const matches = useMatches();
+    if (typeof formId === "string") {
+        const dataKey = formDefaultValuesKey(formId);
+        // If multiple loaders declare the same default values,
+        // we should use the data from the deepest route.
+        const match = matches
+            .reverse()
+            .find((match) => match.data && dataKey in match.data);
+        return match === null || match === void 0 ? void 0 : match.data[dataKey];
+    }
+    return null;
+};
+export const useDefaultValuesForForm = (context) => {
+    const { formId, defaultValuesProp } = context;
+    const form = useFormData(formId);
+    const errorResponse = useErrorResponseForForm(context);
+    const defaultValuesFromLoader = useDefaultValuesFromLoader(context);
+    // Typical flow is:
+    // - Default values only available from props or server
+    //   - Props have a higher priority than server
+    // - State gets hydrated with default values
+    // - After submit, we may need to use values from the error
+    if (form.hydrated)
+        return hydratable.hydratedData();
+    if (errorResponse === null || errorResponse === void 0 ? void 0 : errorResponse.repopulateFields) {
+        invariant(typeof errorResponse.repopulateFields === "object", "repopulateFields returned something other than an object");
+        return hydratable.serverData(errorResponse.repopulateFields);
+    }
+    if (defaultValuesProp)
+        return hydratable.serverData(defaultValuesProp);
+    return hydratable.serverData(defaultValuesFromLoader);
+};
+export const useHasActiveFormSubmit = ({ fetcher, }) => {
+    const transition = useTransition();
+    const hasActiveSubmission = fetcher
+        ? fetcher.state === "submitting"
+        : !!transition.submission;
+    return hasActiveSubmission;
+};
+export const useFieldTouched = (name, { formId }) => {
+    const form = useFormData(formId);
+    return form.touchedFields[name];
+};
+export const useFieldError = (name, context) => {
+    const fieldErrors = useFieldErrorsForForm(context);
+    const form = useFormData(context.formId);
+    return fieldErrors
+        .map((fieldErrors) => fieldErrors === null || fieldErrors === void 0 ? void 0 : fieldErrors[name])
+        .hydrateTo(form.fieldErrors[name]);
+};
+export const useFieldDefaultValue = (name, context) => {
+    const defaultValues = useDefaultValuesForForm(context);
+    const state = useFormData(context.formId);
+    return defaultValues.map((val) => lodashGet(val, name)).hydrateTo(state);
+};
+export const useFormUpdateAtom = (atom) => useUpdateAtom(atom, ATOM_SCOPE);
+export const useClearError = (context) => {
+    const clearError = useFormUpdateAtom(clearErrorAtom);
+    return useCallback((name) => {
+        clearError({ name, formAtom: formRegistry(context.formId) });
+    }, [clearError, context.formId]);
+};
+export const useSetTouched = (context) => {
+    const setTouched = useFormUpdateAtom(setTouchedAtom);
+    return useCallback((name, touched) => {
+        setTouched({ name, formAtom: formRegistry(context.formId), touched });
+    }, [setTouched, context.formId]);
+};

package/browser/internal/hooks-zustand.d.ts

@@ -0,0 +1,16 @@
+import { FieldErrors, ValidationErrorResponseData } from "..";
+import { InternalFormContextValue } from "./formContext";
+import { Hydratable } from "./hydratable";
+export declare const useInternalFormContext: (formId?: string | symbol | undefined, hookName?: string | undefined) => InternalFormContextValue;
+export declare function useErrorResponseForForm({ fetcher, subaction, formId, }: InternalFormContextValue): ValidationErrorResponseData | null;
+export declare const useFieldErrorsForForm: (context: InternalFormContextValue) => Hydratable<FieldErrors | undefined>;
+export declare const useDefaultValuesFromLoader: ({ formId, }: InternalFormContextValue) => any;
+export declare const useDefaultValuesForForm: (context: InternalFormContextValue) => Hydratable<{
+    [fieldName: string]: any;
+}>;
+export declare const useHasActiveFormSubmit: ({ fetcher, }: InternalFormContextValue) => boolean;
+export declare const useFieldTouched: (name: string, { formId }: InternalFormContextValue) => boolean;
+export declare const useFieldError: (name: string, context: InternalFormContextValue) => string | undefined;
+export declare const useFieldDefaultValue: (name: string, context: InternalFormContextValue) => any;
+export declare const useClearError: (context: InternalFormContextValue) => (name: string) => void;
+export declare const useSetTouched: (context: InternalFormContextValue) => (name: string, touched: boolean) => void;

package/browser/internal/hooks-zustand.js

@@ -0,0 +1,100 @@
+import { useActionData, useMatches, useTransition } from "@remix-run/react";
+import lodashGet from "lodash/get";
+import { useContext } from "react";
+import invariant from "tiny-invariant";
+import { formDefaultValuesKey } from "./constants";
+import { InternalFormContext } from "./formContext";
+import { hydratable } from "./hydratable";
+import { useStore } from "./state-zustand";
+export const useInternalFormContext = (formId, hookName) => {
+    const formContext = useContext(InternalFormContext);
+    if (formId)
+        return { formId };
+    if (formContext)
+        return formContext;
+    throw new Error(`Unable to determine form for ${hookName}. Please use it inside a form or pass a 'formId'.`);
+};
+export function useErrorResponseForForm({ fetcher, subaction, formId, }) {
+    var _a;
+    const actionData = useActionData();
+    if (fetcher) {
+        if ((_a = fetcher.data) === null || _a === void 0 ? void 0 : _a.fieldErrors)
+            return fetcher.data;
+        return null;
+    }
+    if (!(actionData === null || actionData === void 0 ? void 0 : actionData.fieldErrors))
+        return null;
+    // If there's an explicit id, we should ignore data that has the wrong id
+    if (typeof formId === "string" && actionData.formId)
+        return actionData.formId === formId ? actionData : null;
+    if ((!subaction && !actionData.subaction) ||
+        actionData.subaction === subaction)
+        return actionData;
+    return null;
+}
+export const useFieldErrorsForForm = (context) => {
+    const response = useErrorResponseForForm(context);
+    const hydrated = useStore((state) => state.form(context.formId).hydrated);
+    return hydratable.from(response === null || response === void 0 ? void 0 : response.fieldErrors, hydrated);
+};
+export const useDefaultValuesFromLoader = ({ formId, }) => {
+    const matches = useMatches();
+    if (typeof formId === "string") {
+        const dataKey = formDefaultValuesKey(formId);
+        // If multiple loaders declare the same default values,
+        // we should use the data from the deepest route.
+        const match = matches
+            .reverse()
+            .find((match) => match.data && dataKey in match.data);
+        return match === null || match === void 0 ? void 0 : match.data[dataKey];
+    }
+    return null;
+};
+export const useDefaultValuesForForm = (context) => {
+    const { formId, defaultValuesProp } = context;
+    const hydrated = useStore((state) => state.form(formId).hydrated);
+    const errorResponse = useErrorResponseForForm(context);
+    const defaultValuesFromLoader = useDefaultValuesFromLoader(context);
+    // Typical flow is:
+    // - Default values only available from props or server
+    //   - Props have a higher priority than server
+    // - State gets hydrated with default values
+    // - After submit, we may need to use values from the error
+    if (hydrated)
+        return hydratable.hydratedData();
+    if (errorResponse === null || errorResponse === void 0 ? void 0 : errorResponse.repopulateFields) {
+        invariant(typeof errorResponse.repopulateFields === "object", "repopulateFields returned something other than an object");
+        return hydratable.serverData(errorResponse.repopulateFields);
+    }
+    if (defaultValuesProp)
+        return hydratable.serverData(defaultValuesProp);
+    return hydratable.serverData(defaultValuesFromLoader);
+};
+export const useHasActiveFormSubmit = ({ fetcher, }) => {
+    const transition = useTransition();
+    const hasActiveSubmission = fetcher
+        ? fetcher.state === "submitting"
+        : !!transition.submission;
+    return hasActiveSubmission;
+};
+export const useFieldTouched = (name, { formId }) => {
+    return useStore((state) => state.form(formId).touchedFields[name]);
+};
+export const useFieldError = (name, context) => {
+    const state = useStore((state) => state.form(context.formId).fieldErrors[name]);
+    return useFieldErrorsForForm(context)
+        .map((fieldErrors) => fieldErrors === null || fieldErrors === void 0 ? void 0 : fieldErrors[name])
+        .hydrateTo(state);
+};
+export const useFieldDefaultValue = (name, context) => {
+    const state = useStore((state) => state.form(context.formId).defaultValues[name]);
+    return useDefaultValuesForForm(context)
+        .map((val) => lodashGet(val, name))
+        .hydrateTo(state);
+};
+export const useClearError = (context) => {
+    return useStore((state) => state.helpers(context.formId).clearError);
+};
+export const useSetTouched = (context) => {
+    return useStore((state) => state.helpers(context.formId).setTouched);
+};

package/browser/internal/hydratable.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The purpose of this type is to simplify the logic
+ * around data that needs to come from the server initially,
+ * but from the internal state after hydration.
+ */
+export declare type Hydratable<T> = {
+    hydrateTo: (data: T) => T;
+    map: <U>(fn: (data: T) => U) => Hydratable<U>;
+};
+export declare const hydratable: {
+    serverData: <T>(data: T) => Hydratable<T>;
+    hydratedData: <T_1>() => Hydratable<T_1>;
+    from: <T_2>(data: T_2, hydrated: boolean) => Hydratable<T_2>;
+};

package/browser/internal/hydratable.js

@@ -0,0 +1,14 @@
+const serverData = (data) => ({
+    hydrateTo: () => data,
+    map: (fn) => serverData(fn(data)),
+});
+const hydratedData = () => ({
+    hydrateTo: (hydratedData) => hydratedData,
+    map: () => hydratedData(),
+});
+const from = (data, hydrated) => hydrated ? hydratedData() : serverData(data);
+export const hydratable = {
+    serverData,
+    hydratedData,
+    from,
+};

package/browser/internal/immerMiddleware.d.ts

@@ -0,0 +1,6 @@
+import { Draft } from "immer";
+import { State, StateCreator } from "zustand";
+declare type TImmerConfigFn<T extends State> = (partial: ((draft: Draft<T>) => void) | T, replace?: boolean) => void;
+declare type TImmerConfig<T extends State> = StateCreator<T, TImmerConfigFn<T>>;
+export declare const immer: <T extends object>(config: TImmerConfig<T>) => StateCreator<T, import("zustand").SetState<T>, import("zustand").GetState<T>, import("zustand").StoreApi<T>>;
+export {};

package/browser/internal/immerMiddleware.js

@@ -0,0 +1,7 @@
+import produce from "immer";
+export const immer = (config) => (set, get, api) => config((partial, replace) => {
+    const nextState = typeof partial === "function"
+        ? produce(partial)
+        : partial;
+    return set(nextState, replace);
+}, get, api);

package/browser/internal/logic/getCheckboxChecked.js

@@ -1,6 +1,6 @@
 export const getCheckboxChecked = (checkboxValue = "on", newValue) => {
     if (Array.isArray(newValue))
-        return newValue.includes(checkboxValue);
+        return newValue.some((val) => val === true || val === checkboxValue);
     if (typeof newValue === "boolean")
         return newValue;
     if (typeof newValue === "string")

package/browser/internal/logic/setInputValueInForm.d.ts

@@ -0,0 +1 @@
+export declare const setInputValueInForm: (formElement: HTMLFormElement, name: string, value: unknown[]) => void;

package/browser/internal/logic/setInputValueInForm.js

@@ -0,0 +1,120 @@
+import invariant from "tiny-invariant";
+import { getCheckboxChecked } from "./getCheckboxChecked";
+/**
+ * Helper class to track the values being set on uncontrolled fields.
+ * HTML is super permissive with inputs that all share the same `name`.
+ *
+ * This class is strict in the sense that, if the user provides an array value,
+ * the values inside the array must be in the same order as the elements in the DOM.
+ * Doing this allows us to be flexible with what types of form controls the user is using.
+ *
+ * This is how HTML tracks inputs of the same name as well.
+ * `new FormData(formElement).getAll('myField')` will return values in DOM order.
+ */
+class Values {
+    constructor(values) {
+        this.hasSetRadioValue = false;
+        this.bool = (value) => {
+            if (getCheckboxChecked(value, this.values[0])) {
+                this.values.shift();
+                return true;
+            }
+            return false;
+        };
+        this.radio = (value) => {
+            if (this.hasSetRadioValue)
+                return false;
+            const result = this.bool(value);
+            if (result)
+                this.hasSetRadioValue = true;
+            return result;
+        };
+        this.str = () => { var _a; return String((_a = this.values.pop()) !== null && _a !== void 0 ? _a : ""); };
+        this.allValues = () => this.values;
+        this.warnIfLeftovers = (field) => {
+            if (this.values.length > 0) {
+                console.warn(`Could not determine how to use the value for the field ${field}. ` +
+                    `Leftover values were: ${this.values.join(", ")}.`);
+            }
+        };
+        const unknownValues = Array.isArray(values) ? values : [values];
+        this.values = unknownValues;
+    }
+}
+/**
+ * This subclass is order-permissive, meaning the user doesn't have to worry about
+ * the order in which the inputs occur in the DOM.
+ * This is useful for multiselects and checkbox groups and provides a better DX than
+ * the order-strict version.
+ */
+class PermissiveValues extends Values {
+    constructor() {
+        super(...arguments);
+        this.remove = (value) => {
+            const index = this.values.indexOf(value);
+            const deleted = this.values.splice(index, 1);
+            return deleted.length > 0;
+        };
+        this.bool = (value) => {
+            if (getCheckboxChecked(value, this.values)) {
+                this.remove(value) || this.remove(true);
+                return true;
+            }
+            return false;
+        };
+    }
+}
+const isMultiselect = (node) => node instanceof HTMLSelectElement && node.multiple;
+const isCheckbox = (node) => node instanceof HTMLInputElement && node.type === "checkbox";
+const isRadio = (node) => node instanceof HTMLInputElement && node.type === "radio";
+const setElementValue = (element, values, field) => {
+    if (isMultiselect(element)) {
+        for (const option of element.options) {
+            option.selected = values.bool(option.value);
+        }
+        return;
+    }
+    if (isCheckbox(element)) {
+        element.checked = values.bool(element.value);
+        return;
+    }
+    if (isRadio(element)) {
+        element.checked = values.radio(element.value);
+        return;
+    }
+    const input = element;
+    invariant(input.type !== "hidden", `Cannot set value on hidden input if it is not a controlled field. Field being updated was ${field}.`);
+    input.value = values.str();
+};
+const areElementsTheSameType = (nodes) => {
+    const getType = (node) => {
+        if (node instanceof HTMLInputElement)
+            return node.type;
+        if (node instanceof HTMLSelectElement)
+            return node.multiple ? "select" : "multiselect";
+        return null;
+    };
+    const firstElementInstance = nodes[0].constructor;
+    const firstElementType = getType(nodes[0]);
+    return nodes.every((element) => element.constructor === firstElementInstance &&
+        getType(element) === firstElementType);
+};
+export const setInputValueInForm = (formElement, name, value) => {
+    const controlElement = formElement.elements.namedItem(name);
+    if (!controlElement)
+        return;
+    if (controlElement instanceof RadioNodeList) {
+        const values = areElementsTheSameType([...controlElement])
+            ? new PermissiveValues(value)
+            : new Values(value);
+        for (const element of controlElement) {
+            setElementValue(element, values, name);
+        }
+        values.warnIfLeftovers(name);
+    }
+    else {
+        const values = new PermissiveValues(value);
+        setElementValue(controlElement, values, name);
+        values.warnIfLeftovers(name);
+    }
+};

package/browser/internal/setFieldValue.d.ts

@@ -0,0 +1,20 @@
+import { InternalFormId } from "./state/atomUtils";
+declare type ControlledDataItem = Record<string, unknown[]>;
+declare class ValidatedFormData {
+    #private;
+    constructor(formData: FormData, customData: ControlledDataItem);
+    get: (fieldName: string) => any;
+    getAll: (fieldName: string) => any[];
+    has: (fieldName: string) => boolean;
+    append: (fieldName: string, value: any) => void;
+    delete: (fieldName: string) => void;
+    set: (fieldName: string, value: any) => void;
+    entries: () => IterableIterator<[string, any[]]>;
+    values: () => IterableIterator<any[]>;
+    [Symbol.iterator]: () => IterableIterator<[string, any[]]>;
+    setRepeated: (fieldName: string, value: any[]) => void;
+    changedFields(): Generator<readonly [string, any[]], void, unknown>;
+}
+export declare type FormValuesUpdater = (formData: ValidatedFormData) => void;
+export declare const useSetFormValues: (formId: InternalFormId) => (arg: FormValuesUpdater) => Promise<void>;
+export {};

package/browser/internal/setFieldValue.js

@@ -0,0 +1,83 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ValidatedFormData_data, _ValidatedFormData_updates, _a;
+import { useAtomCallback } from "jotai/utils";
+import groupBy from "lodash/groupBy";
+import mapValues from "lodash/mapValues";
+import invariant from "tiny-invariant";
+import { setInputValueInForm } from "./logic/setInputValueInForm";
+import { MultiValueMap } from "./MultiValueMap";
+import { ATOM_SCOPE, formElementAtom } from "./state";
+import { controlledFieldsAtom, setControlledFieldValueAtom, } from "./state/controlledFields";
+class ValidatedFormData {
+    constructor(formData, customData) {
+        _ValidatedFormData_data.set(this, new MultiValueMap());
+        _ValidatedFormData_updates.set(this, new Map());
+        // API to mimic form data
+        this.get = (fieldName) => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").getAll(fieldName)[0];
+        this.getAll = (fieldName) => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").getAll(fieldName);
+        this.has = (fieldName) => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").has(fieldName);
+        this.append = (fieldName, value) => {
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").add(fieldName, value);
+        };
+        this.delete = (fieldName) => {
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").delete(fieldName);
+            __classPrivateFieldGet(this, _ValidatedFormData_updates, "f").set(fieldName, true);
+        };
+        this.set = (fieldName, value) => {
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").delete(fieldName);
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").add(fieldName, value);
+            __classPrivateFieldGet(this, _ValidatedFormData_updates, "f").set(fieldName, true);
+        };
+        this.entries = () => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").entries();
+        this.values = () => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").values();
+        this[_a] = () => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").entries();
+        // Custom APIs
+        this.setRepeated = (fieldName, value) => {
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").delete(fieldName);
+            value.forEach((val) => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").add(fieldName, val));
+            __classPrivateFieldGet(this, _ValidatedFormData_updates, "f").set(fieldName, true);
+        };
+        for (const [key, value] of formData.entries()) {
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").add(key, value);
+        }
+        Object.entries(customData).forEach(([name, values]) => {
+            __classPrivateFieldGet(this, _ValidatedFormData_data, "f").delete(name);
+            values.forEach((value) => __classPrivateFieldGet(this, _ValidatedFormData_data, "f").add(name, value));
+        });
+    }
+    *changedFields() {
+        for (const updatedField of __classPrivateFieldGet(this, _ValidatedFormData_updates, "f").keys()) {
+            const value = this.getAll(updatedField);
+            yield [updatedField, value];
+        }
+    }
+}
+_ValidatedFormData_data = new WeakMap(), _ValidatedFormData_updates = new WeakMap(), _a = Symbol.iterator;
+export const useSetFormValues = (formId) => useAtomCallback(async (get, set, update) => {
+    var _b;
+    const form = get(formElementAtom(formId));
+    invariant(form, "Unable to access form element when setting field value. This is likely a bug in remix-validated-form.");
+    const formData = new FormData(form);
+    const controlledFields = get(controlledFieldsAtom(formId));
+    const controlledData = mapValues(groupBy(controlledFields, (field) => field.name), (val) => val.map((field) => get(field.valueAtom)));
+    const validatedFormData = new ValidatedFormData(formData, controlledData);
+    update(validatedFormData);
+    for (const [field, value] of validatedFormData.changedFields()) {
+        const relevantFields = controlledFields.filter(({ name }) => name === field);
+        if (relevantFields.length === 0) {
+            setInputValueInForm(form, field, value);
+            return;
+        }
+        for (const [index, field] of relevantFields.entries()) {
+            const itemValue = (_b = value[index]) !== null && _b !== void 0 ? _b : "";
+            await set(setControlledFieldValueAtom, {
+                internalFieldId: field.internalId,
+                value: itemValue,
+            });
+        }
+    }
+}, ATOM_SCOPE);

package/browser/internal/setFormValues.d.ts

@@ -0,0 +1,2 @@
+import { InternalFormId } from "./state/atomUtils";
+export declare const useSetFormValues: (formId: InternalFormId) => (arg: Record<string, unknown>) => Promise<void>;

package/browser/internal/setFormValues.js

@@ -0,0 +1,26 @@
+import { useAtomCallback } from "jotai/utils";
+import { useCallback } from "react";
+import invariant from "tiny-invariant";
+import { setInputValueInForm } from "./logic/setInputValueInForm";
+import { ATOM_SCOPE, formElementAtom } from "./state";
+import { controlledFieldsAtom, setControlledFieldValueAtom, } from "./state/controlledFields";
+export const useSetFormValues = (formId) => useAtomCallback(useCallback(async (get, set, updatedValues) => {
+    const form = get(formElementAtom(formId));
+    invariant(form, "Unable to access form element when setting field value. This is likely a bug in remix-validated-form.");
+    const controlledFields = get(controlledFieldsAtom(formId));
+    const updatePromises = [];
+    for (const [field, value] of Object.entries(updatedValues)) {
+        const isControlled = !!controlledFields[field];
+        if (isControlled) {
+            updatePromises.push(set(setControlledFieldValueAtom, {
+                field,
+                formId,
+                value,
+            }));
+        }
+        else {
+            setInputValueInForm(form, field, Array.isArray(value) ? value : [value]);
+        }
+    }
+    await Promise.all(updatePromises);
+}, [formId]), ATOM_SCOPE);

package/browser/internal/state/atomUtils.d.ts

@@ -0,0 +1,38 @@
+import { Atom } from "jotai";
+export declare type InternalFormId = string | symbol;
+export declare const formAtomFamily: <T>(data: T) => {
+    (param: InternalFormId): Atom<T> & {
+        write: (get: {
+            <Value>(atom: Atom<Value | Promise<Value>>): Value;
+            <Value_1>(atom: Atom<Promise<Value_1>>): Value_1;
+            <Value_2>(atom: Atom<Value_2>): Value_2 extends Promise<infer V> ? V : Value_2;
+        } & {
+            <Value_3>(atom: Atom<Value_3 | Promise<Value_3>>, options: {
+                unstable_promise: true;
+            }): Value_3 | Promise<Value_3>;
+            <Value_4>(atom: Atom<Promise<Value_4>>, options: {
+                unstable_promise: true;
+            }): Value_4 | Promise<Value_4>;
+            <Value_5>(atom: Atom<Value_5>, options: {
+                unstable_promise: true;
+            }): (Value_5 extends Promise<infer V> ? V : Value_5) | Promise<Value_5 extends Promise<infer V> ? V : Value_5>;
+        }, set: {
+            <Value_6, Result extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_6, undefined, Result>): Result;
+            <Value_7, Update, Result_1 extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_7, Update, Result_1>, update: Update): Result_1;
+        }, update: T | ((prev: T) => T)) => void;
+        onMount?: (<S extends import("jotai/core/atom").SetAtom<T | ((prev: T) => T), void>>(setAtom: S) => void | (() => void)) | undefined;
+    } & {
+        init: T;
+    };
+    remove(param: InternalFormId): void;
+    setShouldRemove(shouldRemove: ((createdAt: number, param: InternalFormId) => boolean) | null): void;
+};
+export declare type FieldAtomKey = {
+    formId: InternalFormId;
+    field: string;
+};
+export declare const fieldAtomFamily: <T extends Atom<unknown>>(func: (key: FieldAtomKey) => T) => {
+    (param: FieldAtomKey): T;
+    remove(param: FieldAtomKey): void;
+    setShouldRemove(shouldRemove: ((createdAt: number, param: FieldAtomKey) => boolean) | null): void;
+};

package/browser/internal/state/atomUtils.js

@@ -0,0 +1,5 @@
+import { atom } from "jotai";
+import { atomFamily } from "jotai/utils";
+import isEqual from "lodash/isEqual";
+export const formAtomFamily = (data) => atomFamily((_) => atom(data));
+export const fieldAtomFamily = (func) => atomFamily(func, isEqual);