remix-validated-form 4.1.1 → 4.1.4

package/build/internal/hooks-zustand.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSetTouched = exports.useClearError = exports.useFieldDefaultValue = exports.useFieldError = exports.useFieldTouched = exports.useHasActiveFormSubmit = exports.useDefaultValuesForForm = exports.useDefaultValuesFromLoader = exports.useFieldErrorsForForm = exports.useErrorResponseForForm = exports.useInternalFormContext = void 0;
+const react_1 = require("@remix-run/react");
+const get_1 = __importDefault(require("lodash/get"));
+const react_2 = require("react");
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const constants_1 = require("./constants");
+const formContext_1 = require("./formContext");
+const hydratable_1 = require("./hydratable");
+const state_zustand_1 = require("./state-zustand");
+const useInternalFormContext = (formId, hookName) => {
+    const formContext = (0, react_2.useContext)(formContext_1.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'.`);
+};
+exports.useInternalFormContext = useInternalFormContext;
+function useErrorResponseForForm({ fetcher, subaction, formId, }) {
+    var _a;
+    const actionData = (0, react_1.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;
+}
+exports.useErrorResponseForForm = useErrorResponseForForm;
+const useFieldErrorsForForm = (context) => {
+    const response = useErrorResponseForForm(context);
+    const hydrated = (0, state_zustand_1.useStore)((state) => state.form(context.formId).hydrated);
+    return hydratable_1.hydratable.from(response === null || response === void 0 ? void 0 : response.fieldErrors, hydrated);
+};
+exports.useFieldErrorsForForm = useFieldErrorsForForm;
+const useDefaultValuesFromLoader = ({ formId, }) => {
+    const matches = (0, react_1.useMatches)();
+    if (typeof formId === "string") {
+        const dataKey = (0, constants_1.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;
+};
+exports.useDefaultValuesFromLoader = useDefaultValuesFromLoader;
+const useDefaultValuesForForm = (context) => {
+    const { formId, defaultValuesProp } = context;
+    const hydrated = (0, state_zustand_1.useStore)((state) => state.form(formId).hydrated);
+    const errorResponse = useErrorResponseForForm(context);
+    const defaultValuesFromLoader = (0, exports.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_1.hydratable.hydratedData();
+    if (errorResponse === null || errorResponse === void 0 ? void 0 : errorResponse.repopulateFields) {
+        (0, tiny_invariant_1.default)(typeof errorResponse.repopulateFields === "object", "repopulateFields returned something other than an object");
+        return hydratable_1.hydratable.serverData(errorResponse.repopulateFields);
+    }
+    if (defaultValuesProp)
+        return hydratable_1.hydratable.serverData(defaultValuesProp);
+    return hydratable_1.hydratable.serverData(defaultValuesFromLoader);
+};
+exports.useDefaultValuesForForm = useDefaultValuesForForm;
+const useHasActiveFormSubmit = ({ fetcher, }) => {
+    const transition = (0, react_1.useTransition)();
+    const hasActiveSubmission = fetcher
+        ? fetcher.state === "submitting"
+        : !!transition.submission;
+    return hasActiveSubmission;
+};
+exports.useHasActiveFormSubmit = useHasActiveFormSubmit;
+const useFieldTouched = (name, { formId }) => {
+    return (0, state_zustand_1.useStore)((state) => state.form(formId).touchedFields[name]);
+};
+exports.useFieldTouched = useFieldTouched;
+const useFieldError = (name, context) => {
+    const state = (0, state_zustand_1.useStore)((state) => state.form(context.formId).fieldErrors[name]);
+    return (0, exports.useFieldErrorsForForm)(context)
+        .map((fieldErrors) => fieldErrors === null || fieldErrors === void 0 ? void 0 : fieldErrors[name])
+        .hydrateTo(state);
+};
+exports.useFieldError = useFieldError;
+const useFieldDefaultValue = (name, context) => {
+    const state = (0, state_zustand_1.useStore)((state) => state.form(context.formId).defaultValues[name]);
+    return (0, exports.useDefaultValuesForForm)(context)
+        .map((val) => (0, get_1.default)(val, name))
+        .hydrateTo(state);
+};
+exports.useFieldDefaultValue = useFieldDefaultValue;
+const useClearError = (context) => {
+    return (0, state_zustand_1.useStore)((state) => state.helpers(context.formId).clearError);
+};
+exports.useClearError = useClearError;
+const useSetTouched = (context) => {
+    return (0, state_zustand_1.useStore)((state) => state.helpers(context.formId).setTouched);
+};
+exports.useSetTouched = useSetTouched;

package/build/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/build/internal/hydratable.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydratable = void 0;
+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);
+exports.hydratable = {
+    serverData,
+    hydratedData,
+    from,
+};

package/build/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/build/internal/immerMiddleware.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.immer = void 0;
+const immer_1 = __importDefault(require("immer"));
+const immer = (config) => (set, get, api) => config((partial, replace) => {
+    const nextState = typeof partial === "function"
+        ? (0, immer_1.default)(partial)
+        : partial;
+    return set(nextState, replace);
+}, get, api);
+exports.immer = immer;

package/build/internal/logic/getCheckboxChecked.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCheckboxChecked = void 0;
 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/build/internal/logic/setFieldValue.js

@@ -17,17 +17,17 @@ const setElementValue = (element, value, name) => {
     }
     if (element instanceof HTMLInputElement && element.type === "checkbox") {
         const newChecked = (0, getCheckboxChecked_1.getCheckboxChecked)(element.value, value);
-        (0, tiny_invariant_1.default)(newChecked, `Unable to determine if checkbox should be checked. Provided value was ${value} for checkbox ${name}.`);
+        (0, tiny_invariant_1.default)(newChecked !== undefined, `Unable to determine if checkbox should be checked. Provided value was ${value} for checkbox ${name}.`);
         element.checked = newChecked;
         return;
     }
     if (element instanceof HTMLInputElement && element.type === "radio") {
         const newChecked = (0, getRadioChecked_1.getRadioChecked)(element.value, value);
-        (0, tiny_invariant_1.default)(newChecked, `Unable to determine if radio should be checked. Provided value was ${value} for radio ${name}.`);
+        (0, tiny_invariant_1.default)(newChecked !== undefined, `Unable to determine if radio should be checked. Provided value was ${value} for radio ${name}.`);
         element.checked = newChecked;
         return;
     }
-    (0, tiny_invariant_1.default)(typeof value === "string", `Must specify a string to set the value of ${element.constructor.name}`);
+    (0, tiny_invariant_1.default)(typeof value === "string", `Invalid value for field "${name}" which is an ${element.constructor.name}. Expected string but received ${typeof value}`);
     const input = element;
     input.value = value;
 };

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

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

package/build/internal/logic/setInputValueInForm.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setInputValueInForm = void 0;
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const getCheckboxChecked_1 = require("./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 ((0, getCheckboxChecked_1.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 ((0, getCheckboxChecked_1.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;
+    (0, tiny_invariant_1.default)(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);
+};
+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);
+    }
+};
+exports.setInputValueInForm = setInputValueInForm;

package/build/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/build/internal/setFormValues.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSetFormValues = void 0;
+const utils_1 = require("jotai/utils");
+const react_1 = require("react");
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const setInputValueInForm_1 = require("./logic/setInputValueInForm");
+const state_1 = require("./state");
+const controlledFields_1 = require("./state/controlledFields");
+const useSetFormValues = (formId) => (0, utils_1.useAtomCallback)((0, react_1.useCallback)(async (get, set, updatedValues) => {
+    const form = get((0, state_1.formElementAtom)(formId));
+    (0, tiny_invariant_1.default)(form, "Unable to access form element when setting field value. This is likely a bug in remix-validated-form.");
+    const controlledFields = get((0, controlledFields_1.controlledFieldsAtom)(formId));
+    const updatePromises = [];
+    for (const [field, value] of Object.entries(updatedValues)) {
+        const isControlled = !!controlledFields[field];
+        if (isControlled) {
+            updatePromises.push(set(controlledFields_1.setControlledFieldValueAtom, {
+                field,
+                formId,
+                value,
+            }));
+        }
+        else {
+            (0, setInputValueInForm_1.setInputValueInForm)(form, field, Array.isArray(value) ? value : [value]);
+        }
+    }
+    await Promise.all(updatePromises);
+}, [formId]), state_1.ATOM_SCOPE);
+exports.useSetFormValues = useSetFormValues;

package/build/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/build/internal/state/atomUtils.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fieldAtomFamily = exports.formAtomFamily = void 0;
+const jotai_1 = require("jotai");
+const utils_1 = require("jotai/utils");
+const isEqual_1 = __importDefault(require("lodash/isEqual"));
+const formAtomFamily = (data) => (0, utils_1.atomFamily)((_) => (0, jotai_1.atom)(data));
+exports.formAtomFamily = formAtomFamily;
+const fieldAtomFamily = (func) => (0, utils_1.atomFamily)(func, isEqual_1.default);
+exports.fieldAtomFamily = fieldAtomFamily;

package/build/internal/state/controlledFields.d.ts

@@ -0,0 +1,66 @@
+import { PrimitiveAtom } from "jotai";
+import { InternalFormId } from "./atomUtils";
+export declare type ValueSerializer = (val: unknown) => string;
+export declare const controlledFieldsAtom: {
+    (param: InternalFormId): import("jotai").Atom<Record<string, PrimitiveAtom<unknown>>> & {
+        write: (get: {
+            <Value>(atom: import("jotai").Atom<Value | Promise<Value>>): Value;
+            <Value_1>(atom: import("jotai").Atom<Promise<Value_1>>): Value_1;
+            <Value_2>(atom: import("jotai").Atom<Value_2>): Value_2 extends Promise<infer V> ? V : Value_2;
+        } & {
+            <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>, options: {
+                unstable_promise: true;
+            }): Value_3 | Promise<Value_3>;
+            <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>, options: {
+                unstable_promise: true;
+            }): Value_4 | Promise<Value_4>;
+            <Value_5>(atom: import("jotai").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: Record<string, PrimitiveAtom<unknown>> | ((prev: Record<string, PrimitiveAtom<unknown>>) => Record<string, PrimitiveAtom<unknown>>)) => void;
+        onMount?: (<S extends (update: Record<string, PrimitiveAtom<unknown>> | ((prev: Record<string, PrimitiveAtom<unknown>>) => Record<string, PrimitiveAtom<unknown>>)) => void>(setAtom: S) => void | (() => void)) | undefined;
+    } & {
+        init: Record<string, PrimitiveAtom<unknown>>;
+    };
+    remove(param: InternalFormId): void;
+    setShouldRemove(shouldRemove: ((createdAt: number, param: InternalFormId) => boolean) | null): void;
+};
+export declare const setControlledFieldValueAtom: import("jotai").Atom<null> & {
+    write: (get: {
+        <Value>(atom: import("jotai").Atom<Value | Promise<Value>>): Value;
+        <Value_1>(atom: import("jotai").Atom<Promise<Value_1>>): Value_1;
+        <Value_2>(atom: import("jotai").Atom<Value_2>): Value_2 extends Promise<infer V> ? V : Value_2;
+    } & {
+        <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>, options: {
+            unstable_promise: true;
+        }): Value_3 | Promise<Value_3>;
+        <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>, options: {
+            unstable_promise: true;
+        }): Value_4 | Promise<Value_4>;
+        <Value_5>(atom: import("jotai").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: {
+        formId: InternalFormId;
+        field: string;
+        value: unknown;
+    }) => Promise<void>;
+    onMount?: (<S extends (update: {
+        formId: InternalFormId;
+        field: string;
+        value: unknown;
+    }) => Promise<void>>(setAtom: S) => void | (() => void)) | undefined;
+} & {
+    init: null;
+};
+export declare const useAllControlledFields: (formId: InternalFormId) => Record<string, PrimitiveAtom<unknown>>;
+export declare const useControlledFieldValue: (formId: InternalFormId, field: string) => any;
+export declare const useControllableValue: (formId: InternalFormId, field: string) => readonly [any, (value: unknown) => Promise<void>];
+export declare const useFieldSerializer: (formId: InternalFormId, field: string) => ValueSerializer;
+export declare const useRegisterFieldSerializer: (formId: InternalFormId, field: string, serializer?: ValueSerializer | undefined) => void;

package/build/internal/state/controlledFields.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRegisterFieldSerializer = exports.useFieldSerializer = exports.useControllableValue = exports.useControlledFieldValue = exports.useAllControlledFields = exports.setControlledFieldValueAtom = exports.controlledFieldsAtom = void 0;
+const jotai_1 = require("jotai");
+const omit_1 = __importDefault(require("lodash/omit"));
+const react_1 = require("react");
+const hooks_1 = require("../hooks");
+const state_1 = require("../state");
+const atomUtils_1 = require("./atomUtils");
+exports.controlledFieldsAtom = (0, atomUtils_1.formAtomFamily)({});
+const refCountAtom = (0, atomUtils_1.fieldAtomFamily)(() => (0, jotai_1.atom)(0));
+const fieldValueAtom = (0, atomUtils_1.fieldAtomFamily)(() => (0, jotai_1.atom)(undefined));
+const fieldValueHydratedAtom = (0, atomUtils_1.fieldAtomFamily)(() => (0, jotai_1.atom)(false));
+const pendingValidateAtom = (0, atomUtils_1.fieldAtomFamily)(() => (0, jotai_1.atom)(undefined));
+const valueSerializerAtom = (0, atomUtils_1.fieldAtomFamily)(() => (0, jotai_1.atom)({ serializer: JSON.stringify }));
+const registerAtom = (0, jotai_1.atom)(null, (get, set, { formId, field }) => {
+    set(refCountAtom({ formId, field }), (prev) => prev + 1);
+    const newRefCount = get(refCountAtom({ formId, field }));
+    if (newRefCount === 1) {
+        set((0, exports.controlledFieldsAtom)(formId), (prev) => ({
+            ...prev,
+            [field]: fieldValueAtom({ formId, field }),
+        }));
+    }
+});
+const unregisterAtom = (0, jotai_1.atom)(null, (get, set, { formId, field }) => {
+    set(refCountAtom({ formId, field }), (prev) => prev - 1);
+    const newRefCount = get(refCountAtom({ formId, field }));
+    if (newRefCount === 0) {
+        set((0, exports.controlledFieldsAtom)(formId), (prev) => (0, omit_1.default)(prev, field));
+        fieldValueAtom.remove({ formId, field });
+        pendingValidateAtom.remove({ formId, field });
+    }
+});
+exports.setControlledFieldValueAtom = (0, jotai_1.atom)(null, async (_get, set, { formId, field, value, }) => {
+    set(fieldValueAtom({ formId, field }), value);
+    const pending = pendingValidateAtom({ formId, field });
+    await new Promise((resolve) => set(pending, resolve));
+    set(pending, undefined);
+});
+const useAllControlledFields = (formId) => (0, hooks_1.useFormAtomValue)((0, exports.controlledFieldsAtom)(formId));
+exports.useAllControlledFields = useAllControlledFields;
+const useControlledFieldValue = (formId, field) => {
+    const fieldAtom = fieldValueAtom({ formId, field });
+    const [value, setValue] = (0, hooks_1.useFormAtom)(fieldAtom);
+    const defaultValue = (0, hooks_1.useFieldDefaultValue)(field, { formId });
+    const isHydrated = (0, hooks_1.useFormAtomValue)((0, state_1.isHydratedAtom)(formId));
+    const [isFieldHydrated, setIsFieldHydrated] = (0, hooks_1.useFormAtom)(fieldValueHydratedAtom({ formId, field }));
+    (0, react_1.useEffect)(() => {
+        if (isHydrated && !isFieldHydrated) {
+            setValue({ formId, field, value: defaultValue });
+            setIsFieldHydrated(true);
+        }
+    }, [
+        defaultValue,
+        field,
+        formId,
+        isFieldHydrated,
+        isHydrated,
+        setIsFieldHydrated,
+        setValue,
+    ]);
+    return isFieldHydrated ? value : defaultValue;
+};
+exports.useControlledFieldValue = useControlledFieldValue;
+const useControllableValue = (formId, field) => {
+    const pending = (0, hooks_1.useFormAtomValue)(pendingValidateAtom({ formId, field }));
+    (0, react_1.useEffect)(() => {
+        pending === null || pending === void 0 ? void 0 : pending();
+    }, [pending]);
+    const register = (0, hooks_1.useFormUpdateAtom)(registerAtom);
+    const unregister = (0, hooks_1.useFormUpdateAtom)(unregisterAtom);
+    (0, react_1.useEffect)(() => {
+        register({ formId, field });
+        return () => unregister({ formId, field });
+    }, [field, formId, register, unregister]);
+    const setControlledFieldValue = (0, hooks_1.useFormUpdateAtom)(exports.setControlledFieldValueAtom);
+    const setValue = (0, react_1.useCallback)((value) => setControlledFieldValue({ formId, field, value }), [field, formId, setControlledFieldValue]);
+    const value = (0, exports.useControlledFieldValue)(formId, field);
+    return [value, setValue];
+};
+exports.useControllableValue = useControllableValue;
+const useFieldSerializer = (formId, field) => (0, hooks_1.useFormAtomValue)(valueSerializerAtom({ formId, field })).serializer;
+exports.useFieldSerializer = useFieldSerializer;
+const useRegisterFieldSerializer = (formId, field, serializer) => {
+    const setSerializer = (0, hooks_1.useFormUpdateAtom)(valueSerializerAtom({ formId, field }));
+    (0, react_1.useEffect)(() => {
+        if (serializer)
+            setSerializer({ serializer });
+    }, [serializer, setSerializer]);
+};
+exports.useRegisterFieldSerializer = useRegisterFieldSerializer;

package/build/internal/state-valtio.d.ts

@@ -0,0 +1,62 @@
+import { FieldErrors, TouchedFields } from "..";
+export declare type InternalFormState = {
+    hydrated: boolean;
+    fieldErrors: FieldErrors;
+    isSubmitting: boolean;
+    hasBeenSubmitted: boolean;
+    touchedFields: TouchedFields;
+    action?: string;
+    subaction?: string;
+    defaultValues: {
+        [fieldName: string]: any;
+    };
+    validateField: (fieldName: string) => Promise<string | null>;
+    registerReceiveFocus: (fieldName: string, handler: () => void) => () => void;
+    setFieldValue: (fieldName: string, value: unknown) => void;
+};
+declare type SyncFormArgs = {
+    defaultValues?: {
+        [fieldName: string]: any;
+    };
+    action?: string;
+    subaction?: string;
+    validateField: InternalFormState["validateField"];
+    registerReceiveFocus: InternalFormState["registerReceiveFocus"];
+    setFieldValueForForm: InternalFormState["setFieldValue"];
+};
+declare type StoreState = {
+    forms: {
+        [formId: string | symbol]: InternalFormState;
+    };
+};
+export declare const state: StoreState;
+export declare const registerFormSlice: (formId: string | symbol, { registerReceiveFocus, setFieldValueForForm, validateField, action, defaultValues, subaction, }: SyncFormArgs) => void;
+export declare const unregisterFormSlice: (formId: string | symbol) => void;
+export declare const useFormData: (formId: string | symbol) => {
+    readonly hydrated: boolean;
+    readonly fieldErrors: {
+        readonly [x: string]: string;
+    };
+    readonly isSubmitting: boolean;
+    readonly hasBeenSubmitted: boolean;
+    readonly touchedFields: {
+        readonly [x: string]: boolean;
+    };
+    readonly action?: string | undefined;
+    readonly subaction?: string | undefined;
+    readonly defaultValues: {
+        readonly [x: string]: any;
+    };
+    readonly validateField: (fieldName: string) => Promise<string | null>;
+    readonly registerReceiveFocus: (fieldName: string, handler: () => void) => () => void;
+    readonly setFieldValue: (fieldName: string, value: unknown) => void;
+};
+export declare const startSubmit: (formId: string | symbol) => void;
+export declare const endSubmit: (formId: string | symbol) => void;
+export declare const sync: (formId: string | symbol, { defaultValues, action, subaction, registerReceiveFocus, validateField, setFieldValueForForm, }: SyncFormArgs) => void;
+export declare const clearError: (formId: string | symbol, fieldName: string) => void;
+export declare const addError: (formId: string | symbol, fieldName: string, error: string) => void;
+export declare const setTouched: (formId: string | symbol, fieldName: string, touched: boolean) => void;
+export declare const reset: (formId: string | symbol) => void;
+export declare const setFieldErrors: (formId: string | symbol, fieldErrors: FieldErrors) => void;
+export {};