react-form-rewind 0.2.0 → 0.3.0

package/dist/index.js

@@ -4,8 +4,15 @@ var react = require('react');
 
 // src/useFormHistory.ts
 var DEFAULT_MAX_HISTORY = 100;
+var DEFAULT_DEBOUNCE_MS = 300;
 function useFormHistory(initialState, options = {}) {
-  const { maxHistory = DEFAULT_MAX_HISTORY, onUndo, onRedo, onSnapshot } = options;
+  const {
+    maxHistory = DEFAULT_MAX_HISTORY,
+    debounceMs = DEFAULT_DEBOUNCE_MS,
+    onUndo,
+    onRedo,
+    onSnapshot
+  } = options;
   const pastRef = react.useRef([]);
   const futureRef = react.useRef([]);
   const [state, setStateRaw] = react.useState(initialState);
@@ -13,6 +20,9 @@ function useFormHistory(initialState, options = {}) {
   stateRef.current = state;
   const [past, setPast] = react.useState([]);
   const [future, setFuture] = react.useState([]);
+  const debounceTimerRef = react.useRef(null);
+  const pendingStateRef = react.useRef(null);
+  const preDebounceStateRef = react.useRef(null);
   const pushToPast = react.useCallback(
     (entry) => {
       const next = [...pastRef.current, entry];
@@ -24,21 +34,66 @@ function useFormHistory(initialState, options = {}) {
     },
     [maxHistory]
   );
+  react.useEffect(() => {
+    return () => {
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+      }
+    };
+  }, []);
   const setState = react.useCallback(
     (value, label) => {
       const prev = stateRef.current;
       const next = typeof value === "function" ? value(prev) : value;
       if (Object.is(prev, next)) return;
-      const entry = { state: prev, timestamp: Date.now(), label };
-      pushToPast(entry);
-      futureRef.current = [];
-      setFuture([]);
       setStateRaw(next);
       stateRef.current = next;
+      if (debounceMs <= 0) {
+        const entry = { state: prev, timestamp: Date.now(), label };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        return;
+      }
+      if (pendingStateRef.current === null) {
+        preDebounceStateRef.current = prev;
+      }
+      pendingStateRef.current = next;
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+      }
+      debounceTimerRef.current = setTimeout(() => {
+        const entry = {
+          state: preDebounceStateRef.current,
+          timestamp: Date.now(),
+          label
+        };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        debounceTimerRef.current = null;
+        pendingStateRef.current = null;
+        preDebounceStateRef.current = null;
+      }, debounceMs);
     },
-    [pushToPast]
+    [debounceMs, pushToPast]
   );
   const undo = react.useCallback(() => {
+    if (debounceTimerRef.current !== null) {
+      clearTimeout(debounceTimerRef.current);
+      debounceTimerRef.current = null;
+    }
+    if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {
+      const entry = {
+        state: preDebounceStateRef.current,
+        timestamp: Date.now()
+      };
+      pushToPast(entry);
+      futureRef.current = [];
+      setFuture([]);
+      pendingStateRef.current = null;
+      preDebounceStateRef.current = null;
+    }
     if (pastRef.current.length === 0) return;
     const prev = pastRef.current[pastRef.current.length - 1];
     const newPast = pastRef.current.slice(0, -1);
@@ -53,7 +108,7 @@ function useFormHistory(initialState, options = {}) {
     setStateRaw(prev.state);
     stateRef.current = prev.state;
     onUndo?.(prev.state);
-  }, [onUndo]);
+  }, [pushToPast, onUndo]);
   const redo = react.useCallback(() => {
     if (futureRef.current.length === 0) return;
     const next = futureRef.current[futureRef.current.length - 1];
@@ -71,6 +126,12 @@ function useFormHistory(initialState, options = {}) {
     onRedo?.(next.state);
   }, [onRedo]);
   const clearHistory = react.useCallback(() => {
+    if (debounceTimerRef.current !== null) {
+      clearTimeout(debounceTimerRef.current);
+      debounceTimerRef.current = null;
+    }
+    pendingStateRef.current = null;
+    preDebounceStateRef.current = null;
     pastRef.current = [];
     futureRef.current = [];
     setPast([]);
@@ -78,15 +139,37 @@ function useFormHistory(initialState, options = {}) {
   }, []);
   const snapshot = react.useCallback(
     (label) => {
-      const entry = {
-        state: stateRef.current,
-        timestamp: Date.now(),
-        label
-      };
-      pushToPast(entry);
-      futureRef.current = [];
-      setFuture([]);
-      onSnapshot?.(entry);
+      let didFlush = false;
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+        debounceTimerRef.current = null;
+      }
+      if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {
+        const entry = {
+          state: preDebounceStateRef.current,
+          timestamp: Date.now()
+        };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        pendingStateRef.current = null;
+        preDebounceStateRef.current = null;
+        didFlush = true;
+      }
+      if (!didFlush) {
+        const entry = {
+          state: stateRef.current,
+          timestamp: Date.now(),
+          label
+        };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        onSnapshot?.(entry);
+      } else if (label && pastRef.current.length > 0) {
+        pastRef.current[pastRef.current.length - 1].label = label;
+        setPast([...pastRef.current]);
+      }
     },
     [pushToPast, onSnapshot]
   );

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useFormHistory.ts"],"names":["useRef","useState","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useRef, useState } from \"react\";\nimport type { HistoryEntry, UseFormHistoryOptions, UseFormHistoryReturn } from \"./types\";\n\nconst DEFAULT_MAX_HISTORY = 100;\n\nexport function useFormHistory<T>(\n  initialState: T,\n  options: UseFormHistoryOptions<T> = {},\n): UseFormHistoryReturn<T> {\n  const { maxHistory = DEFAULT_MAX_HISTORY, onUndo, onRedo, onSnapshot } = options;\n\n  const pastRef = useRef<HistoryEntry<T>[]>([]);\n  const futureRef = useRef<HistoryEntry<T>[]>([]);\n\n  const [state, setStateRaw] = useState<T>(initialState);\n  const stateRef = useRef<T>(initialState);\n  stateRef.current = state;\n\n  const [past, setPast] = useState<HistoryEntry<T>[]>([]);\n  const [future, setFuture] = useState<HistoryEntry<T>[]>([]);\n\n  const pushToPast = useCallback(\n    (entry: HistoryEntry<T>) => {\n      const next = [...pastRef.current, entry];\n      if (next.length > maxHistory) {\n        next.splice(0, next.length - maxHistory);\n      }\n      pastRef.current = next;\n      setPast(next);\n    },\n    [maxHistory],\n  );\n\n  const setState = useCallback(\n    (value: T | ((prev: T) => T), label?: string) => {\n      const prev = stateRef.current;\n      const next = typeof value === \"function\" ? (value as (prev: T) => T)(prev) : value;\n\n      if (Object.is(prev, next)) return;\n\n      const entry: HistoryEntry<T> = { state: prev, timestamp: Date.now(), label };\n\n      pushToPast(entry);\n      futureRef.current = [];\n      setFuture([]);\n      setStateRaw(next);\n      stateRef.current = next;\n    },\n    [pushToPast],\n  );\n\n  const undo = useCallback(() => {\n    if (pastRef.current.length === 0) return;\n\n    const prev = pastRef.current[pastRef.current.length - 1];\n    const newPast = pastRef.current.slice(0, -1);\n    pastRef.current = newPast;\n    setPast(newPast);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    futureRef.current = [...futureRef.current, currentEntry];\n    setFuture(futureRef.current);\n\n    setStateRaw(prev.state);\n    stateRef.current = prev.state;\n    onUndo?.(prev.state);\n  }, [onUndo]);\n\n  const redo = useCallback(() => {\n    if (futureRef.current.length === 0) return;\n\n    const next = futureRef.current[futureRef.current.length - 1];\n    const newFuture = futureRef.current.slice(0, -1);\n    futureRef.current = newFuture;\n    setFuture(newFuture);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    pastRef.current = [...pastRef.current, currentEntry];\n    setPast(pastRef.current);\n\n    setStateRaw(next.state);\n    stateRef.current = next.state;\n    onRedo?.(next.state);\n  }, [onRedo]);\n\n  const clearHistory = useCallback(() => {\n    pastRef.current = [];\n    futureRef.current = [];\n    setPast([]);\n    setFuture([]);\n  }, []);\n\n  const snapshot = useCallback(\n    (label?: string) => {\n      const entry: HistoryEntry<T> = {\n        state: stateRef.current,\n        timestamp: Date.now(),\n        label,\n      };\n      pushToPast(entry);\n      futureRef.current = [];\n      setFuture([]);\n      onSnapshot?.(entry);\n    },\n    [pushToPast, onSnapshot],\n  );\n\n  const clearDraft = useCallback(() => {\n    clearHistory();\n    setStateRaw(initialState);\n    stateRef.current = initialState;\n  }, [clearHistory, initialState]);\n\n  return {\n    state,\n    setState,\n    undo,\n    redo,\n    canUndo: past.length > 0,\n    canRedo: future.length > 0,\n    clearHistory,\n    clearDraft,\n    snapshot,\n    past,\n    future,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useFormHistory.ts"],"names":["useRef","useState","useCallback","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { HistoryEntry, UseFormHistoryOptions, UseFormHistoryReturn } from \"./types\";\n\nconst DEFAULT_MAX_HISTORY = 100;\nconst DEFAULT_DEBOUNCE_MS = 300;\n\nexport function useFormHistory<T>(\n  initialState: T,\n  options: UseFormHistoryOptions<T> = {},\n): UseFormHistoryReturn<T> {\n  const {\n    maxHistory = DEFAULT_MAX_HISTORY,\n    debounceMs = DEFAULT_DEBOUNCE_MS,\n    onUndo,\n    onRedo,\n    onSnapshot,\n  } = options;\n\n  const pastRef = useRef<HistoryEntry<T>[]>([]);\n  const futureRef = useRef<HistoryEntry<T>[]>([]);\n\n  const [state, setStateRaw] = useState<T>(initialState);\n  const stateRef = useRef<T>(initialState);\n  stateRef.current = state;\n\n  const [past, setPast] = useState<HistoryEntry<T>[]>([]);\n  const [future, setFuture] = useState<HistoryEntry<T>[]>([]);\n\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const pendingStateRef = useRef<T | null>(null);\n  const preDebounceStateRef = useRef<T | null>(null);\n\n  const pushToPast = useCallback(\n    (entry: HistoryEntry<T>) => {\n      const next = [...pastRef.current, entry];\n      if (next.length > maxHistory) {\n        next.splice(0, next.length - maxHistory);\n      }\n      pastRef.current = next;\n      setPast(next);\n    },\n    [maxHistory],\n  );\n\n  useEffect(() => {\n    return () => {\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n      }\n    };\n  }, []);\n\n  const setState = useCallback(\n    (value: T | ((prev: T) => T), label?: string) => {\n      const prev = stateRef.current;\n      const next = typeof value === \"function\" ? (value as (prev: T) => T)(prev) : value;\n\n      if (Object.is(prev, next)) return;\n\n      setStateRaw(next);\n      stateRef.current = next;\n\n      if (debounceMs <= 0) {\n        const entry: HistoryEntry<T> = { state: prev, timestamp: Date.now(), label };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        return;\n      }\n\n      if (pendingStateRef.current === null) {\n        preDebounceStateRef.current = prev;\n      }\n\n      pendingStateRef.current = next;\n\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n      }\n\n      debounceTimerRef.current = setTimeout(() => {\n        const entry: HistoryEntry<T> = {\n          state: preDebounceStateRef.current!,\n          timestamp: Date.now(),\n          label,\n        };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        debounceTimerRef.current = null;\n        pendingStateRef.current = null;\n        preDebounceStateRef.current = null;\n      }, debounceMs);\n    },\n    [debounceMs, pushToPast],\n  );\n\n  const undo = useCallback(() => {\n    if (debounceTimerRef.current !== null) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = null;\n    }\n\n    if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {\n      const entry: HistoryEntry<T> = {\n        state: preDebounceStateRef.current,\n        timestamp: Date.now(),\n      };\n      pushToPast(entry);\n      futureRef.current = [];\n      setFuture([]);\n      pendingStateRef.current = null;\n      preDebounceStateRef.current = null;\n    }\n\n    if (pastRef.current.length === 0) return;\n\n    const prev = pastRef.current[pastRef.current.length - 1];\n    const newPast = pastRef.current.slice(0, -1);\n    pastRef.current = newPast;\n    setPast(newPast);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    futureRef.current = [...futureRef.current, currentEntry];\n    setFuture(futureRef.current);\n\n    setStateRaw(prev.state);\n    stateRef.current = prev.state;\n    onUndo?.(prev.state);\n  }, [pushToPast, onUndo]);\n\n  const redo = useCallback(() => {\n    if (futureRef.current.length === 0) return;\n\n    const next = futureRef.current[futureRef.current.length - 1];\n    const newFuture = futureRef.current.slice(0, -1);\n    futureRef.current = newFuture;\n    setFuture(newFuture);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    pastRef.current = [...pastRef.current, currentEntry];\n    setPast(pastRef.current);\n\n    setStateRaw(next.state);\n    stateRef.current = next.state;\n    onRedo?.(next.state);\n  }, [onRedo]);\n\n  const clearHistory = useCallback(() => {\n    if (debounceTimerRef.current !== null) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = null;\n    }\n    pendingStateRef.current = null;\n    preDebounceStateRef.current = null;\n    pastRef.current = [];\n    futureRef.current = [];\n    setPast([]);\n    setFuture([]);\n  }, []);\n\n  const snapshot = useCallback(\n    (label?: string) => {\n      let didFlush = false;\n\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n        debounceTimerRef.current = null;\n      }\n\n      if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {\n        const entry: HistoryEntry<T> = {\n          state: preDebounceStateRef.current,\n          timestamp: Date.now(),\n        };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        pendingStateRef.current = null;\n        preDebounceStateRef.current = null;\n        didFlush = true;\n      }\n\n      if (!didFlush) {\n        const entry: HistoryEntry<T> = {\n          state: stateRef.current,\n          timestamp: Date.now(),\n          label,\n        };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        onSnapshot?.(entry);\n      } else if (label && pastRef.current.length > 0) {\n        pastRef.current[pastRef.current.length - 1].label = label;\n        setPast([...pastRef.current]);\n      }\n    },\n    [pushToPast, onSnapshot],\n  );\n\n  const clearDraft = useCallback(() => {\n    clearHistory();\n    setStateRaw(initialState);\n    stateRef.current = initialState;\n  }, [clearHistory, initialState]);\n\n  return {\n    state,\n    setState,\n    undo,\n    redo,\n    canUndo: past.length > 0,\n    canRedo: future.length > 0,\n    clearHistory,\n    clearDraft,\n    snapshot,\n    past,\n    future,\n  };\n}\n"]}

package/dist/index.mjs

@@ -1,9 +1,16 @@
-import { useRef, useState, useCallback } from 'react';
+import { useRef, useState, useCallback, useEffect } from 'react';
 
 // src/useFormHistory.ts
 var DEFAULT_MAX_HISTORY = 100;
+var DEFAULT_DEBOUNCE_MS = 300;
 function useFormHistory(initialState, options = {}) {
-  const { maxHistory = DEFAULT_MAX_HISTORY, onUndo, onRedo, onSnapshot } = options;
+  const {
+    maxHistory = DEFAULT_MAX_HISTORY,
+    debounceMs = DEFAULT_DEBOUNCE_MS,
+    onUndo,
+    onRedo,
+    onSnapshot
+  } = options;
   const pastRef = useRef([]);
   const futureRef = useRef([]);
   const [state, setStateRaw] = useState(initialState);
@@ -11,6 +18,9 @@ function useFormHistory(initialState, options = {}) {
   stateRef.current = state;
   const [past, setPast] = useState([]);
   const [future, setFuture] = useState([]);
+  const debounceTimerRef = useRef(null);
+  const pendingStateRef = useRef(null);
+  const preDebounceStateRef = useRef(null);
   const pushToPast = useCallback(
     (entry) => {
       const next = [...pastRef.current, entry];
@@ -22,21 +32,66 @@ function useFormHistory(initialState, options = {}) {
     },
     [maxHistory]
   );
+  useEffect(() => {
+    return () => {
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+      }
+    };
+  }, []);
   const setState = useCallback(
     (value, label) => {
       const prev = stateRef.current;
       const next = typeof value === "function" ? value(prev) : value;
       if (Object.is(prev, next)) return;
-      const entry = { state: prev, timestamp: Date.now(), label };
-      pushToPast(entry);
-      futureRef.current = [];
-      setFuture([]);
       setStateRaw(next);
       stateRef.current = next;
+      if (debounceMs <= 0) {
+        const entry = { state: prev, timestamp: Date.now(), label };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        return;
+      }
+      if (pendingStateRef.current === null) {
+        preDebounceStateRef.current = prev;
+      }
+      pendingStateRef.current = next;
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+      }
+      debounceTimerRef.current = setTimeout(() => {
+        const entry = {
+          state: preDebounceStateRef.current,
+          timestamp: Date.now(),
+          label
+        };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        debounceTimerRef.current = null;
+        pendingStateRef.current = null;
+        preDebounceStateRef.current = null;
+      }, debounceMs);
     },
-    [pushToPast]
+    [debounceMs, pushToPast]
   );
   const undo = useCallback(() => {
+    if (debounceTimerRef.current !== null) {
+      clearTimeout(debounceTimerRef.current);
+      debounceTimerRef.current = null;
+    }
+    if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {
+      const entry = {
+        state: preDebounceStateRef.current,
+        timestamp: Date.now()
+      };
+      pushToPast(entry);
+      futureRef.current = [];
+      setFuture([]);
+      pendingStateRef.current = null;
+      preDebounceStateRef.current = null;
+    }
     if (pastRef.current.length === 0) return;
     const prev = pastRef.current[pastRef.current.length - 1];
     const newPast = pastRef.current.slice(0, -1);
@@ -51,7 +106,7 @@ function useFormHistory(initialState, options = {}) {
     setStateRaw(prev.state);
     stateRef.current = prev.state;
     onUndo?.(prev.state);
-  }, [onUndo]);
+  }, [pushToPast, onUndo]);
   const redo = useCallback(() => {
     if (futureRef.current.length === 0) return;
     const next = futureRef.current[futureRef.current.length - 1];
@@ -69,6 +124,12 @@ function useFormHistory(initialState, options = {}) {
     onRedo?.(next.state);
   }, [onRedo]);
   const clearHistory = useCallback(() => {
+    if (debounceTimerRef.current !== null) {
+      clearTimeout(debounceTimerRef.current);
+      debounceTimerRef.current = null;
+    }
+    pendingStateRef.current = null;
+    preDebounceStateRef.current = null;
     pastRef.current = [];
     futureRef.current = [];
     setPast([]);
@@ -76,15 +137,37 @@ function useFormHistory(initialState, options = {}) {
   }, []);
   const snapshot = useCallback(
     (label) => {
-      const entry = {
-        state: stateRef.current,
-        timestamp: Date.now(),
-        label
-      };
-      pushToPast(entry);
-      futureRef.current = [];
-      setFuture([]);
-      onSnapshot?.(entry);
+      let didFlush = false;
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+        debounceTimerRef.current = null;
+      }
+      if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {
+        const entry = {
+          state: preDebounceStateRef.current,
+          timestamp: Date.now()
+        };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        pendingStateRef.current = null;
+        preDebounceStateRef.current = null;
+        didFlush = true;
+      }
+      if (!didFlush) {
+        const entry = {
+          state: stateRef.current,
+          timestamp: Date.now(),
+          label
+        };
+        pushToPast(entry);
+        futureRef.current = [];
+        setFuture([]);
+        onSnapshot?.(entry);
+      } else if (label && pastRef.current.length > 0) {
+        pastRef.current[pastRef.current.length - 1].label = label;
+        setPast([...pastRef.current]);
+      }
     },
     [pushToPast, onSnapshot]
   );

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useFormHistory.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { useCallback, useRef, useState } from \"react\";\nimport type { HistoryEntry, UseFormHistoryOptions, UseFormHistoryReturn } from \"./types\";\n\nconst DEFAULT_MAX_HISTORY = 100;\n\nexport function useFormHistory<T>(\n  initialState: T,\n  options: UseFormHistoryOptions<T> = {},\n): UseFormHistoryReturn<T> {\n  const { maxHistory = DEFAULT_MAX_HISTORY, onUndo, onRedo, onSnapshot } = options;\n\n  const pastRef = useRef<HistoryEntry<T>[]>([]);\n  const futureRef = useRef<HistoryEntry<T>[]>([]);\n\n  const [state, setStateRaw] = useState<T>(initialState);\n  const stateRef = useRef<T>(initialState);\n  stateRef.current = state;\n\n  const [past, setPast] = useState<HistoryEntry<T>[]>([]);\n  const [future, setFuture] = useState<HistoryEntry<T>[]>([]);\n\n  const pushToPast = useCallback(\n    (entry: HistoryEntry<T>) => {\n      const next = [...pastRef.current, entry];\n      if (next.length > maxHistory) {\n        next.splice(0, next.length - maxHistory);\n      }\n      pastRef.current = next;\n      setPast(next);\n    },\n    [maxHistory],\n  );\n\n  const setState = useCallback(\n    (value: T | ((prev: T) => T), label?: string) => {\n      const prev = stateRef.current;\n      const next = typeof value === \"function\" ? (value as (prev: T) => T)(prev) : value;\n\n      if (Object.is(prev, next)) return;\n\n      const entry: HistoryEntry<T> = { state: prev, timestamp: Date.now(), label };\n\n      pushToPast(entry);\n      futureRef.current = [];\n      setFuture([]);\n      setStateRaw(next);\n      stateRef.current = next;\n    },\n    [pushToPast],\n  );\n\n  const undo = useCallback(() => {\n    if (pastRef.current.length === 0) return;\n\n    const prev = pastRef.current[pastRef.current.length - 1];\n    const newPast = pastRef.current.slice(0, -1);\n    pastRef.current = newPast;\n    setPast(newPast);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    futureRef.current = [...futureRef.current, currentEntry];\n    setFuture(futureRef.current);\n\n    setStateRaw(prev.state);\n    stateRef.current = prev.state;\n    onUndo?.(prev.state);\n  }, [onUndo]);\n\n  const redo = useCallback(() => {\n    if (futureRef.current.length === 0) return;\n\n    const next = futureRef.current[futureRef.current.length - 1];\n    const newFuture = futureRef.current.slice(0, -1);\n    futureRef.current = newFuture;\n    setFuture(newFuture);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    pastRef.current = [...pastRef.current, currentEntry];\n    setPast(pastRef.current);\n\n    setStateRaw(next.state);\n    stateRef.current = next.state;\n    onRedo?.(next.state);\n  }, [onRedo]);\n\n  const clearHistory = useCallback(() => {\n    pastRef.current = [];\n    futureRef.current = [];\n    setPast([]);\n    setFuture([]);\n  }, []);\n\n  const snapshot = useCallback(\n    (label?: string) => {\n      const entry: HistoryEntry<T> = {\n        state: stateRef.current,\n        timestamp: Date.now(),\n        label,\n      };\n      pushToPast(entry);\n      futureRef.current = [];\n      setFuture([]);\n      onSnapshot?.(entry);\n    },\n    [pushToPast, onSnapshot],\n  );\n\n  const clearDraft = useCallback(() => {\n    clearHistory();\n    setStateRaw(initialState);\n    stateRef.current = initialState;\n  }, [clearHistory, initialState]);\n\n  return {\n    state,\n    setState,\n    undo,\n    redo,\n    canUndo: past.length > 0,\n    canRedo: future.length > 0,\n    clearHistory,\n    clearDraft,\n    snapshot,\n    past,\n    future,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useFormHistory.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { HistoryEntry, UseFormHistoryOptions, UseFormHistoryReturn } from \"./types\";\n\nconst DEFAULT_MAX_HISTORY = 100;\nconst DEFAULT_DEBOUNCE_MS = 300;\n\nexport function useFormHistory<T>(\n  initialState: T,\n  options: UseFormHistoryOptions<T> = {},\n): UseFormHistoryReturn<T> {\n  const {\n    maxHistory = DEFAULT_MAX_HISTORY,\n    debounceMs = DEFAULT_DEBOUNCE_MS,\n    onUndo,\n    onRedo,\n    onSnapshot,\n  } = options;\n\n  const pastRef = useRef<HistoryEntry<T>[]>([]);\n  const futureRef = useRef<HistoryEntry<T>[]>([]);\n\n  const [state, setStateRaw] = useState<T>(initialState);\n  const stateRef = useRef<T>(initialState);\n  stateRef.current = state;\n\n  const [past, setPast] = useState<HistoryEntry<T>[]>([]);\n  const [future, setFuture] = useState<HistoryEntry<T>[]>([]);\n\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const pendingStateRef = useRef<T | null>(null);\n  const preDebounceStateRef = useRef<T | null>(null);\n\n  const pushToPast = useCallback(\n    (entry: HistoryEntry<T>) => {\n      const next = [...pastRef.current, entry];\n      if (next.length > maxHistory) {\n        next.splice(0, next.length - maxHistory);\n      }\n      pastRef.current = next;\n      setPast(next);\n    },\n    [maxHistory],\n  );\n\n  useEffect(() => {\n    return () => {\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n      }\n    };\n  }, []);\n\n  const setState = useCallback(\n    (value: T | ((prev: T) => T), label?: string) => {\n      const prev = stateRef.current;\n      const next = typeof value === \"function\" ? (value as (prev: T) => T)(prev) : value;\n\n      if (Object.is(prev, next)) return;\n\n      setStateRaw(next);\n      stateRef.current = next;\n\n      if (debounceMs <= 0) {\n        const entry: HistoryEntry<T> = { state: prev, timestamp: Date.now(), label };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        return;\n      }\n\n      if (pendingStateRef.current === null) {\n        preDebounceStateRef.current = prev;\n      }\n\n      pendingStateRef.current = next;\n\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n      }\n\n      debounceTimerRef.current = setTimeout(() => {\n        const entry: HistoryEntry<T> = {\n          state: preDebounceStateRef.current!,\n          timestamp: Date.now(),\n          label,\n        };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        debounceTimerRef.current = null;\n        pendingStateRef.current = null;\n        preDebounceStateRef.current = null;\n      }, debounceMs);\n    },\n    [debounceMs, pushToPast],\n  );\n\n  const undo = useCallback(() => {\n    if (debounceTimerRef.current !== null) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = null;\n    }\n\n    if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {\n      const entry: HistoryEntry<T> = {\n        state: preDebounceStateRef.current,\n        timestamp: Date.now(),\n      };\n      pushToPast(entry);\n      futureRef.current = [];\n      setFuture([]);\n      pendingStateRef.current = null;\n      preDebounceStateRef.current = null;\n    }\n\n    if (pastRef.current.length === 0) return;\n\n    const prev = pastRef.current[pastRef.current.length - 1];\n    const newPast = pastRef.current.slice(0, -1);\n    pastRef.current = newPast;\n    setPast(newPast);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    futureRef.current = [...futureRef.current, currentEntry];\n    setFuture(futureRef.current);\n\n    setStateRaw(prev.state);\n    stateRef.current = prev.state;\n    onUndo?.(prev.state);\n  }, [pushToPast, onUndo]);\n\n  const redo = useCallback(() => {\n    if (futureRef.current.length === 0) return;\n\n    const next = futureRef.current[futureRef.current.length - 1];\n    const newFuture = futureRef.current.slice(0, -1);\n    futureRef.current = newFuture;\n    setFuture(newFuture);\n\n    const currentEntry: HistoryEntry<T> = {\n      state: stateRef.current,\n      timestamp: Date.now(),\n    };\n    pastRef.current = [...pastRef.current, currentEntry];\n    setPast(pastRef.current);\n\n    setStateRaw(next.state);\n    stateRef.current = next.state;\n    onRedo?.(next.state);\n  }, [onRedo]);\n\n  const clearHistory = useCallback(() => {\n    if (debounceTimerRef.current !== null) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = null;\n    }\n    pendingStateRef.current = null;\n    preDebounceStateRef.current = null;\n    pastRef.current = [];\n    futureRef.current = [];\n    setPast([]);\n    setFuture([]);\n  }, []);\n\n  const snapshot = useCallback(\n    (label?: string) => {\n      let didFlush = false;\n\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n        debounceTimerRef.current = null;\n      }\n\n      if (pendingStateRef.current !== null && preDebounceStateRef.current !== null) {\n        const entry: HistoryEntry<T> = {\n          state: preDebounceStateRef.current,\n          timestamp: Date.now(),\n        };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        pendingStateRef.current = null;\n        preDebounceStateRef.current = null;\n        didFlush = true;\n      }\n\n      if (!didFlush) {\n        const entry: HistoryEntry<T> = {\n          state: stateRef.current,\n          timestamp: Date.now(),\n          label,\n        };\n        pushToPast(entry);\n        futureRef.current = [];\n        setFuture([]);\n        onSnapshot?.(entry);\n      } else if (label && pastRef.current.length > 0) {\n        pastRef.current[pastRef.current.length - 1].label = label;\n        setPast([...pastRef.current]);\n      }\n    },\n    [pushToPast, onSnapshot],\n  );\n\n  const clearDraft = useCallback(() => {\n    clearHistory();\n    setStateRaw(initialState);\n    stateRef.current = initialState;\n  }, [clearHistory, initialState]);\n\n  return {\n    state,\n    setState,\n    undo,\n    redo,\n    canUndo: past.length > 0,\n    canRedo: future.length > 0,\n    clearHistory,\n    clearDraft,\n    snapshot,\n    past,\n    future,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-rewind",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zero-dependency React state engine with auto-saved history stacks, time-traveling undo/redo, keyboard shortcuts, and draft persistence for forms.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",