formstand 0.13.0 → 0.15.0

package/dist/index.js

@@ -1,3 +1,5 @@
+import { getAtPath, slotAtPath, setAtPath, isPlainObject, hasOwnSlot, valuesEqual, isFieldDirty, useFormSelector, useFormSelectorShallow, parsePath } from './chunk-N7WPXYCU.js';
+export { getAtPath, parsePath, setAtPath, useFormSelector, useFormSelectorShallow } from './chunk-N7WPXYCU.js';
 import { createStore } from 'zustand/vanilla';
 import { devtools } from 'zustand/middleware';
 import { z } from 'zod';
@@ -6,8 +8,6 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { useStore } from 'zustand/react';
 import { useShallow } from 'zustand/react/shallow';
 
-// src/core/createForm.ts
-
 // src/core/array.ts
 var removeAt = (i) => (n) => n === i ? null : n > i ? n - 1 : n;
 var insertAt = (i) => (n) => n >= i ? n + 1 : n;
@@ -101,138 +101,6 @@ var clearArrayOpsUnder = (store, path, keepSelf = false) => {
   );
   related.forEach((p) => byPath.delete(p));
 };
-
-// src/core/equality.ts
-var isPlainObject = (v) => {
-  if (typeof v !== "object" || v === null) return false;
-  const proto = Object.getPrototypeOf(v);
-  return proto === Object.prototype || proto === null;
-};
-var valuesEqual = (a, b) => {
-  if (Object.is(a, b)) return true;
-  if (a instanceof Date && b instanceof Date) {
-    return a.getTime() === b.getTime();
-  }
-  if (Array.isArray(a) && Array.isArray(b)) {
-    return a.length === b.length && a.every((v, i) => valuesEqual(v, b[i]));
-  }
-  if (isPlainObject(a) && isPlainObject(b)) {
-    const aKeys = Object.keys(a);
-    const bKeys = Object.keys(b);
-    return aKeys.length === bKeys.length && aKeys.every((k) => Object.hasOwn(b, k) && valuesEqual(a[k], b[k]));
-  }
-  return false;
-};
-var dirtyCache = /* @__PURE__ */ new WeakMap();
-var MAX_VERDICTS = 4;
-var isFieldDirty = (value, initialValue) => {
-  if (Object.is(value, initialValue)) return false;
-  if (typeof value !== "object" || value === null) {
-    return !valuesEqual(value, initialValue);
-  }
-  const cached = dirtyCache.get(value) ?? [];
-  const hit = cached.find((v) => Object.is(v.initial, initialValue));
-  if (hit !== void 0) return hit.dirty;
-  const dirty = !valuesEqual(value, initialValue);
-  dirtyCache.set(
-    value,
-    [{ initial: initialValue, dirty }, ...cached].slice(0, MAX_VERDICTS)
-  );
-  return dirty;
-};
-
-// src/core/path.ts
-var MAX_ARRAY_INDEX = 1e5;
-var isIndexSegment = (s) => {
-  const n = Number(s);
-  return Number.isInteger(n) && n >= 0 && String(n) === s;
-};
-var PARSE_CACHE_MAX = 4096;
-var parseCache = /* @__PURE__ */ new Map();
-var parsePath = (path) => {
-  const cached = parseCache.get(path);
-  if (cached !== void 0) return cached;
-  const segments = Object.freeze(
-    path === "" ? [] : path.split(".").map((s) => isIndexSegment(s) ? Number(s) : s)
-  );
-  if (parseCache.size >= PARSE_CACHE_MAX) parseCache.clear();
-  parseCache.set(path, segments);
-  return segments;
-};
-var isPlainRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-var readSegment = (obj, segment) => {
-  if (obj == null) return void 0;
-  if (Array.isArray(obj)) {
-    return typeof segment === "number" ? obj[segment] : void 0;
-  }
-  return isPlainRecord(obj) && Object.hasOwn(obj, String(segment)) ? obj[String(segment)] : void 0;
-};
-var getAtPath = (obj, path) => parsePath(path).reduce(readSegment, obj);
-var slotAtPath = (obj, path) => {
-  const walked = parsePath(path).reduce(
-    (acc, segment) => {
-      const container = acc.current;
-      const addressable = typeof segment === "number" ? Array.isArray(container) ? segment < container.length : isPlainRecord(container) : isPlainRecord(container);
-      return !acc.ok || !addressable ? { ok: false, current: void 0 } : { ok: true, current: readSegment(container, segment) };
-    },
-    { ok: true, current: obj }
-  );
-  return walked.ok ? { exists: true, value: walked.current } : { exists: false };
-};
-var hasOwnSlot = (obj, path) => parsePath(path).reduce(
-  (acc, segment) => {
-    const container = acc.current;
-    const owns = Array.isArray(container) ? typeof segment === "number" && segment < container.length : isPlainRecord(container) && Object.hasOwn(container, String(segment));
-    return !acc.ok || !owns ? { ok: false, current: void 0 } : { ok: true, current: readSegment(container, segment) };
-  },
-  { ok: true, current: obj }
-).ok;
-var writeIntoArray = (arr, index, rest, value) => {
-  const length = Math.max(arr.length, index + 1);
-  return Array.from(
-    { length },
-    (_, i) => i === index ? writeSegments(arr[i], rest, value) : arr[i]
-  );
-};
-var refusesHugeIndex = (index) => {
-  if (index > MAX_ARRAY_INDEX) {
-    console.warn(
-      `[formstand] refusing to write array index ${index} (max ${MAX_ARRAY_INDEX}); value left unchanged.`
-    );
-    return true;
-  }
-  return false;
-};
-var writeSegments = (obj, segments, value) => {
-  const [head, ...rest] = segments;
-  if (head === void 0) return value;
-  if (Array.isArray(obj)) {
-    if (typeof head !== "number") {
-      console.warn(
-        `[formstand] cannot write string key "${head}" into an array; value left unchanged.`
-      );
-      return obj;
-    }
-    if (refusesHugeIndex(head)) return obj;
-    return writeIntoArray(obj, head, rest, value);
-  }
-  if (isPlainRecord(obj)) {
-    if (!isPlainObject(obj)) {
-      console.warn(
-        `[formstand] cannot write key "${String(head)}" through a non-plain object (Date/Map/Set/class instance); value left unchanged.`
-      );
-      return obj;
-    }
-    const key = String(head);
-    return { ...obj, [key]: writeSegments(obj[key], rest, value) };
-  }
-  if (typeof head === "number") {
-    if (refusesHugeIndex(head)) return obj;
-    return writeIntoArray([], head, rest, value);
-  }
-  return { [head]: writeSegments(void 0, rest, value) };
-};
-var setAtPath = (obj, path, value) => writeSegments(obj, parsePath(path), value);
 var issuePathToFormPath = (path) => path.filter((segment) => typeof segment !== "symbol").join(".");
 var expandIssue = (issue, prefix) => {
   const at = [...prefix, ...issue.path];
@@ -1138,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;
@@ -1150,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;
@@ -1162,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 {
     }
   };
@@ -1582,12 +1492,6 @@ function useIsValid(form, path) {
 }
 var useIsSubmitting = (form) => useStore(form.store, (state) => state.isSubmitting);
 var useSubmitCount = (form) => useStore(form.store, (state) => state.submitCount);
-function useFormSelector(form, selector) {
-  return useStore(form.store, selector);
-}
-function useFormSelectorShallow(form, selector) {
-  return useStore(form.store, useShallow(selector));
-}
 
 // src/react/createFormHooks.ts
 var capitalize = (name) => name.length === 0 ? name : name.charAt(0).toUpperCase() + name.slice(1);
@@ -2013,6 +1917,6 @@ var focusField = (path, root) => {
   return path === "" ? (root !== void 0 || document.querySelectorAll("form").length <= 1) && focusFirstOf(namedControls(scope).filter(isFocusCandidate)) : focusFirstOf(pathCandidates(scope, [path]).filter(isFocusCandidate));
 };
 
-export { CheckboxField, DateField, NumberField, SelectField, TextField, checkboxProps, createForm, createFormContext, createFormHooks, dateInputProps, dateToInputText, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, hasFieldError, isAsyncRequiredError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useNumberInput, useSubmitCount, useVariantField, validateAsync, validateSync };
+export { CheckboxField, DateField, NumberField, SelectField, TextField, checkboxProps, createForm, createFormContext, createFormHooks, dateInputProps, dateToInputText, emptyValueForSchema, flattenIssues, focusField, focusFirstError, hasFieldError, isAsyncRequiredError, numberInputProps, numberToInputText, parseDateText, parseNumberText, persistForm, selectProps, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useNumberInput, useSubmitCount, useVariantField, validateAsync, validateSync };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map