@homebound/form-state 2.33.0 → 3.0.0

package/dist/formStateDomain.d.ts

@@ -1,47 +0,0 @@
-export declare const jan1: Date;
-export declare const jan2: Date;
-export declare const dd100: DeweyDecimalClassification;
-export declare const dd200: DeweyDecimalClassification;
-export declare enum Color {
-    Red = "RED",
-    Blue = "BLUE",
-    Green = "GREEN"
-}
-export interface AuthorInput {
-    id?: string | null;
-    otherId?: string | null;
-    firstName?: string | null;
-    lastName?: string | null;
-    birthday?: Date | null;
-    books?: BookInput[] | null;
-    address?: AuthorAddress | null;
-    favoriteColors?: Color[] | null;
-}
-export interface AuthorAddress {
-    id?: string | null;
-    street?: string | null;
-    city?: string | null;
-}
-export interface BookInput {
-    id?: string | null | undefined;
-    title?: string | null | undefined;
-    classification?: DeweyDecimalClassification;
-    delete?: boolean | null | undefined;
-    isPublished?: boolean;
-    op?: "include" | "delete" | "remove";
-    reviews?: ReviewInput[];
-}
-export interface ReviewInput {
-    id?: string | null | undefined;
-    rating?: number | null | undefined;
-}
-export interface DeweyDecimalClassification {
-    number: string;
-    category: string;
-}
-export declare class DateOnly {
-    private readonly date;
-    constructor(date: Date);
-    toString(): string;
-    toJSON(): string;
-}

package/dist/formStateDomain.js

@@ -1,28 +0,0 @@
-"use strict";
-// Pretend domain objects for editing in the form, i.e. as generated
-// by a GraphQL schema for a `saveAuthor` mutation that takes an author
-// plus the author's books.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DateOnly = exports.Color = exports.dd200 = exports.dd100 = exports.jan2 = exports.jan1 = void 0;
-exports.jan1 = new Date(2020, 0, 1);
-exports.jan2 = new Date(2020, 0, 2);
-exports.dd100 = { number: "100", category: "Philosophy" };
-exports.dd200 = { number: "200", category: "Religion" };
-var Color;
-(function (Color) {
-    Color["Red"] = "RED";
-    Color["Blue"] = "BLUE";
-    Color["Green"] = "GREEN";
-})(Color || (exports.Color = Color = {}));
-class DateOnly {
-    constructor(date) {
-        this.date = date;
-    }
-    toString() {
-        return this.date.toISOString().split("T")[0];
-    }
-    toJSON() {
-        return this.toString();
-    }
-}
-exports.DateOnly = DateOnly;

package/dist/mobx-behavior.test.d.ts

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

package/dist/mobx-behavior.test.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const mobx_1 = require("mobx");
-const formState_test_1 = require("./formState.test");
-describe("mobx behavior", () => {
-    it("mobx batches if in actions", () => {
-        const a = (0, mobx_1.observable)({ name: "a1" });
-        const b = (0, mobx_1.observable)({ name: "b1" });
-        const map = new mobx_1.ObservableMap();
-        map.set("a", a);
-        map.set("b", b);
-        let runs = 0;
-        (0, mobx_1.autorun)(() => {
-            noop([...map.values()].filter((v) => v.name.includes("1")));
-            runs++;
-        });
-        expect(runs).toBe(1);
-        // When we change both a and b
-        (0, mobx_1.runInAction)(() => {
-            a.name = "a11";
-            b.name = "b2";
-        });
-        // Then the reaction waited and only ran once
-        expect(runs).toBe(2);
-    });
-    it("mobx can watch undefined keys", () => {
-        const a = new formState_test_1.ObservableObject();
-        const b = new formState_test_1.ObservableObject();
-        const map = new mobx_1.ObservableMap();
-        map.set("a", a);
-        map.set("b", b);
-        let runs = 0;
-        (0, mobx_1.autorun)(() => {
-            noop([...map.values()].map((a) => a.age));
-            runs++;
-        });
-        expect(runs).toBe(1);
-        b.age = 1;
-        expect(runs).toBe(2);
-    });
-    it("mobx lists maintain observable identity", () => {
-        // given a parent observable
-        const a = (0, mobx_1.observable)({ list: [] });
-        // if we observable-ize a value being pushing it on the list
-        const c1 = (0, mobx_1.observable)({});
-        a.list.push(c1);
-        // then we get identify equality on the list lookups
-        expect(a.list[0] === c1).toEqual(true);
-    });
-});
-function noop(t) { }

package/dist/proxies.d.ts

@@ -1,5 +0,0 @@
-/**
- * Creates a new combined object with keys in `overrides` taking precedence, and then
- * any other keys falling back to `delegate`.
- */
-export declare function newDelegateProxy<T extends object, O extends object>(delegate: T, overrides: O): Omit<T, keyof O> & O;

package/dist/proxies.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.newDelegateProxy = newDelegateProxy;
-/**
- * Creates a new combined object with keys in `overrides` taking precedence, and then
- * any other keys falling back to `delegate`.
- */
-function newDelegateProxy(delegate, overrides) {
-    function pickTarget(key) {
-        return Reflect.has(overrides, key) ? overrides : delegate;
-    }
-    return new Proxy(delegate, {
-        get(object, key) {
-            return Reflect.get(pickTarget(key), key);
-        },
-        set(object, key, value) {
-            return Reflect.set(pickTarget(key), key, value);
-        },
-    });
-}

package/dist/rules.d.ts

@@ -1,10 +0,0 @@
-/** A validation rule, given the value and name, return the error string if valid, or undefined if valid. */
-export type Rule<V> = (opts: {
-    value: V;
-    key: string;
-    originalValue: V;
-}) => 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;

package/dist/rules.js

@@ -1,11 +0,0 @@
-"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 = (0, mobx_1.action)(({ value: v }) => {
-    const isEmptyString = typeof v === "string" ? v.trim() === "" : false;
-    return v !== undefined && v !== null && !isEmptyString ? undefined : "Required";
-});

package/dist/setupTests.d.ts

@@ -1 +0,0 @@
-import "@testing-library/jest-dom";

package/dist/setupTests.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("@testing-library/jest-dom");
-const mobx_1 = require("mobx");
-// rtl-utils looks for the test runner on globalThis, and jest only injects `jest` into module scope
-globalThis.jest = jest;
-// formState doesn't use actions
-(0, mobx_1.configure)({ enforceActions: "never" });
-beforeEach(() => {
-    jest.useFakeTimers();
-});
-afterEach(() => {
-    jest.runOnlyPendingTimers();
-    jest.useRealTimers();
-});

package/dist/stackoverlfow.d.ts

@@ -1,17 +0,0 @@
-declare const c: {
-    value<V>(): ValueConfig<V>;
-};
-type Config<T> = {
-    [P in keyof T]: ValueConfig<T[P]>;
-};
-declare function config<T>(object: Config<T>): void;
-interface ValueConfig<V> {
-    req(): ValueConfig<V>;
-    readOnly(): ValueConfig<V>;
-    validate(fn: (value: V) => boolean): ValueConfig<V>;
-}
-type Author = {
-    name: string;
-    address: string;
-    city: string;
-};

package/dist/stackoverlfow.js

@@ -1,17 +0,0 @@
-"use strict";
-// Create a Zod-style fluent DSL for building config
-const c = {
-    value() {
-        return null;
-    },
-};
-function config(object) { }
-// Try and configure the author
-config({
-    // correctly inferred as c.value<string> --> ValueConfig<string>
-    name: c.value(),
-    // inferred only as c.value<unknown> --> ValueConfig<unknown>
-    address: c.value().req(),
-    // compile error, v is implicitly typed as any
-    city: c.value().validate((v) => v.length > 0),
-});

package/dist/temporal.d.ts

@@ -1,6 +0,0 @@
-import { type Temporal } from "temporal-polyfill";
-export type SupportedTemporal = Temporal.PlainDate | Temporal.ZonedDateTime;
-/** Detects the Temporal value types that form-state treats as builtins. */
-export declare function isSupportedTemporal(value: unknown): value is SupportedTemporal;
-/** Compares supported Temporal values with Temporal's `.equals(...)` semantics. */
-export declare function areSupportedTemporalValuesEqual(a: unknown, b: unknown): boolean | undefined;

package/dist/temporal.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSupportedTemporal = isSupportedTemporal;
-exports.areSupportedTemporalValuesEqual = areSupportedTemporalValuesEqual;
-// Use Temporal's well-known tags for runtime detection instead of `instanceof` because this
-// library can receive values from native Temporal, a polyfill, another copy of a polyfill,
-// or another realm. Tag checks are stable across those boundaries, while `instanceof` is not.
-const temporalPlainDateTag = "Temporal.PlainDate";
-const temporalZonedDateTimeTag = "Temporal.ZonedDateTime";
-/** Detects the Temporal value types that form-state treats as builtins. */
-function isSupportedTemporal(value) {
-    if (!value || typeof value !== "object") {
-        return false;
-    }
-    const record = value;
-    return (isSupportedTemporalTag(record[Symbol.toStringTag]) &&
-        typeof record.equals === "function" &&
-        typeof record.toJSON === "function");
-}
-/** Compares supported Temporal values with Temporal's `.equals(...)` semantics. */
-function areSupportedTemporalValuesEqual(a, b) {
-    const aIsTemporal = isSupportedTemporal(a);
-    const bIsTemporal = isSupportedTemporal(b);
-    if (!aIsTemporal && !bIsTemporal) {
-        return undefined;
-    }
-    if (!aIsTemporal || !bIsTemporal || a[Symbol.toStringTag] !== b[Symbol.toStringTag]) {
-        return false;
-    }
-    return a.equals(b);
-}
-function isSupportedTemporalTag(value) {
-    return value === temporalPlainDateTag || value === temporalZonedDateTimeTag;
-}

package/dist/temporal.test.d.ts

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

package/dist/temporal.test.js

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const temporal_polyfill_1 = require("temporal-polyfill");
-const configBuilders_1 = require("./configBuilders");
-const objectField_1 = require("./fields/objectField");
-describe("Temporal support", () => {
-    it("treats equal Temporal value fields as unchanged", () => {
-        const form = (0, objectField_1.createObjectState)(temporalValueConfig, {
-            publishedOn: temporal_polyfill_1.Temporal.PlainDate.from("2026-04-17"),
-            scheduledAt: temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-17T09:00:00-04:00[America/New_York]"),
-        });
-        form.publishedOn.set(temporal_polyfill_1.Temporal.PlainDate.from("2026-04-17"));
-        form.scheduledAt.set(temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-17T09:00:00-04:00[America/New_York]"));
-        expect(form.publishedOn.dirty).toBe(false);
-        expect(form.scheduledAt.dirty).toBe(false);
-        expect(form.dirty).toBe(false);
-    });
-    it("tracks dirty nested object fields with Temporal values", () => {
-        const form = (0, objectField_1.createObjectState)(temporalObjectConfig, {
-            details: {
-                dueOn: temporal_polyfill_1.Temporal.PlainDate.from("2026-04-17"),
-                startsAt: temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-17T09:00:00-04:00[America/New_York]"),
-            },
-        });
-        form.details.dueOn.set(temporal_polyfill_1.Temporal.PlainDate.from("2026-04-17"));
-        form.details.startsAt.set(temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-17T09:00:00-04:00[America/New_York]"));
-        expect(form.details.dirty).toBe(false);
-        expect(form.dirty).toBe(false);
-        form.details.startsAt.set(temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-18T09:00:00-04:00[America/New_York]"));
-        expect(form.details.startsAt.dirty).toBe(true);
-        expect(form.details.dirty).toBe(true);
-        expect(form.dirty).toBe(true);
-        form.details.revertChanges();
-        expect(form.details.startsAt.dirty).toBe(false);
-        expect(form.details.dirty).toBe(false);
-        expect(form.dirty).toBe(false);
-    });
-    it("supports list row hashing for Temporal.ZonedDateTime values", () => {
-        var _a;
-        const form = (0, objectField_1.createObjectState)(temporalListConfig, { events: [], milestones: [] });
-        expect(() => {
-            form.events.add({ startsAt: temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-17T09:00:00-04:00[America/New_York]") });
-        }).not.toThrow();
-        expect(form.events.dirty).toBe(true);
-        const ackedRow = {
-            id: "event:1",
-            startsAt: temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-17T09:00:00-04:00[America/New_York]"),
-        };
-        expect(() => form.set({ events: [ackedRow] }, { refreshing: true })).not.toThrow();
-        expect(form.events.dirty).toBe(false);
-        expect(form.events.value[0].id).toEqual("event:1");
-        expect((_a = form.events.rows[0].startsAt.value) === null || _a === void 0 ? void 0 : _a.equals(ackedRow.startsAt)).toBe(true);
-        form.events.rows[0].startsAt.set(temporal_polyfill_1.Temporal.ZonedDateTime.from("2026-04-18T09:00:00-04:00[America/New_York]"));
-        expect(form.events.rows[0].startsAt.dirty).toBe(true);
-        expect(form.events.dirty).toBe(true);
-        expect(() => form.events.remove(0)).not.toThrow();
-        expect(form.events.value).toEqual([]);
-    });
-    it("supports list row hashing for Temporal.PlainDate values", () => {
-        var _a;
-        const form = (0, objectField_1.createObjectState)(temporalListConfig, { events: [], milestones: [] });
-        expect(() => {
-            form.milestones.add({ dueOn: temporal_polyfill_1.Temporal.PlainDate.from("2026-04-17") });
-        }).not.toThrow();
-        expect(form.milestones.dirty).toBe(true);
-        const ackedRow = { id: "milestone:1", dueOn: temporal_polyfill_1.Temporal.PlainDate.from("2026-04-17") };
-        expect(() => form.set({ milestones: [ackedRow] }, { refreshing: true })).not.toThrow();
-        expect(form.milestones.dirty).toBe(false);
-        expect(form.milestones.value[0].id).toEqual("milestone:1");
-        expect((_a = form.milestones.rows[0].dueOn.value) === null || _a === void 0 ? void 0 : _a.equals(ackedRow.dueOn)).toBe(true);
-        form.milestones.rows[0].dueOn.set(temporal_polyfill_1.Temporal.PlainDate.from("2026-04-18"));
-        expect(form.milestones.rows[0].dueOn.dirty).toBe(true);
-        expect(form.milestones.dirty).toBe(true);
-        expect(() => form.milestones.remove(0)).not.toThrow();
-        expect(form.milestones.value).toEqual([]);
-    });
-});
-const temporalValueConfig = configBuilders_1.f.config({
-    publishedOn: configBuilders_1.f.value(),
-    scheduledAt: configBuilders_1.f.value(),
-});
-const temporalObjectConfig = configBuilders_1.f.config({
-    details: configBuilders_1.f.object({
-        dueOn: configBuilders_1.f.value(),
-        startsAt: configBuilders_1.f.value(),
-    }),
-});
-const temporalListConfig = configBuilders_1.f.config({
-    events: configBuilders_1.f.list({
-        id: configBuilders_1.f.value(),
-        startsAt: configBuilders_1.f.value(),
-    }),
-    milestones: configBuilders_1.f.list({
-        id: configBuilders_1.f.value(),
-        dueOn: configBuilders_1.f.value(),
-    }),
-});

package/dist/useFormState.d.ts

@@ -1,82 +0,0 @@
-import { type ObjectConfig } from "./config";
-import { type ObjectState } from "./fields/objectField";
-export type Query<I> = {
-    data: I;
-    loading: boolean;
-    error?: any;
-};
-export type InputAndMap<T, I> = {
-    input: I;
-    map?: (input: Exclude<I, null | undefined>) => T;
-    ifUndefined?: T;
-    onlyOnce?: boolean;
-};
-export type QueryAndMap<T, I> = {
-    query: Query<I>;
-    map: (input: Exclude<I, null | undefined>) => T;
-    ifUndefined?: T;
-};
-/**
- * The opts has for `useFormState`.
- *
- * @typeparam T the form type, which is usually as close as possible to your *GraphQL input*
- * @typeparam I the *form input* type, which is usually the *GraphQL output* type, i.e. the type of the response from your GraphQL query
- */
-export type UseFormStateOpts<T, I> = {
-    /** The form configuration, should be a module-level const or useMemo'd. */
-    config: ObjectConfig<T>;
-    /**
-     * Provides the form's initial value.
-     *
-     * User's can either:
-     *
-     * - Provide no initial value (don't set `init` at all)
-     * - Provide an initial value that already matches the form type `T` (i.e. set `init: data`)
-     * - Provide an initial value from an object that _almost_ matches the form type `T`,
-     *   but needs to be mapped from it's input type `I` to the form type
-     *   (i.e. set `init: { input: data, map: (data) => ...}`).
-     *
-     * The value of using the 3rd option is that: a) we internally `useMemo` on the identity of the
-     * `init.input` (i.e. a response from an Apollo hook) and don't require the `map` function
-     * to have a stable identity, and also b) we will null-check/undefined-check `init.input` and
-     * 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?: 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.
-     *
-     * Does not need to be stable/useMemo'd.
-     */
-    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.
-     *
-     * Does not need to be stable/useMemo'd.
-     */
-    autoSave?: (state: ObjectState<T>) => Promise<unknown>;
-};
-export type FormObjectState<T, I> = ObjectState<T> & {
-    /**
-     * Refreshes the form with a server-acked value, i.e. `form.update(savedAuthor)`.
-     *
-     * This is intended for save callbacks that need `form.dirty` to become `false` immediately, before the
-     * normal query/cache refresh has a chance to rerender `useFormState`. Pass the value returned by the
-     * server so the form can map it through `init.map` and then do a field-by-field refresh of only the
-     * changes the server has acknowledged.
-     */
-    update(input: Exclude<I, null | undefined>): void;
-};
-/**
- * Creates a formState instance for editing in a form.
- */
-export declare function useFormState<T, I>(opts: UseFormStateOpts<T, I>): FormObjectState<T, I>;

package/dist/useFormState.js

@@ -1,158 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useFormState = useFormState;
-const is_plain_object_1 = require("is-plain-object");
-const react_1 = require("react");
-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
-// 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.
- */
-function useFormState(opts) {
-    const { config, init, addRules, readOnly = false, loading, autoSave } = opts;
-    // Use a ref so our memo'ized `onBlur` always see the latest value
-    const autoSaveRef = (0, react_1.useRef)(autoSave);
-    autoSaveRef.current = autoSave;
-    // Use a ref so our memo'ized `update` always sees the latest init/map
-    const initRef = (0, react_1.useRef)(init);
-    initRef.current = init;
-    const firstRunRef = (0, 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] = (0, react_1.useState)(() => (0, utils_1.initValue)(config, init));
-    const isWrappingMobxProxy = !(0, 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 = (0, utils_1.isInput)(init)
-        ? init.onlyOnce
-            ? []
-            : makeArray(init.input)
-        : (0, utils_1.isQuery)(init)
-            ? [init.query.data, init.query.loading]
-            : [];
-    const form = (0, react_1.useMemo)(() => {
-        function maybeAutoSave() {
-            if (isAutoSaving === "in-flight") {
-                pendingAutoSave = true;
-            }
-            else if (isAutoSaving === "queued") {
-                // If we've queued up an auto-save, that means we haven't called the `autoSave(...)` function yet, so
-                // we assume that the scheduled-but-not-yet-invoked invocation will find both it's original change, and
-                // also this potentially new change, and put them both onto the wire as a single operation.
-                // So we can just ignore this call.
-                return;
-            }
-            // Don't use canSave() because we don't want to set touched for all the fields
-            if (autoSaveRef.current && form.dirty && !isAutoSaving) {
-                // It's very frustrating to not know why the form is savings, to go ahead and log these
-                if (!form.valid) {
-                    console.debug("Skipping auto-save b/c form is invalid: ", form.errors);
-                    return;
-                }
-                isAutoSaving = "queued";
-                let maybeError;
-                // We use setTimeout as a cheap way to wait until the end of the current event listener
-                setTimeout(async () => {
-                    try {
-                        // Tell commitChanges to blow up.
-                        form._isAutoSaving = true;
-                        // We technically don't flip to in-flight until after the call in case the
-                        // user's autoSave function itself wants to call a .set (which would call `maybeAutoSave`,
-                        // and we don't want it to see `isAutoSaving=in-flight` and think it "missed the boat",
-                        // and so schedule an unnecessary follow-up autosave.)
-                        const promise = autoSaveRef.current(form);
-                        isAutoSaving = "in-flight";
-                        await promise;
-                    }
-                    catch (e) {
-                        maybeError = String(e);
-                        throw e;
-                    }
-                    finally {
-                        isAutoSaving = false;
-                        form._isAutoSaving = false;
-                        if (pendingAutoSave) {
-                            pendingAutoSave = false;
-                            // Push out the follow-up by 1 tick to allow refreshes to happen to potentially
-                            // un-dirty the just-saved data (e.g. if we run right away, the caller's maybeAutoSave
-                            // will see a form.changedValue that thinks the just-saved data is still dirty).
-                            setTimeout(maybeAutoSave, 0);
-                        }
-                    }
-                }, 0);
-            }
-        }
-        const value = firstRunRef.current ? firstInitValue : (0, utils_1.initValue)(config, init);
-        const form = (0, objectField_1.createObjectState)(config, value, { maybeAutoSave });
-        form.update = function update(input) {
-            const init = initRef.current;
-            const updateInit = (0, utils_1.isInput)(init)
-                ? { ...init, input }
-                : (0, utils_1.isQuery)(init)
-                    ? { input, map: init.map, ifUndefined: init.ifUndefined }
-                    : { input };
-            form.set((0, utils_1.initValue)(config, updateInit), {
-                refreshing: true,
-            });
-        };
-        form.readOnly = readOnly;
-        setLoading(form, opts);
-        // The identity of `addRules` is not stable, but assume that it is for better UX.
-        (addRules || (() => { }))(form);
-        firstRunRef.current = true;
-        return form;
-    }, 
-    // For this useMemo, we (almost) never re-run so that we can have a stable `form` identity across query refreshes.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [config, ...(isWrappingMobxProxy ? dep : [])]);
-    // We use useEffect so that any mutations to the proxies, which will call `setState`s on any observers to
-    // queue their components' render), don't happen during our render, per https://fb.me/setstate-in-render.
-    (0, react_1.useEffect)(() => {
-        // Ignore the 1st run b/c our 1st useMemo already initialized `form` with the current `init` value.
-        // Also for mobx proxies, we recreate a new form-state every time init changes, so that our
-        // fields fundamentally pointing to the right proxy. So just defer to the ^ useMemo.
-        if (firstRunRef.current || isWrappingMobxProxy) {
-            firstRunRef.current = false;
-            return;
-        }
-        setLoading(form, opts);
-        // Note: maybe someday we want to watch the `id` value and notice if it's changing (i.e. 2 -> 3),
-        // and treat this more as a reset than a refresh, b/c the id changing means it's probably
-        // not "the cache refreshed after a mutation save" but "the cache changed b/c of changing
-        // rows in the table that our side panel's form has open/is focused on" (which ideally would
-        // be treated as a full component remount by having an `key` field somewhere in the parent
-        // component, but it's unlikely the user will always remember to do this).
-        form.set((0, utils_1.initValue)(config, init), { refreshing: true });
-    }, [form, ...dep]);
-    // Use useEffect so that we don't touch the form.init proxy during a render
-    (0, react_1.useEffect)(() => {
-        form.readOnly = readOnly;
-        if (loading !== undefined) {
-            form.loading = loading;
-        }
-    }, [form, readOnly, loading]);
-    return form;
-}
-function setLoading(form, opts) {
-    const { loading, init } = opts;
-    if (loading !== undefined) {
-        // Prefer the explicit/top-level opts.loading if it's set
-        form.loading = loading;
-    }
-    else if ((0, utils_1.isInput)(init) && !init.ifUndefined) {
-        // Otherwise, check for `init.input`
-        form.loading = init.input === undefined;
-    }
-    else if ((0, utils_1.isQuery)(init)) {
-        // Or `query.loading`
-        form.loading = init.query.loading;
-    }
-}
-function makeArray(input) {
-    return Array.isArray(input) ? input : [input];
-}

package/dist/useFormState.test.d.ts

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