formstand 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -19,6 +19,7 @@ type PersistOptions<TSchema extends z.ZodType> = Readonly<{
     key: string;
     storage?: PersistStorage;
     debounceMs?: number;
+    version?: string | number;
     apply?: "adopt" | "restore" | "manual";
 }>;
 type PersistHandle = Readonly<{

package/dist/index.d.ts

@@ -19,6 +19,7 @@ type PersistOptions<TSchema extends z.ZodType> = Readonly<{
     key: string;
     storage?: PersistStorage;
     debounceMs?: number;
+    version?: string | number;
     apply?: "adopt" | "restore" | "manual";
 }>;
 type PersistHandle = Readonly<{

package/dist/index.js

@@ -1006,6 +1006,25 @@ var shouldValidateOn = (trigger, mode, reValidateMode, submitAttempted, touched
 };
 
 // src/core/persist.ts
+var kindOf = (value) => value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
+var conflictsWith = (draft, reference) => {
+  if (draft === void 0 || draft === null) return false;
+  if (reference === void 0 || reference === null) return false;
+  const draftKind = kindOf(draft);
+  const referenceKind = kindOf(reference);
+  if (draftKind !== referenceKind) return true;
+  if (draftKind === "array") {
+    const [d] = draft;
+    const [r] = reference;
+    return conflictsWith(d, r);
+  }
+  if (draftKind === "object") {
+    const d = draft;
+    const r = reference;
+    return Object.keys(d).some((key) => conflictsWith(d[key], r[key]));
+  }
+  return false;
+};
 var defaultStorage = () => {
   try {
     return typeof globalThis.localStorage === "undefined" ? null : globalThis.localStorage;
@@ -1018,11 +1037,29 @@ var persistForm = (form, options) => {
   const debounceMs = options.debounceMs ?? 300;
   const apply = options.apply ?? "adopt";
   const applyDraft = (values) => apply === "restore" ? form.setValues(values) : form.adoptValues(values);
+  const referenceShape = () => {
+    try {
+      return JSON.parse(JSON.stringify(form.getState().initialValues));
+    } catch {
+      return void 0;
+    }
+  };
   const restore = () => {
     try {
       const raw = storage === null ? null : storage.getItem(options.key);
       if (raw === null) return false;
-      applyDraft(JSON.parse(raw));
+      const parsed = JSON.parse(raw);
+      const versioned = options.version !== void 0 && typeof parsed === "object" && parsed !== null && "__v" in parsed;
+      if (options.version !== void 0 && !versioned) return false;
+      const wrapper = parsed;
+      if (versioned && wrapper.__v !== options.version) return false;
+      if (versioned && wrapper.values === void 0) return false;
+      const values = versioned ? wrapper.values : parsed;
+      const reference = referenceShape();
+      if (reference !== void 0 && conflictsWith(values, reference)) {
+        return false;
+      }
+      applyDraft(values);
       return true;
     } catch {
       return false;
@@ -1030,7 +1067,12 @@ var persistForm = (form, options) => {
   };
   const writeDraft = (values) => {
     try {
-      storage?.setItem(options.key, JSON.stringify(values));
+      storage?.setItem(
+        options.key,
+        JSON.stringify(
+          options.version === void 0 ? values : { __v: options.version, values }
+        )
+      );
     } catch {
     }
   };