rn-inputforge 0.3.1 → 0.5.0

package/lib/commonjs/components/FieldFlowUpload/FieldFlowUpload.js

@@ -0,0 +1,191 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FieldFlowUpload = FieldFlowUpload;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _ThemeProvider = require("../../theme/ThemeProvider");
+var _defaultTheme = require("../../theme/defaultTheme");
+var _renderIcon = require("../../icons/renderIcon");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function FieldFlowUpload({
+  value = [],
+  onChange,
+  pick,
+  label,
+  helperText,
+  errorText,
+  disabled,
+  required,
+  maxFiles = 1,
+  acceptHint = 'Tap to upload',
+  showPreviews = true,
+  renderDropzone,
+  renderFile,
+  containerStyle,
+  labelStyle,
+  theme: themeOverride,
+  testID
+}) {
+  const contextTheme = (0, _ThemeProvider.useFieldFlowTheme)();
+  const theme = (0, _react.useMemo)(() => themeOverride ? (0, _ThemeProvider.mergeDeep)(contextTheme ?? _defaultTheme.defaultTheme, themeOverride) : contextTheme ?? _defaultTheme.defaultTheme, [contextTheme, themeOverride]);
+  const styles = (0, _react.useMemo)(() => createStyles(theme, Boolean(errorText), Boolean(disabled)), [theme, errorText, disabled]);
+  const atMax = value.length >= maxFiles;
+  const handlePick = async () => {
+    if (disabled || atMax) return;
+    const result = await pick();
+    if (!result) return;
+    const incoming = Array.isArray(result) ? result : [result];
+    const room = maxFiles - value.length;
+    onChange([...value, ...incoming.slice(0, room)]);
+  };
+  const removeAt = index => {
+    onChange(value.filter((_, i) => i !== index));
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: [styles.wrap, containerStyle],
+    testID: testID,
+    children: [label ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Text, {
+      style: [styles.label, labelStyle],
+      children: [label, required ? ' *' : '']
+    }) : null, renderDropzone ? renderDropzone({
+      atMax,
+      fileCount: value.length,
+      maxFiles,
+      disabled: Boolean(disabled),
+      openPicker: () => {
+        void handlePick();
+      }
+    }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Pressable, {
+      style: styles.drop,
+      onPress: handlePick,
+      disabled: disabled || atMax,
+      accessibilityRole: "button",
+      accessibilityLabel: label ?? 'Upload',
+      children: [(0, _renderIcon.renderFieldFlowIcon)('plus', theme.colors.borderFocused, 22), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: styles.dropTitle,
+        children: atMax ? 'Limit reached' : acceptHint
+      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.Text, {
+        style: styles.dropMeta,
+        children: [value.length, "/", maxFiles, " file", maxFiles === 1 ? '' : 's']
+      })]
+    }), value.length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: styles.list,
+      children: value.map((file, index) => {
+        if (renderFile) {
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)(_react.default.Fragment, {
+            children: renderFile({
+              file,
+              index,
+              remove: () => removeAt(index)
+            })
+          }, `${file.uri}-${index}`);
+        }
+        const isImage = showPreviews && (file.mimeType?.startsWith('image/') || /\.(png|jpe?g|gif|webp)$/i.test(file.name ?? file.uri));
+        return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+          style: styles.item,
+          children: [isImage ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Image, {
+            source: {
+              uri: file.previewUri ?? file.uri
+            },
+            style: styles.thumb
+          }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+            style: styles.fileIcon,
+            children: (0, _renderIcon.renderFieldFlowIcon)('file', theme.colors.icon, 18)
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+            style: styles.fileName,
+            numberOfLines: 1,
+            children: file.name ?? file.uri.split('/').pop() ?? 'File'
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+            onPress: () => removeAt(index),
+            hitSlop: 8,
+            accessibilityLabel: "Remove file",
+            children: (0, _renderIcon.renderFieldFlowIcon)('trash', theme.colors.error, 16)
+          })]
+        }, `${file.uri}-${index}`);
+      })
+    }) : null, errorText ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: styles.error,
+      children: errorText
+    }) : helperText ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: styles.helper,
+      children: helperText
+    }) : null]
+  });
+}
+function createStyles(theme, hasError, disabled) {
+  return _reactNative.StyleSheet.create({
+    wrap: {
+      marginBottom: theme.spacing.gap * 2,
+      opacity: disabled ? 0.6 : 1
+    },
+    label: {
+      fontSize: theme.typography.labelFontSize,
+      marginBottom: theme.spacing.gap / 1.5,
+      color: hasError ? theme.colors.error : theme.colors.label,
+      fontWeight: '500'
+    },
+    drop: {
+      borderWidth: 1.5,
+      borderStyle: 'dashed',
+      borderColor: hasError ? theme.colors.borderError : theme.colors.border,
+      borderRadius: theme.spacing.borderRadius + 2,
+      paddingVertical: 22,
+      alignItems: 'center',
+      backgroundColor: theme.colors.backgroundDisabled,
+      gap: 6
+    },
+    dropTitle: {
+      fontSize: theme.typography.fontSize,
+      color: theme.colors.text,
+      fontWeight: '600'
+    },
+    dropMeta: {
+      fontSize: theme.typography.helperFontSize,
+      color: theme.colors.label
+    },
+    list: {
+      marginTop: theme.spacing.gap
+    },
+    item: {
+      flexDirection: 'row',
+      alignItems: 'center',
+      gap: 10,
+      paddingVertical: 8,
+      borderBottomWidth: _reactNative.StyleSheet.hairlineWidth,
+      borderBottomColor: theme.colors.border
+    },
+    thumb: {
+      width: 40,
+      height: 40,
+      borderRadius: 8
+    },
+    fileIcon: {
+      width: 40,
+      height: 40,
+      borderRadius: 8,
+      alignItems: 'center',
+      justifyContent: 'center',
+      backgroundColor: theme.colors.backgroundDisabled
+    },
+    fileName: {
+      flex: 1,
+      color: theme.colors.text,
+      fontSize: theme.typography.helperFontSize + 1
+    },
+    helper: {
+      marginTop: 6,
+      fontSize: theme.typography.helperFontSize,
+      color: theme.colors.label
+    },
+    error: {
+      marginTop: 6,
+      fontSize: theme.typography.helperFontSize,
+      color: theme.colors.error
+    }
+  });
+}
+//# sourceMappingURL=FieldFlowUpload.js.map

package/lib/commonjs/components/FieldFlowUpload/FieldFlowUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_ThemeProvider","_defaultTheme","_renderIcon","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","FieldFlowUpload","value","onChange","pick","label","helperText","errorText","disabled","required","maxFiles","acceptHint","showPreviews","renderDropzone","renderFile","containerStyle","labelStyle","theme","themeOverride","testID","contextTheme","useFieldFlowTheme","useMemo","mergeDeep","defaultTheme","styles","createStyles","Boolean","atMax","length","handlePick","result","incoming","Array","isArray","room","slice","removeAt","index","filter","_","jsxs","View","style","wrap","children","Text","fileCount","openPicker","Pressable","drop","onPress","accessibilityRole","accessibilityLabel","renderFieldFlowIcon","colors","borderFocused","jsx","dropTitle","dropMeta","list","map","file","Fragment","remove","uri","isImage","mimeType","startsWith","test","name","item","Image","source","previewUri","thumb","fileIcon","icon","fileName","numberOfLines","split","pop","hitSlop","error","helper","hasError","StyleSheet","create","marginBottom","spacing","gap","opacity","fontSize","typography","labelFontSize","color","fontWeight","borderWidth","borderStyle","borderColor","borderError","border","borderRadius","paddingVertical","alignItems","backgroundColor","backgroundDisabled","text","helperFontSize","marginTop","flexDirection","borderBottomWidth","hairlineWidth","borderBottomColor","width","height","justifyContent","flex"],"sourceRoot":"../../../../src","sources":["components/FieldFlowUpload/FieldFlowUpload.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/components/FieldFlowUpload/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "FieldFlowUpload", {
+  enumerable: true,
+  get: function () {
+    return _FieldFlowUpload.FieldFlowUpload;
+  }
+});
+var _FieldFlowUpload = require("./FieldFlowUpload");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/components/FieldFlowUpload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_FieldFlowUpload","require"],"sourceRoot":"../../../../src","sources":["components/FieldFlowUpload/index.ts"],"mappings":";;;;;;;;;;;AAAA,IAAAA,gBAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/hooks/index.js

@@ -3,18 +3,48 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "useFieldFlowArray", {
+  enumerable: true,
+  get: function () {
+    return _useFieldFlowArray.useFieldFlowArray;
+  }
+});
+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, "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 () {
@@ -24,4 +54,9 @@ Object.defineProperty(exports, "useKeyboardManager", {
 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");
 //# 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;AAOA,IAAAE,cAAA,GAAAF,OAAA","ignoreList":[]}
+{"version":3,"names":["_useKeyboardManager","require","_useFieldFlowForm","_useFieldState","_useFormIntelligence","_useFieldFlowArray","_useFieldFlowDraft","_useFieldFlowSteps","_useFieldFlowDirtyGuard"],"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","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/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":[]}