@homebound/form-state 2.9.1 → 2.11.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,20 +683,90 @@ 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();
     });
+    it("has an object-level readOnly=true override field-level readOnly=false", () => {
+        // Given a top-level object
+        const a1 = createAuthorInputState({
+            firstName: "a1",
+            lastName: "aL1",
+            books: [{ title: "b1", classification: formStateDomain_1.dd100 }],
+        });
+        // And it is read-only
+        a1.readOnly = 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.readOnly).toBeTruthy());
+        // And even if a specific field tries to _not_ be read-only,
+        // i.e. due to a more granular business rule that happens to
+        // be allowed right now
+        a1.firstName.readOnly = false;
+        // Then the field-level rule is ignored, and it's still treated as read-only
+        expect(a1.firstName.readOnly).toBeTruthy();
+    });
+    it("has an field-level readOnly=true override object-level readOnly=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 read-only=false
+        a1.readOnly = false;
+        // 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
+        a1.firstName.readOnly = true;
+        // 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));
@@ -710,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)],
             },
         }, {});
@@ -727,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 },
                 },
             },
@@ -746,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 },
                 },
             },
@@ -814,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 },
@@ -827,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 },
@@ -840,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 },
@@ -853,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",
@@ -872,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",
@@ -890,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" },
@@ -907,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: {},
@@ -918,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 },
@@ -929,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: [
@@ -950,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: {
@@ -958,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] },
                 },
             },
         }, {
@@ -981,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" },
                 },
@@ -1014,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" },
                 },
@@ -1055,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);
@@ -1065,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
@@ -1080,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
@@ -1089,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 ");
@@ -1101,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 ");
@@ -1115,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(" ");
@@ -1133,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" });
@@ -1154,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" },
@@ -1171,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" },
         });
@@ -1186,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" } } },
         }, {});
@@ -1196,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
@@ -1264,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" },
@@ -1279,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" },
         },
     },
@@ -1292,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" },
         },
     },
@@ -1300,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,5 @@
-import { ObjectConfig, ObjectState } from "./formState";
+import { ObjectConfig } from "./config";
+import { ObjectState } from "./fields/objectField";
 export declare type UseFormStateOpts<T, I> = {
     /** The form configuration, should be a module-level const or useMemo'd. */
     config: ObjectConfig<T>;

package/dist/useFormState.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useFormState = void 0;
 const is_plain_object_1 = require("is-plain-object");
 const react_1 = require("react");
-const formState_1 = require("./formState");
+const objectField_1 = require("./fields/objectField");
 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
@@ -60,8 +60,11 @@ function useFormState(opts) {
             }
         }
         const value = firstRunRef.current ? firstInitValue : utils_1.initValue(config, init);
-        const form = formState_1.createObjectState(config, value, { maybeAutoSave });
+        const form = objectField_1.createObjectState(config, value, { maybeAutoSave });
         form.readOnly = readOnly;
+        if (init && "input" in init && !("ifUndefined" in init)) {
+            form.loading = init.input === undefined;
+        }
         // The identity of `addRules` is not stable, but assume that it is for better UX.
         (addRules || (() => { }))(form);
         firstRunRef.current = true;
@@ -80,6 +83,9 @@ function useFormState(opts) {
             firstRunRef.current = false;
             return;
         }
+        if (init && "input" in init && !("ifUndefined" in init)) {
+            form.loading = init.input === undefined;
+        }
         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