@homebound/form-state 2.2.13 → 2.5.0

package/dist/FormStateApp.js

@@ -20,7 +20,7 @@ function FormStateApp() {
                 return state.firstName.value === state.lastName.value ? "Last name cannot equal first name" : undefined;
             });
         },
-        autoSave() {
+        async autoSave() {
             console.log("saving", formState.changedValue);
         },
     });

package/dist/formState.d.ts

@@ -25,7 +25,7 @@
  */
 export declare type ObjectState<T, P = any> = FieldStates<T> & FieldState<P, T> & {
     /** Sets the state of fields in `state`. */
-    set(state: Partial<T>): void;
+    set(state: Partial<T>, opts?: SetOpts): void;
     /** Returns whether the object can be saved, i.e. is valid, but also as a side-effect marks touched. */
     canSave(): boolean;
 };
@@ -72,14 +72,21 @@ export interface FieldState<T, V> {
     readonly changedValue: V;
     /** Focuses the field. Disables changes from `ObjectState.set` calls. */
     focus(): void;
-    /** Blur essentially touches the field. */
+    /** Blur marks the field as touched and triggers an auto-save. */
     blur(): void;
-    set(value: V): void;
+    /** Triggers an auto-save; the caller (i.e. useFormState) should still dirty & valid check. */
+    maybeAutoSave(): void;
+    set(value: V, opts?: SetOpts): void;
     /** Reverts back to the original value and resets dirty/touched. */
     reset(): void;
     /** Accepts the current changed value (if any) as the original and resets dirty/touched. */
     save(): void;
 }
+/** Public options for our `set` command. */
+export interface SetOpts {
+    /** Whether this `set` should trigger an auto-save; defaults to true. */
+    autoSave?: boolean;
+}
 /** Form state for list of children, i.e. `U` is a `Book` in a form with a `books: Book[]`. */
 export interface ListFieldState<T, U> extends Omit<FieldState<T, U[]>, "originalValue"> {
     readonly rows: ReadonlyArray<ObjectState<U>>;
@@ -156,7 +163,7 @@ export declare type ObjectFieldConfig<U> = {
  * individual fields as well as the top-level form/object itself.
  */
 export declare function createObjectState<T>(config: ObjectConfig<T>, instance: T, opts?: {
-    onBlur?: () => void;
+    maybeAutoSave?: () => void;
 }): ObjectState<T>;
 declare type Primitive = undefined | null | boolean | string | number | Function | Date | {
     toJSON(): any;

package/dist/formState.js

@@ -12,7 +12,8 @@ const utils_1 = require("./utils");
 // We pre-emptively make this a mobx action so that it's identity doesn't change when proxy-ified
 // and breaks our ability to do `rules.some(r => r === required)`.
 exports.required = mobx_1.action(({ value: v }) => {
-    return v !== undefined && v !== null && v !== "" ? undefined : "Required";
+    const isEmptyString = typeof v === "string" ? v.trim() === "" : false;
+    return v !== undefined && v !== null && !isEmptyString ? undefined : "Required";
 });
 /**
  * Creates a new `ObjectState` for a given form object `T` given config rules in `config`.
@@ -23,10 +24,10 @@ exports.required = mobx_1.action(({ value: v }) => {
  */
 function createObjectState(config, instance, opts = {}) {
     const noop = () => { };
-    return newObjectState(config, undefined, instance, undefined, opts.onBlur || noop);
+    return newObjectState(config, undefined, instance, undefined, opts.maybeAutoSave || noop);
 }
 exports.createObjectState = createObjectState;
-function newObjectState(config, parentState, instance, key, onBlur) {
+function newObjectState(config, parentState, instance, key, maybeAutoSave) {
     // This is what we return, but we only know it's value until we call `observable`, so
     // we create a mutable variable to capture it so that we can create fields/call their
     // constructors and give them a way to access it later.
@@ -42,16 +43,16 @@ function newObjectState(config, parentState, instance, key, onBlur) {
         const config = _config;
         let field;
         if (config.type === "value") {
-            field = newValueFieldState(instance, getObjectState, key, config.rules || [], config.isIdKey || key === "id", config.isDeleteKey || false, config.isReadOnlyKey || false, config.computed || false, config.readOnly || false, onBlur);
+            field = newValueFieldState(instance, getObjectState, key, config.rules || [], config.isIdKey || key === "id", config.isDeleteKey || false, config.isReadOnlyKey || false, config.computed || false, config.readOnly || false, maybeAutoSave);
         }
         else if (config.type === "list") {
-            field = newListFieldState(instance, getObjectState, key, config.rules || [], config, config.config, onBlur);
+            field = newListFieldState(instance, getObjectState, key, config.rules || [], config, config.config, maybeAutoSave);
         }
         else if (config.type === "object") {
             if (!instance[key]) {
                 instance[key] = {};
             }
-            field = newObjectState(config.config, getObjectState, instance[key], key, onBlur);
+            field = newObjectState(config.config, getObjectState, instance[key], key, maybeAutoSave);
         }
         else {
             throw new Error("Unsupported");
@@ -185,7 +186,7 @@ function newObjectState(config, parentState, instance, key, onBlur) {
     mobx_1.reaction(() => getFields(proxy).map((f) => f.value), () => _tick.value++);
     return proxy;
 }
-function newValueFieldState(parentInstance, parentState, key, rules, isIdKey, isDeleteKey, isReadOnlyKey, computed, readOnly, onBlur) {
+function newValueFieldState(parentInstance, parentState, key, rules, isIdKey, isDeleteKey, isReadOnlyKey, computed, readOnly, maybeAutoSave) {
     // keep a copy here for reference equality
     const value = parentInstance[key];
     let _originalValue = value === null ? undefined : is_plain_object_1.isPlainObject(value) ? mobx_1.toJS(value) : value;
@@ -260,14 +261,15 @@ function newValueFieldState(parentInstance, parentState, key, rules, isIdKey, is
             this._focused = true;
         },
         blur() {
-            // Now that the user is done editing the field, we sneak in some trim logic
-            if (this._focused) {
-                this.maybeTrim();
-            }
+            this.maybeAutoSave();
             this._focused = false;
+        },
+        maybeAutoSave() {
+            // Now that the user is done editing the field (note maybe w/o blurring, i.e. if they hit enter), we sneak in some trim logic
+            this.maybeTrim();
             // touched is readonly, but we're allowed to change it
             this.touched = true;
-            onBlur();
+            maybeAutoSave();
         },
         set(value, opts = {}) {
             if (this.readOnly && !opts.resetting && !opts.refreshing) {
@@ -298,8 +300,8 @@ function newValueFieldState(parentInstance, parentState, key, rules, isIdKey, is
             }
             // If we're being set programmatically, i.e. we don't currently have focus,
             // call blur to trigger any auto-saves.
-            if (!this._focused && !opts.refreshing && !opts.resetting && this.dirty && changed) {
-                this.blur();
+            if (!this._focused && !opts.refreshing && !opts.resetting && this.dirty && changed && opts.autoSave !== false) {
+                this.maybeAutoSave();
             }
         },
         reset() {
@@ -339,7 +341,7 @@ function newValueFieldState(parentInstance, parentState, key, rules, isIdKey, is
     };
     return field;
 }
-function newListFieldState(parentInstance, parentState, key, rules, listConfig, config, onBlur) {
+function newListFieldState(parentInstance, parentState, key, rules, listConfig, config, maybeAutoSave) {
     // Keep a map of "item in the parent list" -> "that item's ObjectState"
     const rowMap = new Map();
     const _tick = mobx_1.observable({ value: 1 });
@@ -399,7 +401,7 @@ function newListFieldState(parentInstance, parentState, key, rules, listConfig,
                 // Because we're reading from this.value, child will be the proxy version
                 let childState = rowMap.get(child);
                 if (!childState) {
-                    childState = newObjectState(config, parentState, child, undefined, onBlur);
+                    childState = newObjectState(config, parentState, child, undefined, maybeAutoSave);
                     rowMap.set(child, childState);
                 }
                 return childState;
@@ -442,8 +444,11 @@ function newListFieldState(parentInstance, parentState, key, rules, listConfig,
         },
         blur() {
             this._focused = false;
+            this.maybeAutoSave();
+        },
+        maybeAutoSave() {
             this.touched = true;
-            onBlur();
+            maybeAutoSave();
         },
         set(values, opts = {}) {
             if (this.readOnly && !opts.resetting && !opts.refreshing) {
@@ -462,7 +467,7 @@ function newListFieldState(parentInstance, parentState, key, rules, listConfig,
                         }
                     }
                     // If we didn't have an existing child, just make a new object state
-                    childState = createObjectState(config, value, { onBlur });
+                    childState = createObjectState(config, value, { maybeAutoSave });
                     rowMap.set(value, childState);
                 }
                 // Return the already-observable'd value so that our `parent.value[key] = values` doesn't re-proxy things
@@ -476,12 +481,12 @@ function newListFieldState(parentInstance, parentState, key, rules, listConfig,
         },
         add(value, spliceIndex) {
             // This is called by the user, so value should be a non-proxy value we should keep
-            const childState = createObjectState(config, value, { onBlur });
+            const childState = createObjectState(config, value, { maybeAutoSave });
             rowMap.set(value, childState);
             this.ensureSet();
             this.value.splice(typeof spliceIndex === "number" ? spliceIndex : this.value.length, 0, childState.value);
             _tick.value++;
-            onBlur();
+            maybeAutoSave();
         },
         remove(indexOrValue) {
             this.ensureSet();
@@ -495,7 +500,7 @@ function newListFieldState(parentInstance, parentState, key, rules, listConfig,
                 }
             }
             _tick.value++;
-            onBlur();
+            maybeAutoSave();
         },
         reset() {
             if (originalCopy) {

package/dist/formState.test.js

@@ -39,6 +39,21 @@ describe("formState", () => {
         expect(a.title.required).toBeTruthy();
         expect(a.isPublished.required).toBeFalsy();
     });
+    it("trims whitespace within the required rule", () => {
+        const a = formState_1.createObjectState({ title: { type: "value", rules: [formState_1.required] } }, { title: "initial valid title" });
+        let numErrors = 0;
+        mobx_1.autorun(() => {
+            numErrors = a.title.errors.length;
+        });
+        expect(a.valid).toBeTruthy();
+        expect(numErrors).toEqual(0);
+        // When a value contains only whitespace
+        a.title.value = "  ";
+        expect(a.title.valid).toBeFalsy();
+        expect(numErrors).toEqual(1);
+        expect(a.title.errors).toEqual(["Required"]);
+        expect(a.errors).toEqual(["title: Required"]);
+    });
     it("can set values", () => {
         const a = formState_1.createObjectState({ title: { type: "value" } }, { title: "b1" });
         expect(a.title.value).toEqual("b1");
@@ -285,6 +300,52 @@ describe("formState", () => {
         expect(a.firstName.valid).toBeTruthy();
         expect(a.lastName.errors).toEqual(["Last name cannot be first name"]);
     });
+    it("passes sanitized values to validation rules", () => {
+        // Given a field with a validation rule
+        const rule = jest.fn().mockReturnValue("Required");
+        const a = formState_1.createObjectState({ firstName: { type: "value", rules: [rule] } }, {});
+        expect(rule).toHaveBeenCalledTimes(0);
+        // When the field is set to empty string
+        a.firstName.value = "";
+        expect(a.firstName.errors).toEqual(["Required"]);
+        expect(rule).toHaveBeenCalledTimes(1);
+        // Then the validation rule was passed undefined
+        expect(rule).toHaveBeenCalledWith({
+            value: undefined,
+            originalValue: undefined,
+            key: "firstName",
+            object: expect.anything(),
+        });
+    });
+    it("passes trimmed values to validation rules on maybeAutoSave", () => {
+        // Given we have a required rule
+        const rule = jest.fn().mockReturnValue("Required");
+        const a = formState_1.createObjectState({ firstName: { type: "value", rules: [rule] } }, {});
+        expect(rule).toHaveBeenCalledTimes(0);
+        // When the user initially sets an empty string value
+        a.firstName.focus();
+        a.firstName.value = "   ";
+        expect(a.firstName.errors).toEqual(["Required"]);
+        // Then initially the rule is called with the empty string
+        expect(rule).toHaveBeenCalledTimes(1);
+        expect(rule).toHaveBeenCalledWith({
+            value: "   ",
+            originalValue: undefined,
+            key: "firstName",
+            object: expect.anything(),
+        });
+        // But then when the field maybeAutoSaves (i.e. via blur)
+        a.firstName.maybeAutoSave();
+        expect(a.firstName.errors).toEqual(["Required"]);
+        // Then the rule is called with the undefined
+        expect(rule).toHaveBeenCalledTimes(2);
+        expect(rule).toHaveBeenCalledWith({
+            value: undefined,
+            originalValue: undefined,
+            key: "firstName",
+            object: expect.anything(),
+        });
+    });
     it("simple value changes trigger observers", () => {
         const a = formState_1.createObjectState({
             title: { type: "value", rules: [formState_1.required] },
@@ -330,69 +391,78 @@ describe("formState", () => {
         a1.books.remove(0);
         expect(a1.dirty).toBeFalsy();
     });
-    it("calls onBlur when adding or removing to a list", () => {
-        const onBlur = jest.fn();
-        const a1 = createAuthorInputState({ books: [] }, onBlur);
+    it("calls maybeAutoSave when adding or removing to a list", () => {
+        const maybeAutoSave = jest.fn();
+        const a1 = createAuthorInputState({ books: [] }, maybeAutoSave);
         expect(a1.books.dirty).toBeFalsy();
         a1.books.add({ title: "t2" });
         expect(a1.books.dirty).toBeTruthy();
         a1.books.remove(0);
         expect(a1.dirty).toBeFalsy();
-        expect(onBlur).toBeCalledTimes(2);
+        expect(maybeAutoSave).toBeCalledTimes(2);
     });
-    it("calls onBlur when programmatically setting a value", () => {
-        const onBlur = jest.fn();
+    it("calls maybeAutoSave when programmatically setting a value", () => {
+        const maybeAutoSave = jest.fn();
         // Given an author listening for blur
-        const a1 = createAuthorInputState({ books: [{}] }, onBlur);
+        const a1 = createAuthorInputState({ books: [{}] }, maybeAutoSave);
         // When we programmatically set a field that isn't focused
         a1.firstName.value = "first";
-        // Then we call onBlur
-        expect(onBlur).toBeCalledTimes(1);
+        // Then we call maybeAutoSave
+        expect(maybeAutoSave).toBeCalledTimes(1);
         // And when we set a nested value
         a1.books.rows[0].title.value = "title";
-        // Then we called onBlur again
-        expect(onBlur).toBeCalledTimes(2);
+        // Then we called maybeAutoSave again
+        expect(maybeAutoSave).toBeCalledTimes(2);
     });
-    it("defers calling onBlur when setting a bound value", () => {
-        const onBlur = jest.fn();
+    it("can skip maybeAutoSave when programmatically setting a value", () => {
+        const maybeAutoSave = jest.fn();
         // Given an author listening for blur
-        const a1 = createAuthorInputState({ books: [{}] }, onBlur);
+        const a1 = createAuthorInputState({ books: [{}] }, maybeAutoSave);
+        // When we programmatically set a field that isn't focused
+        a1.set({ firstName: "first" }, { autoSave: false });
+        // Then we don't call maybeAutoSave
+        expect(maybeAutoSave).toBeCalledTimes(0);
+    });
+    it("defers calling maybeAutoSave when setting a focused value", () => {
+        const maybeAutoSave = jest.fn();
+        // Given an author listening for blur
+        const a1 = createAuthorInputState({ books: [{}] }, maybeAutoSave);
         // And the field is focused
         a1.firstName.focus();
         // When we we set the field
         a1.firstName.value = "first";
-        // Then we don't call onBlur
-        expect(onBlur).toBeCalledTimes(0);
+        // Then we don't call maybeAutoSave
+        expect(maybeAutoSave).toBeCalledTimes(0);
     });
-    it("skips onBlur when refreshing", () => {
-        const onBlur = jest.fn();
+    it("skips maybeAutoSave when refreshing", () => {
+        const maybeAutoSave = jest.fn();
         // Given an author listening for blur
-        const a1 = createAuthorInputState({ books: [{}] }, onBlur);
+        const a1 = createAuthorInputState({ books: [{}] }, maybeAutoSave);
         // When we programmatically set a field that isn't focused
         a1.set({ firstName: "first" }, { refreshing: true });
-        // Then we don't call onBlur
-        expect(onBlur).toBeCalledTimes(0);
+        // Then we don't call maybeAutoSave
+        expect(maybeAutoSave).toBeCalledTimes(0);
     });
-    it("skips onBlur when resetting", () => {
-        const onBlur = jest.fn();
+    it("skips maybeAutoSave when resetting", () => {
+        const maybeAutoSave = jest.fn();
         // Given an author listening for blur
-        const a1 = createAuthorInputState({ books: [{}] }, onBlur);
-        // And we called onBlur once
+        const a1 = createAuthorInputState({ books: [{}] }, maybeAutoSave);
+        // And we called maybeAutoSave once
         a1.set({ firstName: "first" });
-        expect(onBlur).toBeCalledTimes(1);
+        expect(maybeAutoSave).toBeCalledTimes(1);
         // When we reset
         a1.reset();
         // We don't call blur again
-        expect(onBlur).toBeCalledTimes(1);
+        expect(maybeAutoSave).toBeCalledTimes(1);
     });
-    it("skips onBlur when not dirty", () => {
-        const onBlur = jest.fn();
+    it("skips maybeAutoSave when not dirty", () => {
+        const maybeAutoSave = jest.fn();
         // Given an author listening for blur
-        const a1 = createAuthorInputState({ firstName: "first", books: [{}] }, onBlur);
+        const a1 = createAuthorInputState({ firstName: "first", books: [{}] }, maybeAutoSave);
         // When we programmatically set a field to it's existing valued
         a1.firstName.value = "first";
-        // Then we don't call onBlur
-        expect(onBlur).toBeCalledTimes(0);
+        // Then we don't call maybeAutoSave
+        expect(maybeAutoSave).toBeCalledTimes(0);
     });
     it("knows list of primitives are dirty", () => {
         const a1 = formState_1.createObjectState({ favoriteColors: { type: "value" } }, {});
@@ -955,6 +1025,20 @@ describe("formState", () => {
         // Then we trim it
         expect(formState.firstName.value).toEqual("f");
     });
+    it("trims string values on maybeAutoSave", () => {
+        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
+        // Given the user is typing with spaces
+        formState.firstName.focus();
+        formState.firstName.set("f ");
+        // And we initially keep the space
+        expect(formState.firstName.value).toEqual("f ");
+        // When the user hits Enter (which will call maybeAutoSave)
+        formState.firstName.maybeAutoSave();
+        // Then we trim it
+        expect(formState.firstName.value).toEqual("f");
+        // And the field is considered touched
+        expect(formState.firstName.touched).toEqual(true);
+    });
     it("trims empty values to undefined on blur", () => {
         const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
         // Given the user is typing with only spaces
@@ -1093,8 +1177,8 @@ const authorWithBooksConfig = {
         },
     },
 };
-function createAuthorInputState(input, onBlur) {
-    return formState_1.createObjectState(authorWithBooksConfig, input, { onBlur });
+function createAuthorInputState(input, maybeAutoSave) {
+    return formState_1.createObjectState(authorWithBooksConfig, input, { maybeAutoSave });
 }
 const authorWithAddressConfig = {
     id: { type: "value" },

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { createObjectState, FieldState, ListFieldState, ObjectConfig, ObjectState, required, Rule, } from "./formState";
 export { useFormState } from "./useFormState";
+export { useFormStates } from "./useFormStates";

package/dist/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useFormState = exports.required = exports.createObjectState = void 0;
+exports.useFormStates = exports.useFormState = exports.required = exports.createObjectState = void 0;
 var formState_1 = require("./formState");
 Object.defineProperty(exports, "createObjectState", { enumerable: true, get: function () { return formState_1.createObjectState; } });
 Object.defineProperty(exports, "required", { enumerable: true, get: function () { return formState_1.required; } });
 var useFormState_1 = require("./useFormState");
 Object.defineProperty(exports, "useFormState", { enumerable: true, get: function () { return useFormState_1.useFormState; } });
+var useFormStates_1 = require("./useFormStates");
+Object.defineProperty(exports, "useFormStates", { enumerable: true, get: function () { return useFormStates_1.useFormStates; } });

package/dist/useFormState.d.ts

@@ -37,21 +37,9 @@ export declare type UseFormStateOpts<T, I> = {
      *
      * Does not need to be stable/useMemo'd.
      */
-    autoSave?: (state: ObjectState<T>) => void;
+    autoSave?: (state: ObjectState<T>) => Promise<void>;
 };
 /**
  * Creates a formState instance for editing in a form.
  */
 export declare function useFormState<T, I>(opts: UseFormStateOpts<T, I>): ObjectState<T>;
-/**
- * Picks ony fields out of `instance` that are in the `formConfig`.
- *
- * This is useful for creating a form input from a GraphQL query result,
- * but ignoring extra data in the query that we don't want/need in the form.
- *
- * (Especially because the form.value will become our mutation's input type
- * that goes on the wire, we don't want superfluous data in it.)
- */
-export declare function pickFields<T, I>(formConfig: ObjectConfig<T>, instance: I): {
-    [K in keyof T]: K extends keyof I ? I[K] : never;
-};

package/dist/useFormState.js

@@ -1,12 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pickFields = exports.useFormState = void 0;
+exports.useFormState = void 0;
 const is_plain_object_1 = require("is-plain-object");
-const mobx_1 = require("mobx");
 const react_1 = require("react");
 const formState_1 = require("./formState");
 const utils_1 = require("./utils");
+// If the user's autoSave hook makes some last-minute `.set` calls to sneak
+// in some business logic right before their GraphQL mutation call, ignore it
+// so that we don't infinite loop.
 let isAutoSaving = false;
+// `pendingAutoSave` is a flag for determining if we need to immediately call `maybeAutoSave` again after the initial Promise finishes
+// This could happen if a field triggers auto-save while another field's auto-save is already in progress.
+let pendingAutoSave = false;
 /**
  * Creates a formState instance for editing in a form.
  */
@@ -17,28 +22,34 @@ function useFormState(opts) {
     autoSaveRef.current = autoSave;
     const firstRunRef = react_1.useRef(true);
     // This is a little weird, but we need to know ahead of time, before the form useMemo, if we're working with classes/mobx proxies
-    const [firstInitValue] = react_1.useState(() => initValue(config, init));
+    const [firstInitValue] = react_1.useState(() => utils_1.initValue(config, init));
     const isWrappingMobxProxy = !is_plain_object_1.isPlainObject(firstInitValue);
     // If they're using init.input, useMemo on it (and it might be an array), otherwise allow the identity of init be unstable
     const dep = init && "input" in init && "map" in init ? (Array.isArray(init.input) ? init.input : [init.input]) : [];
     const form = react_1.useMemo(() => {
-        function onBlur() {
-            // Don't use canSave() because we don't want to set touched for all of the field
+        async function maybeAutoSave() {
+            if (isAutoSaving) {
+                pendingAutoSave = true;
+            }
+            // Don't use canSave() because we don't want to set touched for all the fields
             if (autoSaveRef.current && form.dirty && form.valid && !isAutoSaving) {
                 try {
                     isAutoSaving = true;
-                    autoSaveRef.current(form);
+                    await autoSaveRef.current(form);
                 }
                 finally {
                     isAutoSaving = false;
+                    if (pendingAutoSave) {
+                        pendingAutoSave = false;
+                        await maybeAutoSave();
+                    }
                 }
             }
         }
-        const value = firstRunRef.current ? firstInitValue : initValue(config, init);
-        const form = formState_1.createObjectState(config, value, { onBlur });
+        const value = firstRunRef.current ? firstInitValue : utils_1.initValue(config, init);
+        const form = formState_1.createObjectState(config, value, { maybeAutoSave });
         form.readOnly = readOnly;
         // The identity of `addRules` is not stable, but assume that it is for better UX.
-        // eslint-disable-next-line react-hooks/exhaustive-deps
         (addRules || (() => { }))(form);
         firstRunRef.current = true;
         return form;
@@ -56,7 +67,7 @@ function useFormState(opts) {
             firstRunRef.current = false;
             return;
         }
-        form.set(initValue(config, init), { refreshing: true });
+        form.set(utils_1.initValue(config, init), { refreshing: true });
     }, [form, ...dep]);
     // Use useEffect so that we don't touch the form.init proxy during a render
     react_1.useEffect(() => {
@@ -65,59 +76,3 @@ function useFormState(opts) {
     return form;
 }
 exports.useFormState = useFormState;
-/** Introspects the `init` prop to see if has a `map` function/etc. and returns the form value. */
-function initValue(config, init) {
-    const initValue = init && "input" in init && "map" in init
-        ? init.input
-            ? init.map(init.input)
-            : init.ifUndefined || {}
-        : init || {};
-    return pickFields(config, initValue);
-}
-/**
- * Picks ony fields out of `instance` that are in the `formConfig`.
- *
- * This is useful for creating a form input from a GraphQL query result,
- * but ignoring extra data in the query that we don't want/need in the form.
- *
- * (Especially because the form.value will become our mutation's input type
- * that goes on the wire, we don't want superfluous data in it.)
- */
-function pickFields(formConfig, instance) {
-    // If the caller is using classes, i.e. with their own custom observable behavior, then just use as-is
-    if (!is_plain_object_1.isPlainObject(instance)) {
-        return instance;
-    }
-    return Object.fromEntries(Object.entries(formConfig).map(([key, _keyConfig]) => {
-        const keyConfig = _keyConfig;
-        const value = instance[key];
-        if (keyConfig.type === "object") {
-            if (value) {
-                return [key, pickFields(keyConfig.config, value)];
-            }
-            else {
-                return [key, value];
-            }
-        }
-        else if (keyConfig.type === "list") {
-            if (mobx_1.isObservable(value)) {
-                // If we hit an observable array, leave it as the existing proxy so the our
-                // ListFieldState will react to changes in the original array.
-                return [key, value];
-            }
-            else if (value) {
-                return [key, value.map((u) => pickFields(keyConfig.config, u))];
-            }
-            else {
-                return [key, value];
-            }
-        }
-        else if (keyConfig.type === "value") {
-            return [key, value];
-        }
-        else {
-            return utils_1.assertNever(keyConfig);
-        }
-    }));
-}
-exports.pickFields = pickFields;

package/dist/useFormState.test.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const jsx_runtime_1 = require("react/jsx-runtime");
 const rtl_utils_1 = require("@homebound/rtl-utils");
-const mobx_1 = require("mobx");
 const mobx_react_1 = require("mobx-react");
 const react_1 = require("react");
 const formState_1 = require("./formState");
@@ -306,15 +305,15 @@ describe("useFormState", () => {
             });
             return (jsx_runtime_1.jsx(mobx_react_1.Observer, { children: () => (jsx_runtime_1.jsxs("div", { children: [jsx_runtime_1.jsx("button", { "data-testid": "refreshData", onClick: () => setData(data2) }, void 0),
                         jsx_runtime_1.jsx("button", { "data-testid": "add", onClick: () => form.books.add({ title: "New Book" }) }, void 0),
-                        jsx_runtime_1.jsx("button", { "data-testid": "blurBookOne", onClick: () => form.books.rows[0].title.blur() }, void 0),
-                        jsx_runtime_1.jsx("button", { "data-testid": "blurBookTwo", onClick: () => form.books.rows[1].title.blur() }, void 0)] }, void 0)) }, void 0));
+                        jsx_runtime_1.jsx("button", { "data-testid": "blurBookOne", onClick: () => focusAndBlur(form.books.rows[0].title) }, void 0),
+                        jsx_runtime_1.jsx("button", { "data-testid": "blurBookTwo", onClick: () => focusAndBlur(form.books.rows[1].title) }, void 0)] }, void 0)) }, void 0));
         }
         // Given a formState with `onBlur` set
         const r = await rtl_utils_1.render(jsx_runtime_1.jsx(TestComponent, {}, void 0));
         // When the data/child is now available
         rtl_utils_1.click(r.refreshData);
         // And the field is blurred
-        rtl_utils_1.click(r.blurBookOne);
+        await rtl_utils_1.clickAndWait(r.blurBookOne);
         // Then we don't auto-save because nothing has changed
         expect(autoSave).toBeCalledTimes(0);
         // And when adding a new book
@@ -323,7 +322,7 @@ describe("useFormState", () => {
         // that say the new row can't be empty)
         expect(autoSave).toBeCalledTimes(1);
         // And the new book is blurred
-        rtl_utils_1.click(r.blurBookTwo);
+        await rtl_utils_1.clickAndWait(r.blurBookTwo);
         // Then we auto save again
         expect(autoSave).toBeCalledTimes(2);
     });
@@ -337,7 +336,7 @@ describe("useFormState", () => {
                 config,
                 init: data,
                 // And there is reactive business logic in the `autoSave` method
-                autoSave(state) {
+                async autoSave(state) {
                     state.lastName.set("l2");
                     autoSaves++;
                 },
@@ -350,75 +349,45 @@ describe("useFormState", () => {
         // When autoSave didn't infinite loop
         expect(autoSaves).toEqual(1);
     });
-    describe("pickFields", () => {
-        it("can pick a value field", () => {
-            const a = useFormState_1.pickFields(
-            //
-            { firstName: { type: "value" } }, { firstName: "a", b: "ignored" });
-            expect(a).toMatchInlineSnapshot(`
-      Object {
-        "firstName": "a",
-      }
-    `);
-        });
-        it("can pick an unset object fields", () => {
-            const a = useFormState_1.pickFields(authorWithAddressConfig, { firstName: "a", b: "ignored" });
-            expect(a).toMatchInlineSnapshot(`
-      Object {
-        "address": undefined,
-        "firstName": "a",
-        "id": undefined,
-        "lastName": undefined,
-      }
-    `);
-        });
-        it("can pick a set object field", () => {
-            const a = useFormState_1.pickFields(authorWithAddressConfig, { firstName: "a", b: "ignored", address: {} });
-            expect(a).toMatchInlineSnapshot(`
-      Object {
-        "address": Object {
-          "city": undefined,
-          "street": undefined,
-        },
-        "firstName": "a",
-        "id": undefined,
-        "lastName": undefined,
-      }
-    `);
-        });
-        it("can pick an unset list field", () => {
-            const a = useFormState_1.pickFields(authorWithBooksConfig, { firstName: "a", b: "ignored" });
-            expect(a).toMatchInlineSnapshot(`
-      Object {
-        "books": undefined,
-        "firstName": "a",
-        "id": undefined,
-        "lastName": undefined,
-      }
-    `);
-        });
-        it("can pick a set list field", () => {
-            const a = useFormState_1.pickFields(authorWithBooksConfig, { firstName: "a", b: "ignored", books: [{}] });
-            expect(a).toMatchInlineSnapshot(`
-      Object {
-        "books": Array [
-          Object {
-            "classification": undefined,
-            "id": undefined,
-            "title": undefined,
-          },
-        ],
-        "firstName": "a",
-        "id": undefined,
-        "lastName": undefined,
-      }
-    `);
-        });
-        it("can pick a set observable list field", () => {
-            const books = mobx_1.observable([]);
-            const a = useFormState_1.pickFields(authorWithBooksConfig, { firstName: "a", b: "ignored", books });
-            expect(mobx_1.isObservable(a.books)).toEqual(true);
-        });
+    it("can queue up changes for auto save if a save is already in progress", async () => {
+        const autoSaveStub = jest.fn();
+        const config = {
+            id: { type: "value" },
+            firstName: { type: "value" },
+            lastName: { type: "value" },
+        };
+        // Given a component using `getObjectState` for lazily creating ObjectStates
+        function TestComponent() {
+            const [apiData, setApiData] = react_1.useState({ id: "a:1", firstName: "Brandon", lastName: "Dow" });
+            const state = useFormState_1.useFormState({ config, autoSave, init: { input: apiData, map: (v) => v } });
+            async function autoSave(form) {
+                autoSaveStub(form.changedValue);
+                // Pretend to make an API call and update the local state
+                setApiData((prevState) => ({ ...prevState, ...form.changedValue }));
+                await Promise.resolve(1);
+            }
+            return (jsx_runtime_1.jsxs("div", { children: [jsx_runtime_1.jsx("button", { "data-testid": "focusSetAndSaveField", onClick: () => {
+                            state.firstName.focus();
+                            state.firstName.set("Foo");
+                            state.firstName.maybeAutoSave();
+                            state.firstName.blur();
+                        } }, void 0),
+                    jsx_runtime_1.jsx("button", { "data-testid": "focusSetAndSaveFieldLastName", onClick: () => {
+                            state.lastName.focus();
+                            state.lastName.set("Bar");
+                            state.lastName.maybeAutoSave();
+                        } }, void 0)] }, void 0));
+        }
+        const r = await rtl_utils_1.render(jsx_runtime_1.jsx(TestComponent, {}, void 0));
+        // And triggering the auto save behavior before awaiting the initial promise to resolve so we have pending changes.
+        rtl_utils_1.click(r.focusSetAndSaveField());
+        rtl_utils_1.click(r.focusSetAndSaveFieldLastName());
+        // Awaits the promises for all methods triggered above
+        await rtl_utils_1.wait();
+        // Then expect the auto save to only have been called twice. Once with each changedValues.
+        expect(autoSaveStub).toBeCalledTimes(2);
+        expect(autoSaveStub).toBeCalledWith({ id: "a:1", firstName: "Foo" });
+        expect(autoSaveStub).toBeCalledWith({ id: "a:1", lastName: "Bar" });
     });
 });
 const authorConfig = {
@@ -426,18 +395,6 @@ const authorConfig = {
     firstName: { type: "value" },
     lastName: { type: "value" },
 };
-const authorWithAddressConfig = {
-    id: { type: "value" },
-    firstName: { type: "value" },
-    lastName: { type: "value" },
-    address: {
-        type: "object",
-        config: {
-            street: { type: "value", rules: [formState_1.required] },
-            city: { type: "value" },
-        },
-    },
-};
 const authorWithBooksConfig = {
     id: { type: "value" },
     firstName: { type: "value" },
@@ -472,3 +429,8 @@ const authorWithAddressAndBooksConfig = {
         },
     },
 };
+/** Emulates a user focusing and then blurring a field. */
+function focusAndBlur(state) {
+    state.focus();
+    state.blur();
+}

package/dist/useFormStates.d.ts

@@ -0,0 +1,12 @@
+import { ObjectConfig, ObjectState } from "./formState";
+export declare type ObjectStateCache<T, I> = Record<string, [ObjectState<T>, I]>;
+declare type UseFormStatesOpts<T, I> = {
+    config: ObjectConfig<T>;
+    autoSave?: (state: ObjectState<T>) => Promise<void>;
+    getId: (v: I) => string;
+    map?: (input: Exclude<I, null | undefined>) => T;
+};
+export declare function useFormStates<T, I>(opts: UseFormStatesOpts<T, I>): {
+    getObjectState: (input: I) => ObjectState<T>;
+};
+export {};

package/dist/useFormStates.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFormStates = void 0;
+const react_1 = require("react");
+const formState_1 = require("./formState");
+const utils_1 = require("./utils");
+function useFormStates(opts) {
+    const { config, autoSave, getId, map } = opts;
+    const objectStateCache = react_1.useMemo(() => ({}), [config]);
+    // Keep track of ObjectStates that triggered auto-save when a save was already in progress.
+    const pendingAutoSaves = react_1.useRef([]);
+    // Use a ref so our memo'ized `autoSave` always see the latest value
+    const autoSaveRef = react_1.useRef(autoSave);
+    autoSaveRef.current = autoSave;
+    async function maybeAutoSave(form) {
+        if (isAutoSaving && !pendingAutoSaves.current.includes(form)) {
+            pendingAutoSaves.current.push(form);
+        }
+        // Don't use canSave() because we don't want to set touched for all the fields
+        if (autoSaveRef.current && form.dirty && form.valid && !isAutoSaving) {
+            try {
+                isAutoSaving = true;
+                await autoSaveRef.current(form);
+            }
+            finally {
+                isAutoSaving = false;
+                if (pendingAutoSaves.current.length > 0) {
+                    await maybeAutoSave(pendingAutoSaves.current.shift());
+                }
+            }
+        }
+    }
+    return {
+        getObjectState: (input) => {
+            const existing = objectStateCache[getId(input)];
+            const form = existing
+                ? existing[0]
+                : formState_1.createObjectState(config, utils_1.initValue(config, map ? { map, input } : input), {
+                    maybeAutoSave: () => maybeAutoSave(form),
+                });
+            // If it didn't exist, then add to the cache.
+            if (!existing) {
+                objectStateCache[getId(input)] = [form, input];
+            }
+            // If the source of truth changed, then update the existing state and return it.
+            if (existing && existing[1] !== input) {
+                existing[0].set(utils_1.initValue(config, map ? { map, input } : input), { refreshing: true });
+                existing[1] = input;
+            }
+            return form;
+        },
+    };
+}
+exports.useFormStates = useFormStates;
+// If the user's autoSave hook makes some last-minute `.set` calls to sneak
+// in some business logic right before their GraphQL mutation call, ignore it
+// so that we don't infinite loop.
+let isAutoSaving = false;

package/dist/useFormStates.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/useFormStates.test.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const rtl_utils_1 = require("@homebound/rtl-utils");
+const react_1 = require("react");
+const formState_1 = require("./formState");
+const useFormStates_1 = require("./useFormStates");
+describe("useFormStates", () => {
+    it("can lazily create form states", async () => {
+        const autoSave = jest.fn();
+        // Given a parent and child component, where the formState is created only for the child component.
+        function ChildComponent({ os }) {
+            return jsx_runtime_1.jsx("div", Object.assign({ "data-testid": "firstName" }, { children: os.firstName.value }), void 0);
+        }
+        function TestComponent() {
+            const config = { id: { type: "value" }, firstName: { type: "value" } };
+            const { getObjectState } = useFormStates_1.useFormStates({
+                config,
+                autoSave,
+                getId: (o) => o.id,
+            });
+            return (jsx_runtime_1.jsx("div", { children: jsx_runtime_1.jsx(ChildComponent, { os: getObjectState({ id: "a:1", firstName: "Brandon" }) }, void 0) }, void 0));
+        }
+        const r = await rtl_utils_1.render(jsx_runtime_1.jsx(TestComponent, {}, void 0));
+        // And the child component has defined state
+        expect(r.firstName()).toHaveTextContent("Brandon");
+    });
+    it("can update existing object state from cache with new values", async () => {
+        const autoSave = jest.fn();
+        const config = { id: { type: "value" }, firstName: { type: "value" } };
+        // Given a component using `getObjectState` for lazily creating ObjectStates
+        function TestComponent() {
+            const [apiData, setApiData] = react_1.useState({ id: "a:1", firstName: "Brandon" });
+            const { getObjectState } = useFormStates_1.useFormStates({ config, autoSave, getId: (o) => o.id });
+            // Memoize an original for comparing the update against.
+            const originalState = react_1.useMemo(() => getObjectState(apiData), []);
+            const state = getObjectState(apiData);
+            return (jsx_runtime_1.jsxs("div", { children: [jsx_runtime_1.jsx("div", Object.assign({ "data-testid": "firstName" }, { children: state.firstName.value }), void 0),
+                    jsx_runtime_1.jsx("div", Object.assign({ "data-testid": "statesEqual" }, { children: JSON.stringify(state === originalState) }), void 0),
+                    jsx_runtime_1.jsx("button", { "data-testid": "updateApiData", onClick: () => setApiData((prevState) => ({ ...prevState, firstName: "Bob" })) }, void 0)] }, void 0));
+        }
+        const r = await rtl_utils_1.render(jsx_runtime_1.jsx(TestComponent, {}, void 0));
+        // And the initial values for the form state display
+        expect(r.firstName()).toHaveTextContent("Brandon");
+        expect(r.statesEqual()).toHaveTextContent("true");
+        // When updating the API data
+        await rtl_utils_1.clickAndWait(r.updateApiData());
+        // Then the new value is shown in the component
+        expect(r.firstName()).toHaveTextContent("Bob");
+        // And the two states are using the same reference
+        expect(r.statesEqual()).toHaveTextContent("true");
+    });
+    it("can queue up changes for auto save if a save is already in progress - works across multiple states", async () => {
+        const autoSaveStub = jest.fn();
+        const config = {
+            id: { type: "value" },
+            firstName: { type: "value" },
+            lastName: { type: "value" },
+        };
+        // Given a component using `getObjectState` for lazily creating ObjectStates
+        function TestComponent() {
+            const [apiData, setApiData] = react_1.useState({ id: "a:1", firstName: "Tony", lastName: "Stark" });
+            const [apiData2, setApiData2] = react_1.useState({ id: "a:2", firstName: "Steve", lastName: "Rogers" });
+            const { getObjectState } = useFormStates_1.useFormStates({ config, autoSave, getId: (o) => o.id });
+            const state = getObjectState(apiData);
+            const state2 = getObjectState(apiData2);
+            async function autoSave(form) {
+                autoSaveStub(form.changedValue);
+                // Pretend to make an API call and update the local state
+                if (form.id.value === "a:1") {
+                    setApiData((prevState) => ({ ...prevState, ...form.changedValue }));
+                }
+                else {
+                    setApiData2((prevState) => ({ ...prevState, ...form.changedValue }));
+                }
+                await Promise.resolve(1);
+            }
+            return (jsx_runtime_1.jsxs("div", { children: [jsx_runtime_1.jsx("div", Object.assign({ "data-testid": "firstName" }, { children: state.firstName.value }), void 0),
+                    jsx_runtime_1.jsx("button", { "data-testid": "focusSetAndSaveField", onClick: () => {
+                            state.firstName.focus();
+                            state.firstName.set("Foo");
+                            state.firstName.maybeAutoSave();
+                        } }, void 0),
+                    jsx_runtime_1.jsx("button", { "data-testid": "focusSetAndSaveFieldLastName", onClick: () => {
+                            state.lastName.focus();
+                            state.lastName.set("Bar");
+                            state.lastName.maybeAutoSave();
+                        } }, void 0),
+                    jsx_runtime_1.jsx("button", { "data-testid": "focusSetAndSaveField2", onClick: () => {
+                            state2.lastName.focus();
+                            state2.lastName.set("Bar");
+                            state2.lastName.maybeAutoSave();
+                        } }, void 0)] }, void 0));
+        }
+        const r = await rtl_utils_1.render(jsx_runtime_1.jsx(TestComponent, {}, void 0));
+        // And triggering the auto save behavior before awaiting the initial promise to resolve so we have pending changes.
+        rtl_utils_1.click(r.focusSetAndSaveField());
+        rtl_utils_1.click(r.focusSetAndSaveFieldLastName());
+        rtl_utils_1.click(r.focusSetAndSaveField2());
+        // Awaits the promises for all methods triggered above
+        await rtl_utils_1.wait();
+        // Then expect the auto save to only have been called three times. Once with each set of changedValues.
+        expect(autoSaveStub).toBeCalledTimes(3);
+        expect(autoSaveStub).toBeCalledWith({ id: "a:1", firstName: "Foo" });
+        expect(autoSaveStub).toBeCalledWith({ id: "a:1", lastName: "Bar" });
+        expect(autoSaveStub).toBeCalledWith({ id: "a:2", lastName: "Bar" });
+    });
+    it("clears out cache if configuration changes", async () => {
+        const autoSave = jest.fn();
+        // Given a component with stable API data.
+        const apiData = { id: "a:1", firstName: "Brandon", lastName: "Dow" };
+        // And two sets of configurations
+        const originalConfig = { id: { type: "value" }, firstName: { type: "value" } };
+        const updatedConfig = {
+            id: { type: "value" },
+            firstName: { type: "value", rules: [formState_1.required] },
+        };
+        function TestComponent() {
+            const [config, setConfig] = react_1.useState(originalConfig);
+            const { getObjectState } = useFormStates_1.useFormStates({ config, autoSave, getId: (o) => o.id });
+            // Memoize an original for comparing the update against.
+            const originalState = react_1.useMemo(() => getObjectState(apiData), []);
+            const state = getObjectState(apiData);
+            return (jsx_runtime_1.jsxs("div", { children: [jsx_runtime_1.jsx("div", Object.assign({ "data-testid": "statesEqual" }, { children: JSON.stringify(state === originalState) }), void 0),
+                    jsx_runtime_1.jsx("button", { "data-testid": "updateConfig", onClick: () => setConfig(updatedConfig) }, void 0)] }, void 0));
+        }
+        // When rendered with the original configuration
+        const r = await rtl_utils_1.render(jsx_runtime_1.jsx(TestComponent, {}, void 0));
+        // Then the two form-states generated are equal
+        expect(r.statesEqual()).toHaveTextContent("true");
+        // When updating the configuration object
+        rtl_utils_1.click(r.updateConfig);
+        // Then the two form-states are no longer equal.
+        expect(r.statesEqual()).toHaveTextContent("false");
+    });
+});

package/dist/utils.d.ts

@@ -1,2 +1,17 @@
+import { ObjectConfig } from "./formState";
 export declare function fail(message?: string): never;
 export declare function assertNever(x: never): never;
+/** Introspects the `init` prop to see if has a `map` function/etc. and returns the form value. */
+export declare function initValue<T>(config: ObjectConfig<T>, init: any): T;
+/**
+ * Picks ony fields out of `instance` that are in the `formConfig`.
+ *
+ * This is useful for creating a form input from a GraphQL query result,
+ * but ignoring extra data in the query that we don't want/need in the form.
+ *
+ * (Especially because the form.value will become our mutation's input type
+ * that goes on the wire, we don't want superfluous data in it.)
+ */
+export declare function pickFields<T, I>(formConfig: ObjectConfig<T>, instance: I): {
+    [K in keyof T]: K extends keyof I ? I[K] : never;
+};

package/dist/utils.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertNever = exports.fail = void 0;
+exports.pickFields = exports.initValue = exports.assertNever = exports.fail = void 0;
+const is_plain_object_1 = require("is-plain-object");
+const mobx_1 = require("mobx");
 function fail(message) {
     throw new Error(message || "Failed");
 }
@@ -9,3 +11,60 @@ function assertNever(x) {
     throw new Error("Unexpected object: " + x);
 }
 exports.assertNever = assertNever;
+/** Introspects the `init` prop to see if has a `map` function/etc. and returns the form value. */
+function initValue(config, init) {
+    const initValue = init && "input" in init && "map" in init
+        ? init.input
+            ? init.map(init.input)
+            : init.ifUndefined || {}
+        : init || {};
+    return pickFields(config, initValue);
+}
+exports.initValue = initValue;
+/**
+ * Picks ony fields out of `instance` that are in the `formConfig`.
+ *
+ * This is useful for creating a form input from a GraphQL query result,
+ * but ignoring extra data in the query that we don't want/need in the form.
+ *
+ * (Especially because the form.value will become our mutation's input type
+ * that goes on the wire, we don't want superfluous data in it.)
+ */
+function pickFields(formConfig, instance) {
+    // If the caller is using classes, i.e. with their own custom observable behavior, then just use as-is
+    if (!is_plain_object_1.isPlainObject(instance)) {
+        return instance;
+    }
+    return Object.fromEntries(Object.entries(formConfig).map(([key, _keyConfig]) => {
+        const keyConfig = _keyConfig;
+        const value = instance[key];
+        if (keyConfig.type === "object") {
+            if (value) {
+                return [key, pickFields(keyConfig.config, value)];
+            }
+            else {
+                return [key, value];
+            }
+        }
+        else if (keyConfig.type === "list") {
+            if (mobx_1.isObservable(value)) {
+                // If we hit an observable array, leave it as the existing proxy so the our
+                // ListFieldState will react to changes in the original array.
+                return [key, value];
+            }
+            else if (value) {
+                return [key, value.map((u) => pickFields(keyConfig.config, u))];
+            }
+            else {
+                return [key, value];
+            }
+        }
+        else if (keyConfig.type === "value") {
+            return [key, value];
+        }
+        else {
+            return assertNever(keyConfig);
+        }
+    }));
+}
+exports.pickFields = pickFields;

package/dist/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils.test.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mobx_1 = require("mobx");
+const formState_1 = require("./formState");
+const utils_1 = require("./utils");
+describe("utils", () => {
+    describe("pickFields", () => {
+        it("can pick a value field", () => {
+            const a = utils_1.pickFields(
+            //
+            { firstName: { type: "value" } }, { firstName: "a", b: "ignored" });
+            expect(a).toMatchInlineSnapshot(`
+      Object {
+        "firstName": "a",
+      }
+    `);
+        });
+        it("can pick an unset object fields", () => {
+            const a = utils_1.pickFields(authorWithAddressConfig, { firstName: "a", b: "ignored" });
+            expect(a).toMatchInlineSnapshot(`
+      Object {
+        "address": undefined,
+        "firstName": "a",
+        "id": undefined,
+        "lastName": undefined,
+      }
+    `);
+        });
+        it("can pick a set object field", () => {
+            const a = utils_1.pickFields(authorWithAddressConfig, { firstName: "a", b: "ignored", address: {} });
+            expect(a).toMatchInlineSnapshot(`
+      Object {
+        "address": Object {
+          "city": undefined,
+          "street": undefined,
+        },
+        "firstName": "a",
+        "id": undefined,
+        "lastName": undefined,
+      }
+    `);
+        });
+        it("can pick an unset list field", () => {
+            const a = utils_1.pickFields(authorWithBooksConfig, { firstName: "a", b: "ignored" });
+            expect(a).toMatchInlineSnapshot(`
+      Object {
+        "books": undefined,
+        "firstName": "a",
+        "id": undefined,
+        "lastName": undefined,
+      }
+    `);
+        });
+        it("can pick a set list field", () => {
+            const a = utils_1.pickFields(authorWithBooksConfig, { firstName: "a", b: "ignored", books: [{}] });
+            expect(a).toMatchInlineSnapshot(`
+      Object {
+        "books": Array [
+          Object {
+            "classification": undefined,
+            "id": undefined,
+            "title": undefined,
+          },
+        ],
+        "firstName": "a",
+        "id": undefined,
+        "lastName": undefined,
+      }
+    `);
+        });
+        it("can pick a set observable list field", () => {
+            const books = mobx_1.observable([]);
+            const a = utils_1.pickFields(authorWithBooksConfig, { firstName: "a", b: "ignored", books });
+            expect(mobx_1.isObservable(a.books)).toEqual(true);
+        });
+    });
+});
+const authorWithAddressConfig = {
+    id: { type: "value" },
+    firstName: { type: "value" },
+    lastName: { type: "value" },
+    address: {
+        type: "object",
+        config: {
+            street: { type: "value", rules: [formState_1.required] },
+            city: { type: "value" },
+        },
+    },
+};
+const authorWithBooksConfig = {
+    id: { type: "value" },
+    firstName: { type: "value" },
+    lastName: { type: "value" },
+    books: {
+        type: "list",
+        config: {
+            id: { type: "value" },
+            title: { type: "value", rules: [formState_1.required] },
+            classification: { type: "value" },
+        },
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homebound/form-state",
-  "version": "2.2.13",
+  "version": "2.5.0",
   "author": "Homebound",
   "license": "MIT",
   "main": "dist/index.js",
@@ -21,6 +21,14 @@
     "format": "prettier --loglevel warn --write \"**/*.{ts,tsx,css,md}\"",
     "semantic-release": "semantic-release"
   },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged --allow-empty"
+    }
+  },
+  "lint-staged": {
+    "src/**/*.{ts,tsx,css,md}": "prettier --write"
+  },
   "dependencies": {
     "fast-deep-equal": "^3.1.3",
     "is-plain-object": "^5.0.0",
@@ -59,8 +67,9 @@
     "eslint-plugin-jsx-a11y": "^6.4.1",
     "eslint-plugin-react": "^7.22.0",
     "eslint-plugin-react-hooks": "^4.2.0",
-    "husky": "^5.1.1",
+    "husky": "^3.0.9",
     "jest": "^27.0.2",
+    "lint-staged": "^10.1.2",
     "mobx": "^6.3.2",
     "mobx-react": "^7.2.0",
     "prettier": "^2.2.1",