@homebound/form-state 2.10.0 → 2.12.0

package/dist/formState.test.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const mobx_1 = require("mobx");
+const objectField_1 = require("./fields/objectField");
 const formStateDomain_1 = require("./formStateDomain");
-const formState_1 = require("./formState");
+const rules_1 = require("./rules");
 describe("formState", () => {
     it("mobx lists maintain observable identity", () => {
         // given a parent observable
@@ -14,11 +15,11 @@ describe("formState", () => {
         expect(a.list[0] === c1).toEqual(true);
     });
     it("can create a simple object", () => {
-        const a = formState_1.createObjectState({ title: { type: "value", rules: [formState_1.required] } }, {});
+        const a = objectField_1.createObjectState({ title: { type: "value", rules: [rules_1.required] } }, {});
         expect(a.valid).toBeFalsy();
     });
     it("can validate a simple input", () => {
-        const a = formState_1.createObjectState({ title: { type: "value", rules: [formState_1.required] } }, { title: "b1" });
+        const a = objectField_1.createObjectState({ title: { type: "value", rules: [rules_1.required] } }, { title: "b1" });
         let numErrors = 0;
         mobx_1.autorun(() => {
             numErrors = a.title.errors.length;
@@ -32,15 +33,15 @@ describe("formState", () => {
         expect(a.errors).toEqual(["title: Required"]);
     });
     it("can tell what is required", () => {
-        const a = formState_1.createObjectState({
-            title: { type: "value", rules: [formState_1.required] },
+        const a = objectField_1.createObjectState({
+            title: { type: "value", rules: [rules_1.required] },
             isPublished: { type: "value" },
         }, {});
         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" });
+        const a = objectField_1.createObjectState({ title: { type: "value", rules: [rules_1.required] } }, { title: "initial valid title" });
         let numErrors = 0;
         mobx_1.autorun(() => {
             numErrors = a.title.errors.length;
@@ -55,16 +56,16 @@ describe("formState", () => {
         expect(a.errors).toEqual(["title: Required"]);
     });
     it("can set values", () => {
-        const a = formState_1.createObjectState({ title: { type: "value" } }, { title: "b1" });
+        const a = objectField_1.createObjectState({ title: { type: "value" } }, { title: "b1" });
         expect(a.title.value).toEqual("b1");
     });
     it("can read values", () => {
-        const a = formState_1.createObjectState({ title: { type: "value" } }, { title: "b1" });
+        const a = objectField_1.createObjectState({ title: { type: "value" } }, { title: "b1" });
         expect(a.value.title).toEqual("b1");
         expect(a.title.value).toEqual("b1");
     });
     it("can set dates", () => {
-        const a = formState_1.createObjectState({
+        const a = objectField_1.createObjectState({
             birthday: {
                 type: "value",
                 rules: [({ value }) => ((value === null || value === void 0 ? void 0 : value.getTime()) === formStateDomain_1.jan2.getTime() ? "cannot be born on jan2" : undefined)],
@@ -149,7 +150,7 @@ describe("formState", () => {
         };
         // And we initially have ids in the input
         const a1 = { id: "1", firstName: "a1", books: [{ id: "2", title: "t1" }] };
-        const state = formState_1.createObjectState(config, a1);
+        const state = objectField_1.createObjectState(config, a1);
         // And we edit a few things
         state.firstName.set("a2");
         state.books.add({ title: "t2" });
@@ -286,7 +287,7 @@ describe("formState", () => {
         expect(numErrors).toEqual(0);
     });
     it("can validate across fields", () => {
-        const a = formState_1.createObjectState({
+        const a = objectField_1.createObjectState({
             firstName: { type: "value", rules: [] },
             lastName: { type: "value" },
         }, {});
@@ -303,7 +304,7 @@ describe("formState", () => {
     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] } }, {});
+        const a = objectField_1.createObjectState({ firstName: { type: "value", rules: [rule] } }, {});
         expect(rule).toHaveBeenCalledTimes(0);
         // When the field is set to empty string
         a.firstName.value = "";
@@ -320,7 +321,7 @@ describe("formState", () => {
     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] } }, {});
+        const a = objectField_1.createObjectState({ firstName: { type: "value", rules: [rule] } }, {});
         expect(rule).toHaveBeenCalledTimes(0);
         // When the user initially sets an empty string value
         a.firstName.focus();
@@ -347,8 +348,8 @@ describe("formState", () => {
         });
     });
     it("simple value changes trigger observers", () => {
-        const a = formState_1.createObjectState({
-            title: { type: "value", rules: [formState_1.required] },
+        const a = objectField_1.createObjectState({
+            title: { type: "value", rules: [rules_1.required] },
         }, { title: "t2" });
         let lastTitle = undefined;
         let ticks = 0;
@@ -465,7 +466,7 @@ describe("formState", () => {
         expect(maybeAutoSave).toBeCalledTimes(0);
     });
     it("knows list of primitives are dirty", () => {
-        const a1 = formState_1.createObjectState({ favoriteColors: { type: "value" } }, {});
+        const a1 = objectField_1.createObjectState({ favoriteColors: { type: "value" } }, {});
         expect(a1.favoriteColors.dirty).toBeFalsy();
         a1.favoriteColors.set([formStateDomain_1.Color.Blue]);
         expect(a1.dirty).toBeTruthy();
@@ -476,7 +477,7 @@ describe("formState", () => {
         expect(a1.dirty).toBeFalsy();
     });
     it("knows list of primitives are dirty with initialized as empty list", () => {
-        const a1 = formState_1.createObjectState({ favoriteColors: { type: "value" } }, { favoriteColors: [] });
+        const a1 = objectField_1.createObjectState({ favoriteColors: { type: "value" } }, { favoriteColors: [] });
         expect(a1.favoriteColors.dirty).toBeFalsy();
         a1.favoriteColors.set([formStateDomain_1.Color.Blue]);
         expect(a1.dirty).toBeTruthy();
@@ -656,7 +657,7 @@ describe("formState", () => {
         expect(a1.value.firstName).toBeNull();
     });
     it("can map properties to other types", () => {
-        const a1 = formState_1.createObjectState({
+        const a1 = objectField_1.createObjectState({
             person: { type: "value" },
         }, { person: { firstName: "a1", lastName: "b1" } });
         a1.person.set({ firstName: "a2", lastName: "b2" });
@@ -682,7 +683,7 @@ describe("formState", () => {
     });
     it("maintain field readOnly state when form is readOnly", () => {
         // Given a formState
-        const formState = formState_1.createObjectState({ title: { type: "value", rules: [formState_1.required], readOnly: true } }, {});
+        const formState = objectField_1.createObjectState({ title: { type: "value", rules: [rules_1.required], readOnly: true } }, {});
         // Then expect form
         expect(formState.title.readOnly).toBeTruthy();
     });
@@ -695,7 +696,7 @@ describe("formState", () => {
         });
         // And it is read-only
         a1.readOnly = true;
-        // Then it's fields are read-only
+        // Then its fields are read-only
         const fields = [a1, a1.firstName, a1.books, a1.books.rows[0].title, a1.books.rows[0].classification];
         fields.forEach((f) => expect(f.readOnly).toBeTruthy());
         // And even if a specific field tries to _not_ be read-only,
@@ -714,7 +715,7 @@ describe("formState", () => {
         });
         // And the top-level form is explicitly set to read-only=false
         a1.readOnly = false;
-        // Then it's fields are not read-only
+        // Then its fields are not read-only
         const fields = [a1, a1.firstName, a1.books, a1.books.rows[0].title, a1.books.rows[0].classification];
         fields.forEach((f) => expect(f.readOnly).toBeFalsy());
         // But when one of the fields opts in to readOnly
@@ -722,16 +723,50 @@ describe("formState", () => {
         // Then the field-level rule is respected
         expect(a1.firstName.readOnly).toBeTruthy();
     });
+    it("has an object-level loading=true override field-level loading=false", () => {
+        // Given a top-level object
+        const a1 = createAuthorInputState({
+            firstName: "a1",
+            lastName: "aL1",
+            books: [{ title: "b1", classification: formStateDomain_1.dd100 }],
+        });
+        // And it is loading
+        a1.loading = true;
+        // Then its fields are read-only
+        const fields = [a1, a1.firstName, a1.books, a1.books.rows[0].title, a1.books.rows[0].classification];
+        fields.forEach((f) => expect(f.loading).toBeTruthy());
+        // And even if a specific field tries to _not_ be loading
+        a1.firstName.loading = false;
+        // Then the field-level value is ignored, and it's still treated as loading
+        expect(a1.firstName.loading).toBeTruthy();
+    });
+    it("has an field-level loading=true override object-level loading=false", () => {
+        // Given a top-level object
+        const a1 = createAuthorInputState({
+            firstName: "a1",
+            lastName: "aL1",
+            books: [{ title: "b1", classification: formStateDomain_1.dd100 }],
+        });
+        // And the top-level form is explicitly set to loading=false
+        a1.loading = false;
+        // Then its fields are not loading
+        const fields = [a1, a1.firstName, a1.books, a1.books.rows[0].title, a1.books.rows[0].classification];
+        fields.forEach((f) => expect(f.loading).toBeFalsy());
+        // But when one of the fields opts in to loading
+        a1.firstName.loading = true;
+        // Then the field-level loading is respected
+        expect(a1.firstName.loading).toBeTruthy();
+    });
     it("canSave returns dirty and touches", () => {
-        const a1 = formState_1.createObjectState({
-            firstName: { type: "value", rules: [formState_1.required] },
+        const a1 = objectField_1.createObjectState({
+            firstName: { type: "value", rules: [rules_1.required] },
         }, {});
         expect(a1.firstName.touched).toBeFalsy();
         expect(a1.canSave()).toBeFalsy();
         expect(a1.firstName.touched).toBeTruthy();
     });
     it("uses toJSON if available for dirty checks", () => {
-        const a1 = formState_1.createObjectState({
+        const a1 = objectField_1.createObjectState({
             birthday: { type: "value" },
         }, { birthday: new formStateDomain_1.DateOnly(formStateDomain_1.jan1) });
         a1.birthday.set(new formStateDomain_1.DateOnly(formStateDomain_1.jan1));
@@ -746,10 +781,10 @@ describe("formState", () => {
         expect(a.valid).toBeTruthy();
     });
     it("can validate a list input", () => {
-        const a = formState_1.createObjectState({
+        const a = objectField_1.createObjectState({
             books: {
                 type: "list",
-                config: { title: { type: "value", rules: [formState_1.required] } },
+                config: { title: { type: "value", rules: [rules_1.required] } },
                 rules: [({ value }) => (value.find((b) => b.title.value === "t1") ? "Cannot have t1" : undefined)],
             },
         }, {});
@@ -763,11 +798,11 @@ describe("formState", () => {
         expect(lastErrors).toEqual("");
     });
     it("can ignore a deleted list entry", () => {
-        const a = formState_1.createObjectState({
+        const a = objectField_1.createObjectState({
             books: {
                 type: "list",
                 config: {
-                    title: { type: "value", rules: [formState_1.required] },
+                    title: { type: "value", rules: [rules_1.required] },
                     delete: { type: "value", isDeleteKey: true },
                 },
             },
@@ -782,11 +817,11 @@ describe("formState", () => {
         expect(a.books.valid).toBeTruthy();
     });
     it("can treat a list entry as read-only", () => {
-        const a = formState_1.createObjectState({
+        const a = objectField_1.createObjectState({
             books: {
                 type: "list",
                 config: {
-                    title: { type: "value", rules: [formState_1.required] },
+                    title: { type: "value", rules: [rules_1.required] },
                     isPublished: { type: "value", isReadOnlyKey: true },
                 },
             },
@@ -850,7 +885,7 @@ describe("formState", () => {
         expect(config).toBeDefined();
     });
     it("can reset observable objects with computeds", () => {
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             firstName: { type: "value" },
             lastName: { type: "value" },
             fullName: { type: "value", computed: true },
@@ -863,7 +898,7 @@ describe("formState", () => {
         expect(formState.firstName.value).toEqual("first");
     });
     it("can set computeds that have setters", () => {
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             firstName: { type: "value" },
             lastName: { type: "value" },
             fullName: { type: "value", computed: true },
@@ -876,7 +911,7 @@ describe("formState", () => {
         expect(formState.firstName.value).toEqual("first");
     });
     it("can mark fields as read only", () => {
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             firstName: { type: "value" },
             lastName: { type: "value" },
             fullName: { type: "value", readOnly: true },
@@ -889,7 +924,7 @@ describe("formState", () => {
         expect(formState.firstName.value).toEqual("first");
     });
     it("lets rules validate against other fields", () => {
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             firstName: { type: "value", rules: [] },
             lastName: {
                 type: "value",
@@ -908,7 +943,7 @@ describe("formState", () => {
     });
     it("can return only changed primitive fields", () => {
         // Given an author
-        const formState = formState_1.createObjectState(authorWithBooksConfig, {
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, {
             id: "a:1",
             firstName: "f",
             lastName: "l",
@@ -926,7 +961,7 @@ describe("formState", () => {
     });
     it("can return only changed object fields", () => {
         // Given an author with an address object
-        const formState = formState_1.createObjectState(authorWithAddressConfig, {
+        const formState = objectField_1.createObjectState(authorWithAddressConfig, {
             id: "a:1",
             firstName: "f",
             address: { city: "c1", street: "s1" },
@@ -943,7 +978,7 @@ describe("formState", () => {
     });
     it("changedValue skips empty nested fields", () => {
         // Given a new author with an address object
-        const formState = formState_1.createObjectState(authorWithAddressConfig, {
+        const formState = objectField_1.createObjectState(authorWithAddressConfig, {
             firstName: "f",
             // And nothing is in the address
             address: {},
@@ -954,7 +989,7 @@ describe("formState", () => {
     });
     it("changedValue skips effectively empty nested fields", () => {
         // Given a new author with an address object
-        const formState = formState_1.createObjectState(authorWithAddressConfig, {
+        const formState = objectField_1.createObjectState(authorWithAddressConfig, {
             firstName: "f",
             // And only undefined keys are in the address
             address: { city: undefined },
@@ -965,7 +1000,7 @@ describe("formState", () => {
     });
     it("can return only changed list fields", () => {
         // Given an author with some books
-        const formState = formState_1.createObjectState(authorWithBooksConfig, {
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, {
             id: "a:1",
             firstName: "f",
             books: [
@@ -986,7 +1021,7 @@ describe("formState", () => {
     });
     it("can return only changed but incremental list fields", () => {
         // Given an author
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             id: { type: "value" },
             // And the books collection is marked as incremental (i.e. line items)
             books: {
@@ -994,7 +1029,7 @@ describe("formState", () => {
                 update: "incremental",
                 config: {
                     id: { type: "value" },
-                    title: { type: "value", rules: [formState_1.required] },
+                    title: { type: "value", rules: [rules_1.required] },
                 },
             },
         }, {
@@ -1017,14 +1052,14 @@ describe("formState", () => {
     });
     it("uses the op key as a hint to use incremental list behavior", () => {
         // Given an author
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             id: { type: "value" },
             // And the books collection is not explicitly marked as incremental
             books: {
                 type: "list",
                 config: {
                     id: { type: "value" },
-                    title: { type: "value", rules: [formState_1.required] },
+                    title: { type: "value", rules: [rules_1.required] },
                     // But it does have an op key
                     op: { type: "value" },
                 },
@@ -1050,14 +1085,14 @@ describe("formState", () => {
     });
     it("defaults the incremental op key to included when not set", () => {
         // Given an author
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             id: { type: "value" },
             // And the books collection is not explicitly marked as incremental
             books: {
                 type: "list",
                 config: {
                     id: { type: "value" },
-                    title: { type: "value", rules: [formState_1.required] },
+                    title: { type: "value", rules: [rules_1.required] },
                     // But it does have an op key
                     op: { type: "value" },
                 },
@@ -1091,7 +1126,7 @@ describe("formState", () => {
         });
     });
     it("can observe value changes", () => {
-        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f" });
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, { firstName: "f" });
         let ticks = 0;
         mobx_1.reaction(() => formState.value, () => ticks++, { equals: () => false });
         expect(ticks).toEqual(0);
@@ -1101,7 +1136,7 @@ describe("formState", () => {
         expect(ticks).toEqual(1);
     });
     it("does not override a focused, changed field", () => {
-        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
         // Given first name is focused
         formState.firstName.focus();
         // And they have wip edits
@@ -1116,7 +1151,7 @@ describe("formState", () => {
         expect(formState.firstName.value).toEqual("fff");
     });
     it("does update a focused, unchanged field", () => {
-        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
         // Given first name is focused, but has not changed
         formState.firstName.focus();
         // When a mutation result sets both firstName and lastName
@@ -1125,7 +1160,7 @@ describe("formState", () => {
         expect(formState.firstName.value).toEqual("f2");
     });
     it("trims string values on blur", () => {
-        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
         // Given the user is typing with spaces
         formState.firstName.focus();
         formState.firstName.set("f ");
@@ -1137,7 +1172,7 @@ describe("formState", () => {
         expect(formState.firstName.value).toEqual("f");
     });
     it("trims string values on maybeAutoSave", () => {
-        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
         // Given the user is typing with spaces
         formState.firstName.focus();
         formState.firstName.set("f ");
@@ -1151,7 +1186,7 @@ describe("formState", () => {
         expect(formState.firstName.touched).toEqual(true);
     });
     it("trims empty values to undefined on blur", () => {
-        const formState = formState_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, { firstName: "f", lastName: "l" });
         // Given the user is typing with only spaces
         formState.firstName.focus();
         formState.firstName.set(" ");
@@ -1169,7 +1204,7 @@ describe("formState", () => {
     });
     it("can work with both required inputs and optional fields", () => {
         // And we drop it in a form.
-        const form = formState_1.createObjectState({
+        const form = objectField_1.createObjectState({
             id: { type: "value" },
             firstName: { type: "value" },
         }, { id: "a:1" });
@@ -1190,7 +1225,7 @@ describe("formState", () => {
     });
     it("can have child object states passed in as field states", () => {
         // Given an author
-        const a = formState_1.createObjectState({
+        const a = objectField_1.createObjectState({
             id: { type: "value" },
             // And address is modeled as a value object
             address: { type: "value" },
@@ -1207,7 +1242,7 @@ describe("formState", () => {
     });
     it("provides isNewEntity", () => {
         // Given an author without an id
-        const formState = formState_1.createObjectState(authorWithAddressConfig, {
+        const formState = objectField_1.createObjectState(authorWithAddressConfig, {
             firstName: "f",
             address: { city: "c1", street: "s1" },
         });
@@ -1222,7 +1257,7 @@ describe("formState", () => {
     });
     it("isNewEntity is false if there is no id field", () => {
         // Given an author without an id field defined
-        const formState = formState_1.createObjectState({
+        const formState = objectField_1.createObjectState({
             firstName: { type: "value" },
             address: { type: "object", config: { street: { type: "value" } } },
         }, {});
@@ -1232,7 +1267,7 @@ describe("formState", () => {
     });
     it("provides isNewEntity for lists", () => {
         // Given an author & books without an id
-        const formState = formState_1.createObjectState(authorWithBooksConfig, {
+        const formState = objectField_1.createObjectState(authorWithBooksConfig, {
             books: [{ title: "t1" }, { title: "t2" }],
         });
         // Then both books know they are new
@@ -1300,13 +1335,13 @@ const authorWithBooksConfig = {
         type: "list",
         config: {
             id: { type: "value" },
-            title: { type: "value", rules: [formState_1.required] },
+            title: { type: "value", rules: [rules_1.required] },
             classification: { type: "value" },
         },
     },
 };
 function createAuthorInputState(input, maybeAutoSave) {
-    return formState_1.createObjectState(authorWithBooksConfig, input, { maybeAutoSave });
+    return objectField_1.createObjectState(authorWithBooksConfig, input, { maybeAutoSave });
 }
 const authorWithAddressConfig = {
     id: { type: "value" },
@@ -1315,7 +1350,7 @@ const authorWithAddressConfig = {
     address: {
         type: "object",
         config: {
-            street: { type: "value", rules: [formState_1.required] },
+            street: { type: "value", rules: [rules_1.required] },
             city: { type: "value" },
         },
     },
@@ -1328,7 +1363,7 @@ const authorWithAddressAndBooksConfig = {
         type: "object",
         config: {
             id: { type: "value" },
-            street: { type: "value", rules: [formState_1.required] },
+            street: { type: "value", rules: [rules_1.required] },
             city: { type: "value" },
         },
     },
@@ -1336,11 +1371,11 @@ const authorWithAddressAndBooksConfig = {
         type: "list",
         config: {
             id: { type: "value" },
-            title: { type: "value", rules: [formState_1.required] },
+            title: { type: "value", rules: [rules_1.required] },
             classification: { type: "value" },
         },
     },
 };
 function createAuthorWithAddressInputState(input) {
-    return formState_1.createObjectState(authorWithAddressConfig, input);
+    return objectField_1.createObjectState(authorWithAddressConfig, input);
 }

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-export { createObjectState, FieldState, ListFieldState, ObjectConfig, ObjectState, required, Rule, } from "./formState";
+export { ObjectConfig } from "./config";
+export { ListFieldState } from "./fields/listField";
+export { createObjectState, ObjectState } from "./fields/objectField";
+export { FieldState } from "./fields/valueField";
+export { required, Rule } from "./rules";
 export { useFormState } from "./useFormState";
 export { useFormStates } from "./useFormStates";

package/dist/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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 objectField_1 = require("./fields/objectField");
+Object.defineProperty(exports, "createObjectState", { enumerable: true, get: function () { return objectField_1.createObjectState; } });
+var rules_1 = require("./rules");
+Object.defineProperty(exports, "required", { enumerable: true, get: function () { return rules_1.required; } });
 var useFormState_1 = require("./useFormState");
 Object.defineProperty(exports, "useFormState", { enumerable: true, get: function () { return useFormState_1.useFormState; } });
 var useFormStates_1 = require("./useFormStates");

package/dist/rules.d.ts

@@ -0,0 +1,14 @@
+import { ObjectState } from "./fields/objectField";
+declare type IfAny<T, Y, N> = 0 extends 1 & T ? Y : N;
+/** A validation rule, given the value and name, return the error string if valid, or undefined if valid. */
+export declare type Rule<T, V> = (opts: {
+    value: V;
+    key: string;
+    originalValue: V;
+    object: IfAny<T, any, ObjectState<T>>;
+}) => string | undefined;
+/** A rule that validates `value` is not `undefined`, `null`, or empty string. */
+export declare const required: <V>({ value: v }: {
+    value: V;
+}) => string | undefined;
+export {};

package/dist/rules.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.required = void 0;
+const mobx_1 = require("mobx");
+/** A rule that validates `value` is not `undefined`, `null`, or empty string. */
+// We pre-emptively make this a mobx action so that it's identity doesn't change when proxied
+// and breaks our ability to do `rules.some(r => r === required)`.
+exports.required = mobx_1.action(({ value: v }) => {
+    const isEmptyString = typeof v === "string" ? v.trim() === "" : false;
+    return v !== undefined && v !== null && !isEmptyString ? undefined : "Required";
+});

package/dist/useFormState.d.ts

@@ -1,4 +1,20 @@
-import { ObjectConfig, ObjectState } from "./formState";
+import { ObjectConfig } from "./config";
+import { ObjectState } from "./fields/objectField";
+export declare type Query<I> = {
+    data: I;
+    loading: boolean;
+    error?: any;
+};
+export declare type InputAndMap<T, I> = {
+    input: I;
+    map: (input: Exclude<I, null | undefined>) => T;
+    ifUndefined?: T;
+};
+export declare type QueryAndMap<T, I> = {
+    query: Query<I>;
+    map: (input: Exclude<I, null | undefined>) => T;
+    ifUndefined?: T;
+};
 export declare type UseFormStateOpts<T, I> = {
     /** The form configuration, should be a module-level const or useMemo'd. */
     config: ObjectConfig<T>;
@@ -19,11 +35,7 @@ export declare type UseFormStateOpts<T, I> = {
      * only call `init.map` if it's set, otherwise we'll use `init.ifDefined` or `{}`, saving you
      * from having to null check within your `init.map` function.
      */
-    init?: T | {
-        input: I;
-        map: (input: Exclude<I, null | undefined>) => T;
-        ifUndefined?: T;
-    };
+    init?: T | InputAndMap<T, I> | QueryAndMap<T, I>;
     /**
      * A hook to add custom, cross-field validation rules that can be difficult to setup directly in the config DSL.
      *
@@ -32,6 +44,13 @@ export declare type UseFormStateOpts<T, I> = {
     addRules?: (state: ObjectState<T>) => void;
     /** Whether the form should be read only, when changed it won't re-create the whole form. */
     readOnly?: boolean;
+    /**
+     * Whether the form is loading.
+     *
+     * Note that we also will infer loading from `init.input === undefined` or `init.query.loading`,
+     * so you only need to set this directly if you're not using either of those conventions.
+     */
+    loading?: boolean;
     /**
      * Fired when the form should auto-save, i.e. after a) blur and b) all fields are valid.
      *