remix-validated-form 4.1.0-beta.2 → 4.1.2

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

@@ -0,0 +1,47 @@
+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 Helpers = {
+    startSubmit: () => void;
+    endSubmit: () => void;
+    sync: (args: SyncFormArgs) => void;
+    clearError: (name: string) => void;
+    addError: (name: string, error: string) => void;
+    setTouched: (name: string, touched: boolean) => void;
+    reset: () => void;
+    setFieldErrors: (fieldErrors: FieldErrors) => void;
+    register: (init: SyncFormArgs) => void;
+    unregister: () => 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;
+    };
+    form: (formId: string | symbol) => InternalFormState;
+    helpers: (formId: string | symbol) => Helpers;
+};
+export declare const useStore: import("zustand").UseBoundStore<StoreState, import("zustand").StoreApi<StoreState>>;
+export {};

package/browser/internal/state-zustand.js

@@ -0,0 +1,85 @@
+import create from "zustand";
+import { immer } from "./immerMiddleware";
+const unhydratedFormState = {
+    hydrated: false,
+    fieldErrors: {},
+    isSubmitting: false,
+    hasBeenSubmitted: false,
+    touchedFields: {},
+    defaultValues: {},
+    validateField: () => Promise.resolve(null),
+    registerReceiveFocus: () => () => { },
+    setFieldValue: () => { },
+    // clearError: () => {},
+    // addError: () => {},
+    // setTouched: () => {},
+    // reset: () => {},
+    // startSubmit: () => {},
+    // endSubmit: () => {},
+    // sync: () => {},
+    // setFieldErrors: () => {},
+};
+export const useStore = create(immer((set, get) => ({
+    forms: {},
+    form: (formId) => { var _a; return (_a = get().forms[formId]) !== null && _a !== void 0 ? _a : unhydratedFormState; },
+    helpers: (formId) => ({
+        clearError: (name) => set((state) => {
+            delete state.forms[formId].fieldErrors[name];
+        }),
+        addError: (name, error) => set((state) => {
+            state.forms[formId].fieldErrors[name] = error;
+        }),
+        setTouched: (name, touched) => set((state) => {
+            state.forms[formId].touchedFields[name] = touched;
+        }),
+        reset: () => set((state) => {
+            state.forms[formId].fieldErrors = {};
+            state.forms[formId].touchedFields = {};
+            state.forms[formId].hasBeenSubmitted = false;
+        }),
+        startSubmit: () => set((state) => {
+            state.forms[formId].hasBeenSubmitted = true;
+            state.forms[formId].isSubmitting = true;
+        }),
+        endSubmit: () => set((state) => {
+            state.forms[formId].isSubmitting = false;
+        }),
+        setFieldErrors: (fieldErrors) => {
+            set((state) => {
+                state.forms[formId].fieldErrors = fieldErrors;
+            });
+        },
+        sync: ({ defaultValues, action, subaction, validateField, registerReceiveFocus, setFieldValueForForm, }) => set((state) => {
+            state.forms[formId].defaultValues = defaultValues !== null && defaultValues !== void 0 ? defaultValues : {};
+            state.forms[formId].action = action;
+            state.forms[formId].subaction = subaction;
+            state.forms[formId].registerReceiveFocus = registerReceiveFocus;
+            state.forms[formId].validateField = validateField;
+            state.forms[formId].hydrated = true;
+            state.forms[formId].setFieldValue = setFieldValueForForm;
+        }),
+        unregister: () => {
+            set((state) => {
+                delete state.forms[formId];
+            });
+        },
+        register: ({ defaultValues, action, subaction, validateField, registerReceiveFocus, setFieldValueForForm, }) => {
+            set((state) => {
+                state.forms[formId] = {
+                    defaultValues: defaultValues !== null && defaultValues !== void 0 ? defaultValues : {},
+                    setFieldValue: setFieldValueForForm,
+                    registerReceiveFocus,
+                    validateField,
+                    action,
+                    subaction,
+                    hydrated: true,
+                    fieldErrors: {},
+                    isSubmitting: false,
+                    hasBeenSubmitted: false,
+                    touchedFields: {},
+                    // helpers
+                };
+            });
+        },
+    }),
+})));

package/browser/internal/util.d.ts

@@ -2,3 +2,4 @@ import type React from "react";
 export declare const omit: (obj: any, ...keys: string[]) => any;
 export declare const mergeRefs: <T = any>(refs: (React.MutableRefObject<T> | React.LegacyRef<T> | undefined)[]) => (instance: T | null) => void;
 export declare const useIsomorphicLayoutEffect: typeof React.useEffect;
+export declare const useDeepEqualsMemo: <T>(item: T) => T;

package/browser/internal/util.js

@@ -1,4 +1,5 @@
-import { useEffect, useLayoutEffect } from "react";
+import isEqual from "lodash/isEqual";
+import { useEffect, useLayoutEffect, useRef } from "react";
 export const omit = (obj, ...keys) => {
     const result = { ...obj };
     for (const key of keys) {
@@ -19,3 +20,13 @@ export const mergeRefs = (refs) => {
     };
 };
 export const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+export const useDeepEqualsMemo = (item) => {
+    const ref = useRef(item);
+    const areEqual = ref.current === item || isEqual(ref.current, item);
+    useEffect(() => {
+        if (!areEqual) {
+            ref.current = item;
+        }
+    });
+    return areEqual ? ref.current : item;
+};

package/build/ValidatedForm.d.ts

@@ -47,4 +47,4 @@ export declare type FormProps<DataType> = {
 /**
  * The primary form component of `remix-validated-form`.
  */
-export declare function ValidatedForm<DataType>({ validator, onSubmit, children, fetcher, action, defaultValues: providedDefaultValues, formRef: formRefProp, onReset, subaction, resetAfterSubmit, disableFocusOnError, method, replace, id, ...rest }: FormProps<DataType>): JSX.Element;
+export declare function ValidatedForm<DataType>({ validator, onSubmit, children, fetcher, action, defaultValues: unMemoizedDefaults, formRef: formRefProp, onReset, subaction, resetAfterSubmit, disableFocusOnError, method, replace, id, ...rest }: FormProps<DataType>): JSX.Element;

package/build/ValidatedForm.js

@@ -116,13 +116,19 @@ function formEventProxy(event) {
         },
     });
 }
+const useFormAtom = (formId) => {
+    const formAtom = (0, state_1.formRegistry)(formId);
+    (0, react_2.useEffect)(() => () => state_1.formRegistry.remove(formId), [formId]);
+    return formAtom;
+};
 /**
  * The primary form component of `remix-validated-form`.
  */
-function ValidatedForm({ validator, onSubmit, children, fetcher, action, defaultValues: providedDefaultValues, formRef: formRefProp, onReset, subaction, resetAfterSubmit = false, disableFocusOnError, method, replace, id, ...rest }) {
+function ValidatedForm({ validator, onSubmit, children, fetcher, action, defaultValues: unMemoizedDefaults, formRef: formRefProp, onReset, subaction, resetAfterSubmit = false, disableFocusOnError, method, replace, id, ...rest }) {
     var _a;
     const formId = useFormId(id);
-    const formAtom = (0, state_1.formRegistry)(formId);
+    const formAtom = useFormAtom(formId);
+    const providedDefaultValues = (0, util_1.useDeepEqualsMemo)(unMemoizedDefaults);
     const contextValue = (0, react_2.useMemo)(() => ({
         formId,
         action,

package/build/internal/MultiValueMap.js

@@ -34,11 +34,11 @@ class MultiValueMap {
 exports.MultiValueMap = MultiValueMap;
 const useMultiValueMap = () => {
     const ref = (0, react_1.useRef)(null);
-    return () => {
+    return (0, react_1.useCallback)(() => {
         if (ref.current)
             return ref.current;
         ref.current = new MultiValueMap();
         return ref.current;
-    };
+    }, []);
 };
 exports.useMultiValueMap = useMultiValueMap;

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

@@ -0,0 +1,128 @@
+"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.useFormUpdateAtom = 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 utils_1 = require("jotai/utils");
+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_1 = require("./state");
+const state_valtio_1 = require("./state-valtio");
+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 form = (0, state_valtio_1.useFormData)(context.formId);
+    return hydratable_1.hydratable.from(response === null || response === void 0 ? void 0 : response.fieldErrors, form.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 form = (0, state_valtio_1.useFormData)(formId);
+    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 (form.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 }) => {
+    const form = (0, state_valtio_1.useFormData)(formId);
+    return form.touchedFields[name];
+};
+exports.useFieldTouched = useFieldTouched;
+const useFieldError = (name, context) => {
+    const fieldErrors = (0, exports.useFieldErrorsForForm)(context);
+    const form = (0, state_valtio_1.useFormData)(context.formId);
+    return fieldErrors
+        .map((fieldErrors) => fieldErrors === null || fieldErrors === void 0 ? void 0 : fieldErrors[name])
+        .hydrateTo(form.fieldErrors[name]);
+};
+exports.useFieldError = useFieldError;
+const useFieldDefaultValue = (name, context) => {
+    const defaultValues = (0, exports.useDefaultValuesForForm)(context);
+    const state = (0, state_valtio_1.useFormData)(context.formId);
+    return defaultValues.map((val) => (0, get_1.default)(val, name)).hydrateTo(state);
+};
+exports.useFieldDefaultValue = useFieldDefaultValue;
+const useFormUpdateAtom = (atom) => (0, utils_1.useUpdateAtom)(atom, state_1.ATOM_SCOPE);
+exports.useFormUpdateAtom = useFormUpdateAtom;
+const useClearError = (context) => {
+    const clearError = (0, exports.useFormUpdateAtom)(state_1.clearErrorAtom);
+    return (0, react_2.useCallback)((name) => {
+        clearError({ name, formAtom: (0, state_1.formRegistry)(context.formId) });
+    }, [clearError, context.formId]);
+};
+exports.useClearError = useClearError;
+const useSetTouched = (context) => {
+    const setTouched = (0, exports.useFormUpdateAtom)(state_1.setTouchedAtom);
+    return (0, react_2.useCallback)((name, touched) => {
+        setTouched({ name, formAtom: (0, state_1.formRegistry)(context.formId), touched });
+    }, [setTouched, context.formId]);
+};
+exports.useSetTouched = useSetTouched;

package/build/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/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.d.ts

@@ -0,0 +1 @@
+export declare const getCheckboxChecked: (checkboxValue: string | undefined, newValue: unknown) => boolean | undefined;

package/build/internal/logic/getCheckboxChecked.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCheckboxChecked = void 0;
+const getCheckboxChecked = (checkboxValue = "on", newValue) => {
+    if (Array.isArray(newValue))
+        return newValue.includes(checkboxValue);
+    if (typeof newValue === "boolean")
+        return newValue;
+    if (typeof newValue === "string")
+        return newValue === checkboxValue;
+    return undefined;
+};
+exports.getCheckboxChecked = getCheckboxChecked;

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

@@ -0,0 +1 @@
+export declare const getRadioChecked: (radioValue: string | undefined, newValue: unknown) => boolean | undefined;

package/build/internal/logic/getRadioChecked.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRadioChecked = void 0;
+const getRadioChecked = (radioValue = "on", newValue) => {
+    if (typeof newValue === "string")
+        return newValue === radioValue;
+    return undefined;
+};
+exports.getRadioChecked = getRadioChecked;

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

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

package/build/internal/logic/setFieldValue.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setFieldValue = void 0;
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const getCheckboxChecked_1 = require("./getCheckboxChecked");
+const getRadioChecked_1 = require("./getRadioChecked");
+const setElementValue = (element, value, name) => {
+    if (element instanceof HTMLSelectElement && element.multiple) {
+        (0, tiny_invariant_1.default)(Array.isArray(value), "Must specify an array to set the value for a multi-select");
+        for (const option of element.options) {
+            option.selected = value.includes(option.value);
+        }
+        return;
+    }
+    if (element instanceof HTMLInputElement && element.type === "checkbox") {
+        const newChecked = (0, getCheckboxChecked_1.getCheckboxChecked)(element.value, value);
+        (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 !== 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", `Invalid value for field "${name}" which is an ${element.constructor.name}. Expected string but received ${typeof value}`);
+    const input = element;
+    input.value = value;
+};
+const setFieldValue = (formElement, name, value) => {
+    const controlElement = formElement.elements.namedItem(name);
+    if (!controlElement)
+        return;
+    if (controlElement instanceof RadioNodeList) {
+        for (const element of controlElement) {
+            setElementValue(element, value, name);
+        }
+    }
+    else {
+        setElementValue(controlElement, value, name);
+    }
+};
+exports.setFieldValue = setFieldValue;

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

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