formstand 0.20.0 → 0.21.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { getAtPath, slotAtPath, setAtPath, isPlainObject, hasOwnSlot, valuesEqual, useFormSelectorShallow, isFieldDirty, useFormSelector, parsePath } from './chunk-N7WPXYCU.js';
-export { getAtPath, parsePath, setAtPath, useFormSelector, useFormSelectorShallow } from './chunk-N7WPXYCU.js';
+import { getAtPath, slotAtPath, setAtPath, isPlainObject, hasOwnSlot, valuesEqual, useFormSelectorShallow, isFieldDirty, useFormSelector, parsePath } from './chunk-OB23TUKY.js';
+export { getAtPath, parsePath, setAtPath, useFormSelector, useFormSelectorShallow } from './chunk-OB23TUKY.js';
 import { shouldValidateOn } from './chunk-MQ6262S3.js';
 export { shouldValidateOn } from './chunk-MQ6262S3.js';
 import { createStore } from 'zustand/vanilla';
@@ -830,27 +830,25 @@ var createForm = (schema, options) => {
       };
     }),
     updateState: (updater) => {
-      const valuesBefore = store.getState().values;
-      store.setState((state) => {
-        const patch = updater(state);
-        if (Object.keys(patch).length === 0) return state;
-        if (patch.errors !== void 0 && patch.errors !== state.errors) {
-          console.warn(
-            "[formstand] `errors` is derived from schemaErrors/serverErrors \u2014 patch those channels instead; the direct `errors` patch is ignored."
-          );
-        }
-        const next = { ...state, ...patch };
-        return {
-          ...next,
-          ...errorChannels(state, {
-            schemaErrors: next.schemaErrors,
-            serverErrors: next.serverErrors
-          })
-        };
-      });
-      if (store.getState().values !== valuesBefore) {
+      const state = store.getState();
+      const patch = updater(state);
+      if (Object.keys(patch).length === 0) return;
+      if (patch.errors !== void 0 && patch.errors !== state.errors) {
+        console.warn(
+          "[formstand] `errors` is derived from schemaErrors/serverErrors \u2014 patch those channels instead; the direct `errors` patch is ignored."
+        );
+      }
+      const next = { ...state, ...patch };
+      if (next.values !== state.values) {
         clearArrayOpsUnder(store, "");
       }
+      store.setState(() => ({
+        ...next,
+        ...errorChannels(state, {
+          schemaErrors: next.schemaErrors,
+          serverErrors: next.serverErrors
+        })
+      }));
     },
     adoptValues: (values) => {
       sequences.clear();
@@ -1010,6 +1008,35 @@ var createForm = (schema, options) => {
   });
 };
 
+// src/core/debounce.ts
+var createDebouncer = (ms) => {
+  const timer = {
+    current: null
+  };
+  const cancel = () => {
+    if (timer.current !== null) {
+      clearTimeout(timer.current);
+      timer.current = null;
+    }
+  };
+  const schedule = (run) => {
+    cancel();
+    if (ms === 0) {
+      run();
+      return;
+    }
+    timer.current = setTimeout(() => {
+      timer.current = null;
+      run();
+    }, ms);
+  };
+  return Object.freeze({
+    schedule,
+    cancel,
+    pending: () => timer.current !== null
+  });
+};
+
 // src/core/persist.ts
 var kindOf = (value) => value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
 var conflictsWith = (draft, reference) => {
@@ -1084,28 +1111,13 @@ var persistForm = (form, options) => {
     } catch {
     }
   };
-  const timerRef = {
-    current: null
-  };
-  const cancelPending = () => {
-    if (timerRef.current !== null) {
-      clearTimeout(timerRef.current);
-      timerRef.current = null;
-    }
-  };
+  const writes = createDebouncer(debounceMs);
+  const cancelPending = () => writes.cancel();
   if (apply !== "manual") {
     load();
   }
   const unsubscribe = form.watchValues((values) => {
-    cancelPending();
-    if (debounceMs === 0) {
-      writeDraft(values);
-    } else {
-      timerRef.current = setTimeout(() => {
-        timerRef.current = null;
-        writeDraft(values);
-      }, debounceMs);
-    }
+    writes.schedule(() => writeDraft(values));
   });
   return Object.freeze({
     load,
@@ -1488,28 +1500,24 @@ function useField(form, pathArg, options) {
     return initialValue === null ? { emptyValue: null, clearable: true } : { emptyValue: void 0, clearable: false };
   }, [formSchema, path, initialValue]);
   const debounceMs = options?.debounceMs;
-  const debounceTimerRef = useRef(null);
+  const debouncerRef = useRef(null);
   useEffect(() => {
     return () => {
-      if (debounceTimerRef.current !== null) {
-        clearTimeout(debounceTimerRef.current);
-        debounceTimerRef.current = null;
-      }
+      debouncerRef.current?.cancel();
+      debouncerRef.current = null;
     };
   }, [form, path, debounceMs]);
   const triggerValidate = useCallback(() => {
     if (debounceMs !== void 0 && debounceMs > 0) {
-      if (debounceTimerRef.current !== null) {
-        clearTimeout(debounceTimerRef.current);
-      }
+      const debouncer = debouncerRef.current ?? createDebouncer(debounceMs);
+      debouncerRef.current = debouncer;
       const scheduled = getAtPath(form.store.getState().values, path);
-      debounceTimerRef.current = setTimeout(() => {
-        debounceTimerRef.current = null;
+      debouncer.schedule(() => {
         const state = form.store.getState();
         if (state.values === state.initialValues) return;
         if (!Object.is(getAtPath(state.values, path), scheduled)) return;
         void form.validateFieldAsync(path);
-      }, debounceMs);
+      });
       return;
     }
     form.validateField(path);