rn-inputforge 0.4.0 → 0.5.1

package/lib/commonjs/hooks/index.js

@@ -3,25 +3,81 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "useFieldFlowArray", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowArray.useFieldFlowArray;
+  }
+});
+Object.defineProperty(exports, "useFieldFlowCompleteness", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowCompleteness.useFieldFlowCompleteness;
+  }
+});
+Object.defineProperty(exports, "useFieldFlowDirtyGuard", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowDirtyGuard.useFieldFlowDirtyGuard;
+  }
+});
+Object.defineProperty(exports, "useFieldFlowDraft", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowDraft.useFieldFlowDraft;
+  }
+});
 Object.defineProperty(exports, "useFieldFlowForm", {
   enumerable: true,
   get: function () {
     return _useFieldFlowForm.useFieldFlowForm;
   }
 });
+Object.defineProperty(exports, "useFieldFlowSteps", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowSteps.useFieldFlowSteps;
+  }
+});
+Object.defineProperty(exports, "useFieldFlowSubmitQueue", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowSubmitQueue.useFieldFlowSubmitQueue;
+  }
+});
 Object.defineProperty(exports, "useFieldState", {
   enumerable: true,
   get: function () {
     return _useFieldState.useFieldState;
   }
 });
+Object.defineProperty(exports, "useFormIntelligence", {
+  enumerable: true,
+  get: function () {
+    return _useFormIntelligence.useFormIntelligence;
+  }
+});
 Object.defineProperty(exports, "useKeyboardManager", {
   enumerable: true,
   get: function () {
     return _useKeyboardManager.useKeyboardManager;
   }
 });
+Object.defineProperty(exports, "useSmartPaste", {
+  enumerable: true,
+  get: function () {
+    return _useSmartPaste.useSmartPaste;
+  }
+});
 var _useKeyboardManager = require("./useKeyboardManager");
 var _useFieldFlowForm = require("./useFieldFlowForm");
 var _useFieldState = require("./useFieldState");
+var _useFormIntelligence = require("./useFormIntelligence");
+var _useFieldFlowArray = require("./useFieldFlowArray");
+var _useFieldFlowDraft = require("./useFieldFlowDraft");
+var _useFieldFlowSteps = require("./useFieldFlowSteps");
+var _useFieldFlowDirtyGuard = require("./useFieldFlowDirtyGuard");
+var _useFieldFlowCompleteness = require("./useFieldFlowCompleteness");
+var _useFieldFlowSubmitQueue = require("./useFieldFlowSubmitQueue");
+var _useSmartPaste = require("./useSmartPaste");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_useKeyboardManager","require","_useFieldFlowForm","_useFieldState"],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,mBAAA,GAAAC,OAAA;AAGA,IAAAC,iBAAA,GAAAD,OAAA;AAUA,IAAAE,cAAA,GAAAF,OAAA","ignoreList":[]}
+{"version":3,"names":["_useKeyboardManager","require","_useFieldFlowForm","_useFieldState","_useFormIntelligence","_useFieldFlowArray","_useFieldFlowDraft","_useFieldFlowSteps","_useFieldFlowDirtyGuard","_useFieldFlowCompleteness","_useFieldFlowSubmitQueue","_useSmartPaste"],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,mBAAA,GAAAC,OAAA;AAGA,IAAAC,iBAAA,GAAAD,OAAA;AAcA,IAAAE,cAAA,GAAAF,OAAA;AAGA,IAAAG,oBAAA,GAAAH,OAAA;AAGA,IAAAI,kBAAA,GAAAJ,OAAA;AAGA,IAAAK,kBAAA,GAAAL,OAAA;AAQA,IAAAM,kBAAA,GAAAN,OAAA;AAOA,IAAAO,uBAAA,GAAAP,OAAA;AAMA,IAAAQ,yBAAA,GAAAR,OAAA;AAMA,IAAAS,wBAAA,GAAAT,OAAA;AAQA,IAAAU,cAAA,GAAAV,OAAA","ignoreList":[]}

package/lib/commonjs/hooks/useFieldFlowArray.js

@@ -0,0 +1,110 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFieldFlowArray = useFieldFlowArray;
+var _react = require("react");
+/**
+ * Manage dynamic / repeatable field groups (addresses, line items, guests, …)
+ * alongside FieldFlow inputs. Pure state — no UI assumptions.
+ *
+ * @example
+ * const guests = useFieldFlowArray({
+ *   createItem: () => ({ name: '', email: '' }),
+ *   min: 1,
+ *   max: 5,
+ * });
+ *
+ * guests.items.map((guest, i) => (
+ *   <FieldFlowInput
+ *     key={i}
+ *     label={`Guest ${i + 1}`}
+ *     value={guest.name}
+ *     onChangeText={name => guests.update(i, g => ({ ...g, name }))}
+ *   />
+ * ));
+ */
+function useFieldFlowArray({
+  initialItems = [],
+  createItem,
+  max,
+  min = 0
+}) {
+  const [items, setItems] = (0, _react.useState)(initialItems);
+  const initialRef = (0, _react.useMemo)(() => initialItems, []); // freeze initial for reset
+
+  const isMax = max !== undefined && items.length >= max;
+  const isMin = items.length <= min;
+  const append = (0, _react.useCallback)(item => {
+    let nextIndex = -1;
+    setItems(prev => {
+      if (max !== undefined && prev.length >= max) return prev;
+      const next = [...prev, item ?? createItem()];
+      nextIndex = next.length - 1;
+      return next;
+    });
+    return nextIndex;
+  }, [createItem, max]);
+  const remove = (0, _react.useCallback)(index => {
+    let removed = false;
+    setItems(prev => {
+      if (prev.length <= min) return prev;
+      if (index < 0 || index >= prev.length) return prev;
+      removed = true;
+      return prev.filter((_, i) => i !== index);
+    });
+    return removed;
+  }, [min]);
+  const update = (0, _react.useCallback)((index, item) => {
+    setItems(prev => {
+      if (index < 0 || index >= prev.length) return prev;
+      const next = [...prev];
+      next[index] = typeof item === 'function' ? item(prev[index]) : item;
+      return next;
+    });
+  }, []);
+  const move = (0, _react.useCallback)((from, to) => {
+    setItems(prev => {
+      if (from < 0 || to < 0 || from >= prev.length || to >= prev.length || from === to) {
+        return prev;
+      }
+      const next = [...prev];
+      const [row] = next.splice(from, 1);
+      next.splice(to, 0, row);
+      return next;
+    });
+  }, []);
+  const insert = (0, _react.useCallback)((index, item) => {
+    setItems(prev => {
+      if (max !== undefined && prev.length >= max) return prev;
+      const next = [...prev];
+      const at = Math.max(0, Math.min(index, next.length));
+      next.splice(at, 0, item ?? createItem());
+      return next;
+    });
+  }, [createItem, max]);
+  const clear = (0, _react.useCallback)(() => {
+    setItems(min > 0 ? Array.from({
+      length: min
+    }, () => createItem()) : []);
+  }, [createItem, min]);
+  const reset = (0, _react.useCallback)(() => {
+    setItems(initialRef);
+  }, [initialRef]);
+  return {
+    items,
+    length: items.length,
+    isMax,
+    isMin,
+    setItems,
+    append,
+    remove,
+    update,
+    move,
+    insert,
+    clear,
+    reset
+  };
+}
+//# sourceMappingURL=useFieldFlowArray.js.map

package/lib/commonjs/hooks/useFieldFlowArray.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","useFieldFlowArray","initialItems","createItem","max","min","items","setItems","useState","initialRef","useMemo","isMax","undefined","length","isMin","append","useCallback","item","nextIndex","prev","next","remove","index","removed","filter","_","i","update","move","from","to","row","splice","insert","at","Math","clear","Array","reset"],"sourceRoot":"../../../src","sources":["hooks/useFieldFlowArray.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/hooks/useFieldFlowCompleteness.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFieldFlowCompleteness = useFieldFlowCompleteness;
+var _react = require("react");
+function defaultFilled(value) {
+  return value.trim().length > 0;
+}
+
+/**
+ * Live form completeness for required fields — powers `FieldFlowCompleteness`.
+ */
+function useFieldFlowCompleteness({
+  values,
+  requiredFields,
+  isFilled,
+  secondsPerField = 8
+}) {
+  return (0, _react.useMemo)(() => {
+    const filledFields = [];
+    const remainingFields = [];
+    for (const field of requiredFields) {
+      const value = values[field] ?? '';
+      const ok = isFilled ? isFilled(field, value, values) : defaultFilled(value);
+      if (ok) filledFields.push(field);else remainingFields.push(field);
+    }
+    const total = requiredFields.length;
+    const filled = filledFields.length;
+    const remaining = remainingFields.length;
+    const progress = total === 0 ? 1 : filled / total;
+    return {
+      total,
+      filled,
+      remaining,
+      progress,
+      percent: Math.round(progress * 100),
+      remainingFields,
+      filledFields,
+      isComplete: remaining === 0,
+      estimatedSecondsLeft: remaining * secondsPerField
+    };
+  }, [values, requiredFields, isFilled, secondsPerField]);
+}
+//# sourceMappingURL=useFieldFlowCompleteness.js.map

package/lib/commonjs/hooks/useFieldFlowCompleteness.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","defaultFilled","value","trim","length","useFieldFlowCompleteness","values","requiredFields","isFilled","secondsPerField","useMemo","filledFields","remainingFields","field","ok","push","total","filled","remaining","progress","percent","Math","round","isComplete","estimatedSecondsLeft"],"sourceRoot":"../../../src","sources":["hooks/useFieldFlowCompleteness.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AA2BA,SAASC,aAAaA,CAACC,KAAa,EAAW;EAC7C,OAAOA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,MAAM,GAAG,CAAC;AAChC;;AAEA;AACA;AACA;AACO,SAASC,wBAAwBA,CAAmC;EACzEC,MAAM;EACNC,cAAc;EACdC,QAAQ;EACRC,eAAe,GAAG;AACgB,CAAC,EAAqC;EACxE,OAAO,IAAAC,cAAO,EAAC,MAAM;IACnB,MAAMC,YAAyB,GAAG,EAAE;IACpC,MAAMC,eAA4B,GAAG,EAAE;IAEvC,KAAK,MAAMC,KAAK,IAAIN,cAAc,EAAE;MAClC,MAAML,KAAK,GAAGI,MAAM,CAACO,KAAK,CAAC,IAAI,EAAE;MACjC,MAAMC,EAAE,GAAGN,QAAQ,GAAGA,QAAQ,CAACK,KAAK,EAAEX,KAAK,EAAEI,MAAM,CAAC,GAAGL,aAAa,CAACC,KAAK,CAAC;MAC3E,IAAIY,EAAE,EAAEH,YAAY,CAACI,IAAI,CAACF,KAAK,CAAC,CAAC,KAC5BD,eAAe,CAACG,IAAI,CAACF,KAAK,CAAC;IAClC;IAEA,MAAMG,KAAK,GAAGT,cAAc,CAACH,MAAM;IACnC,MAAMa,MAAM,GAAGN,YAAY,CAACP,MAAM;IAClC,MAAMc,SAAS,GAAGN,eAAe,CAACR,MAAM;IACxC,MAAMe,QAAQ,GAAGH,KAAK,KAAK,CAAC,GAAG,CAAC,GAAGC,MAAM,GAAGD,KAAK;IAEjD,OAAO;MACLA,KAAK;MACLC,MAAM;MACNC,SAAS;MACTC,QAAQ;MACRC,OAAO,EAAEC,IAAI,CAACC,KAAK,CAACH,QAAQ,GAAG,GAAG,CAAC;MACnCP,eAAe;MACfD,YAAY;MACZY,UAAU,EAAEL,SAAS,KAAK,CAAC;MAC3BM,oBAAoB,EAAEN,SAAS,GAAGT;IACpC,CAAC;EACH,CAAC,EAAE,CAACH,MAAM,EAAEC,cAAc,EAAEC,QAAQ,EAAEC,eAAe,CAAC,CAAC;AACzD","ignoreList":[]}

package/lib/commonjs/hooks/useFieldFlowDirtyGuard.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFieldFlowDirtyGuard = useFieldFlowDirtyGuard;
+var _react = require("react");
+var _reactNative = require("react-native");
+/**
+ * Warns before leaving a dirty form (Android back + imperative `confirmIfDirty`).
+ * For React Navigation, call `confirmIfDirty` inside a `beforeRemove` listener.
+ */
+function useFieldFlowDirtyGuard({
+  isDirty,
+  enabled = true,
+  title = 'Discard changes?',
+  message = 'You have unsaved changes. Leave without saving?',
+  confirmLabel = 'Discard',
+  cancelLabel = 'Stay',
+  interceptAndroidBack = true,
+  onDiscard
+}) {
+  const confirmIfDirty = (0, _react.useCallback)(() => {
+    if (!enabled || !isDirty) return Promise.resolve(true);
+    return new Promise(resolve => {
+      _reactNative.Alert.alert(title, message, [{
+        text: cancelLabel,
+        style: 'cancel',
+        onPress: () => resolve(false)
+      }, {
+        text: confirmLabel,
+        style: 'destructive',
+        onPress: () => {
+          onDiscard?.();
+          resolve(true);
+        }
+      }]);
+    });
+  }, [enabled, isDirty, title, message, confirmLabel, cancelLabel, onDiscard]);
+  (0, _react.useEffect)(() => {
+    if (!enabled || !interceptAndroidBack || _reactNative.Platform.OS !== 'android') return;
+    const sub = _reactNative.BackHandler.addEventListener('hardwareBackPress', () => {
+      if (!isDirty) return false;
+      void confirmIfDirty();
+      return true;
+    });
+    return () => sub.remove();
+  }, [enabled, interceptAndroidBack, isDirty, confirmIfDirty]);
+  return {
+    confirmIfDirty
+  };
+}
+//# sourceMappingURL=useFieldFlowDirtyGuard.js.map

package/lib/commonjs/hooks/useFieldFlowDirtyGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactNative","useFieldFlowDirtyGuard","isDirty","enabled","title","message","confirmLabel","cancelLabel","interceptAndroidBack","onDiscard","confirmIfDirty","useCallback","Promise","resolve","Alert","alert","text","style","onPress","useEffect","Platform","OS","sub","BackHandler","addEventListener","remove"],"sourceRoot":"../../../src","sources":["hooks/useFieldFlowDirtyGuard.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAwBA;AACA;AACA;AACA;AACO,SAASE,sBAAsBA,CAAC;EACrCC,OAAO;EACPC,OAAO,GAAG,IAAI;EACdC,KAAK,GAAG,kBAAkB;EAC1BC,OAAO,GAAG,iDAAiD;EAC3DC,YAAY,GAAG,SAAS;EACxBC,WAAW,GAAG,MAAM;EACpBC,oBAAoB,GAAG,IAAI;EAC3BC;AAC6B,CAAC,EAAgC;EAC9D,MAAMC,cAAc,GAAG,IAAAC,kBAAW,EAAC,MAAwB;IACzD,IAAI,CAACR,OAAO,IAAI,CAACD,OAAO,EAAE,OAAOU,OAAO,CAACC,OAAO,CAAC,IAAI,CAAC;IAEtD,OAAO,IAAID,OAAO,CAACC,OAAO,IAAI;MAC5BC,kBAAK,CAACC,KAAK,CAACX,KAAK,EAAEC,OAAO,EAAE,CAC1B;QAAEW,IAAI,EAAET,WAAW;QAAEU,KAAK,EAAE,QAAQ;QAAEC,OAAO,EAAEA,CAAA,KAAML,OAAO,CAAC,KAAK;MAAE,CAAC,EACrE;QACEG,IAAI,EAAEV,YAAY;QAClBW,KAAK,EAAE,aAAa;QACpBC,OAAO,EAAEA,CAAA,KAAM;UACbT,SAAS,GAAG,CAAC;UACbI,OAAO,CAAC,IAAI,CAAC;QACf;MACF,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;EACJ,CAAC,EAAE,CAACV,OAAO,EAAED,OAAO,EAAEE,KAAK,EAAEC,OAAO,EAAEC,YAAY,EAAEC,WAAW,EAAEE,SAAS,CAAC,CAAC;EAE5E,IAAAU,gBAAS,EAAC,MAAM;IACd,IAAI,CAAChB,OAAO,IAAI,CAACK,oBAAoB,IAAIY,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAEpE,MAAMC,GAAG,GAAGC,wBAAW,CAACC,gBAAgB,CAAC,mBAAmB,EAAE,MAAM;MAClE,IAAI,CAACtB,OAAO,EAAE,OAAO,KAAK;MAC1B,KAAKQ,cAAc,CAAC,CAAC;MACrB,OAAO,IAAI;IACb,CAAC,CAAC;IACF,OAAO,MAAMY,GAAG,CAACG,MAAM,CAAC,CAAC;EAC3B,CAAC,EAAE,CAACtB,OAAO,EAAEK,oBAAoB,EAAEN,OAAO,EAAEQ,cAAc,CAAC,CAAC;EAE5D,OAAO;IAAEA;EAAe,CAAC;AAC3B","ignoreList":[]}

package/lib/commonjs/hooks/useFieldFlowDraft.js

@@ -0,0 +1,168 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFieldFlowDraft = useFieldFlowDraft;
+var _react = require("react");
+/**
+ * Minimal async key-value storage. Pass AsyncStorage, MMKV wrapper, or any custom backend.
+ *
+ * @example
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * const storage = {
+ *   getItem: (k) => AsyncStorage.getItem(k),
+ *   setItem: (k, v) => AsyncStorage.setItem(k, v),
+ *   removeItem: (k) => AsyncStorage.removeItem(k),
+ * };
+ */
+
+function pickPersisted(values, exclude) {
+  if (!exclude?.length) return {
+    ...values
+  };
+  const next = {
+    ...values
+  };
+  for (const key of exclude) {
+    delete next[key];
+  }
+  return next;
+}
+
+/**
+ * Debounced draft persistence for FieldFlow forms. Storage is injected so the
+ * package stays free of native / peer storage dependencies.
+ */
+function useFieldFlowDraft({
+  key,
+  storage,
+  values,
+  onRestore,
+  exclude,
+  debounceMs = 600,
+  ttlMs = 7 * 24 * 60 * 60 * 1000,
+  autoLoad = true,
+  enabled = true
+}) {
+  const [ready, setReady] = (0, _react.useState)(false);
+  const [hasDraft, setHasDraft] = (0, _react.useState)(false);
+  const [draftSavedAt, setDraftSavedAt] = (0, _react.useState)(null);
+  const [draftValues, setDraftValues] = (0, _react.useState)(null);
+  const valuesRef = (0, _react.useRef)(values);
+  valuesRef.current = values;
+  const skipNextSave = (0, _react.useRef)(false);
+  const timerRef = (0, _react.useRef)(null);
+  const onRestoreRef = (0, _react.useRef)(onRestore);
+  onRestoreRef.current = onRestore;
+  const write = (0, _react.useCallback)(async nextValues => {
+    if (!enabled) return;
+    const payload = {
+      values: pickPersisted(nextValues, exclude),
+      savedAt: Date.now(),
+      version: 1
+    };
+    await storage.setItem(key, JSON.stringify(payload));
+  }, [enabled, exclude, key, storage]);
+  const clear = (0, _react.useCallback)(async () => {
+    if (timerRef.current) clearTimeout(timerRef.current);
+    await storage.removeItem(key);
+    setHasDraft(false);
+    setDraftSavedAt(null);
+    setDraftValues(null);
+  }, [key, storage]);
+  const discard = (0, _react.useCallback)(async () => {
+    await clear();
+  }, [clear]);
+  const resume = (0, _react.useCallback)(() => {
+    if (!draftValues) return;
+    skipNextSave.current = true;
+    onRestoreRef.current(draftValues);
+    setHasDraft(false);
+    setDraftValues(null);
+    setDraftSavedAt(null);
+  }, [draftValues]);
+  const saveNow = (0, _react.useCallback)(async () => {
+    await write(valuesRef.current);
+  }, [write]);
+
+  // Initial hydrate
+  (0, _react.useEffect)(() => {
+    let cancelled = false;
+    (async () => {
+      if (!enabled || !autoLoad) {
+        setReady(true);
+        return;
+      }
+      try {
+        const raw = await storage.getItem(key);
+        if (cancelled) return;
+        if (!raw) {
+          setReady(true);
+          return;
+        }
+        const parsed = JSON.parse(raw);
+        if (!parsed?.values || typeof parsed.savedAt !== 'number') {
+          await storage.removeItem(key);
+          setReady(true);
+          return;
+        }
+        if (Date.now() - parsed.savedAt > ttlMs) {
+          await storage.removeItem(key);
+          setReady(true);
+          return;
+        }
+        // Only surface banner if draft differs from current values in a meaningful way
+        const persisted = pickPersisted(parsed.values, exclude);
+        const current = pickPersisted(valuesRef.current, exclude);
+        const differs = JSON.stringify(persisted) !== JSON.stringify(current);
+        if (differs) {
+          setDraftValues(parsed.values);
+          setDraftSavedAt(parsed.savedAt);
+          setHasDraft(true);
+        }
+      } catch {
+        // Corrupt payload — wipe and continue
+        try {
+          await storage.removeItem(key);
+        } catch {
+          /* ignore */
+        }
+      } finally {
+        if (!cancelled) setReady(true);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+    // Intentionally once per key/enabled
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [key, enabled, autoLoad]);
+
+  // Debounced autosave
+  (0, _react.useEffect)(() => {
+    if (!enabled || !ready) return;
+    if (skipNextSave.current) {
+      skipNextSave.current = false;
+      return;
+    }
+    if (timerRef.current) clearTimeout(timerRef.current);
+    timerRef.current = setTimeout(() => {
+      void write(valuesRef.current);
+    }, debounceMs);
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, [values, enabled, ready, debounceMs, write]);
+  return {
+    ready,
+    hasDraft,
+    draftSavedAt,
+    draftValues,
+    resume,
+    discard,
+    saveNow,
+    clear
+  };
+}
+//# sourceMappingURL=useFieldFlowDraft.js.map

package/lib/commonjs/hooks/useFieldFlowDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","pickPersisted","values","exclude","length","next","key","useFieldFlowDraft","storage","onRestore","debounceMs","ttlMs","autoLoad","enabled","ready","setReady","useState","hasDraft","setHasDraft","draftSavedAt","setDraftSavedAt","draftValues","setDraftValues","valuesRef","useRef","current","skipNextSave","timerRef","onRestoreRef","write","useCallback","nextValues","payload","savedAt","Date","now","version","setItem","JSON","stringify","clear","clearTimeout","removeItem","discard","resume","saveNow","useEffect","cancelled","raw","getItem","parsed","parse","persisted","differs","setTimeout"],"sourceRoot":"../../../src","sources":["hooks/useFieldFlowDraft.ts"],"mappings":"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","ignoreList":[]}