react-form-rewind 0.4.0 → 0.5.0

package/README.md

@@ -51,7 +51,7 @@ import { useFormHistory } from "react-form-rewind";
 function MyForm() {
   const { state, setState, undo, redo, canUndo, canRedo } = useFormHistory(
     { name: "", email: "" },
-    { persist: { key: "my-form-draft" } }
+    { keyboard: true, persist: { key: "my-form-draft" } }
   );
 
   return (
@@ -108,6 +108,7 @@ The core hook that manages a history-backed state stack.
 | `maxHistory` | `number` | `100` | Maximum past entries to retain |
 | `debounceMs` | `number` | `300` | Debounce window for rapid state changes |
 | `persist` | `boolean \| PersistOptions` | `false` | Enable draft persistence |
+| `keyboard` | `boolean` | `false` | Enable Ctrl+Z / Ctrl+Shift+Z keyboard shortcuts |
 | `onUndo` | `(state: T) => void` | — | Callback after undo |
 | `onRedo` | `(state: T) => void` | — | Callback after redo |
 | `onSnapshot` | `(entry: HistoryEntry<T>) => void` | — | Callback when a snapshot is committed |
@@ -126,7 +127,7 @@ The core hook that manages a history-backed state stack.
 
 ### Keyboard Shortcuts
 
-Shortcuts are enabled by default. Press **Ctrl+Z** to undo, **Ctrl+Shift+Z** or **Ctrl+Y** to redo. On macOS, **Ctrl** maps to **Cmd** automatically.
+Pass `keyboard: true` to enable built-in shortcuts. Press **Ctrl+Z** to undo, **Ctrl+Shift+Z** or **Ctrl+Y** to redo. On macOS, **Ctrl** maps to **Cmd** automatically.
 
 ### Snapshot Debouncing
 

package/dist/index.d.mts

@@ -3,15 +3,11 @@ interface HistoryEntry<T> {
     timestamp: number;
     label?: string;
 }
-interface HistoryStack<T> {
-    past: HistoryEntry<T>[];
-    present: T;
-    future: HistoryEntry<T>[];
-}
 interface UseFormHistoryOptions<T> {
     maxHistory?: number;
     debounceMs?: number;
     persist?: boolean | PersistOptions;
+    keyboard?: boolean;
     onUndo?: (state: T) => void;
     onRedo?: (state: T) => void;
     onSnapshot?: (entry: HistoryEntry<T>) => void;
@@ -37,4 +33,4 @@ interface UseFormHistoryReturn<T> {
 
 declare function useFormHistory<T>(initialState: T, options?: UseFormHistoryOptions<T>): UseFormHistoryReturn<T>;
 
-export { type HistoryEntry, type HistoryStack, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };
+export { type HistoryEntry, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };

package/dist/index.d.ts

@@ -3,15 +3,11 @@ interface HistoryEntry<T> {
     timestamp: number;
     label?: string;
 }
-interface HistoryStack<T> {
-    past: HistoryEntry<T>[];
-    present: T;
-    future: HistoryEntry<T>[];
-}
 interface UseFormHistoryOptions<T> {
     maxHistory?: number;
     debounceMs?: number;
     persist?: boolean | PersistOptions;
+    keyboard?: boolean;
     onUndo?: (state: T) => void;
     onRedo?: (state: T) => void;
     onSnapshot?: (entry: HistoryEntry<T>) => void;
@@ -37,4 +33,4 @@ interface UseFormHistoryReturn<T> {
 
 declare function useFormHistory<T>(initialState: T, options?: UseFormHistoryOptions<T>): UseFormHistoryReturn<T>;
 
-export { type HistoryEntry, type HistoryStack, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };
+export { type HistoryEntry, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };

package/dist/index.js

@@ -1,284 +1 @@
-'use strict';
-
-var react = require('react');
-
-// src/useFormHistory.ts
-var DEFAULT_MAX_HISTORY = 100;
-var DEFAULT_DEBOUNCE_MS = 300;
-var DEFAULT_PERSIST_DEBOUNCE_MS = 500;
-var DEFAULT_PERSIST_VERSION = 1;
-function normalizePersist(persist) {
-  if (!persist) return null;
-  if (typeof persist === "boolean") return null;
-  return {
-    key: persist.key,
-    debounceMs: persist.debounceMs ?? DEFAULT_PERSIST_DEBOUNCE_MS,
-    version: persist.version ?? DEFAULT_PERSIST_VERSION
-  };
-}
-function readDraft(key, version) {
-  try {
-    if (typeof window === "undefined" || !window.localStorage) return null;
-    const raw = window.localStorage.getItem(key);
-    if (!raw) return null;
-    const parsed = JSON.parse(raw);
-    if (parsed.__version !== version) {
-      window.localStorage.removeItem(key);
-      return null;
-    }
-    return parsed.__state;
-  } catch {
-    return null;
-  }
-}
-function writeDraft(key, state, version) {
-  try {
-    if (typeof window === "undefined" || !window.localStorage) return;
-    window.localStorage.setItem(key, JSON.stringify({ __state: state, __version: version }));
-  } catch {
-  }
-}
-function removeDraft(key) {
-  try {
-    if (typeof window === "undefined" || !window.localStorage) return;
-    window.localStorage.removeItem(key);
-  } catch {
-  }
-}
-function useFormHistory(initialState, options = {}) {
-  const {
-    maxHistory = DEFAULT_MAX_HISTORY,
-    debounceMs = DEFAULT_DEBOUNCE_MS,
-    persist: persistOption,
-    onUndo,
-    onRedo,
-    onSnapshot
-  } = options;
-  const persist = normalizePersist(persistOption);
-  const initializedRef = react.useRef(false);
-  const [state, setStateRaw] = react.useState(() => {
-    if (persist) {
-      const draft = readDraft(persist.key, persist.version);
-      if (draft !== null) {
-        initializedRef.current = true;
-        return draft;
-      }
-    }
-    return initialState;
-  });
-  const stateRef = react.useRef(state);
-  stateRef.current = state;
-  const pastRef = react.useRef([]);
-  const futureRef = react.useRef([]);
-  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 persistTimerRef = react.useRef(null);
-  const pushToPast = react.useCallback(
-    (entry) => {
-      const next = [...pastRef.current, entry];
-      if (next.length > maxHistory) {
-        next.splice(0, next.length - maxHistory);
-      }
-      pastRef.current = next;
-      setPast(next);
-    },
-    [maxHistory]
-  );
-  react.useEffect(() => {
-    return () => {
-      if (debounceTimerRef.current !== null) {
-        clearTimeout(debounceTimerRef.current);
-      }
-      if (persistTimerRef.current !== null) {
-        clearTimeout(persistTimerRef.current);
-      }
-    };
-  }, []);
-  const schedulePersist = react.useCallback(
-    (nextState) => {
-      if (!persist) return;
-      if (persistTimerRef.current !== null) {
-        clearTimeout(persistTimerRef.current);
-      }
-      persistTimerRef.current = setTimeout(() => {
-        writeDraft(persist.key, nextState, persist.version);
-        persistTimerRef.current = null;
-      }, persist.debounceMs);
-    },
-    [persist]
-  );
-  const persistNow = react.useCallback(
-    (nextState) => {
-      if (!persist) return;
-      if (persistTimerRef.current !== null) {
-        clearTimeout(persistTimerRef.current);
-        persistTimerRef.current = null;
-      }
-      writeDraft(persist.key, nextState, persist.version);
-    },
-    [persist]
-  );
-  const setState = react.useCallback(
-    (value, label) => {
-      const prev = stateRef.current;
-      const next = typeof value === "function" ? value(prev) : value;
-      if (Object.is(prev, next)) return;
-      setStateRaw(next);
-      stateRef.current = next;
-      schedulePersist(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);
-    },
-    [debounceMs, pushToPast, schedulePersist]
-  );
-  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);
-    pastRef.current = newPast;
-    setPast(newPast);
-    const currentEntry = {
-      state: stateRef.current,
-      timestamp: Date.now()
-    };
-    futureRef.current = [...futureRef.current, currentEntry];
-    setFuture(futureRef.current);
-    setStateRaw(prev.state);
-    stateRef.current = prev.state;
-    persistNow(prev.state);
-    onUndo?.(prev.state);
-  }, [pushToPast, onUndo, persistNow]);
-  const redo = react.useCallback(() => {
-    if (futureRef.current.length === 0) return;
-    const next = futureRef.current[futureRef.current.length - 1];
-    const newFuture = futureRef.current.slice(0, -1);
-    futureRef.current = newFuture;
-    setFuture(newFuture);
-    const currentEntry = {
-      state: stateRef.current,
-      timestamp: Date.now()
-    };
-    pastRef.current = [...pastRef.current, currentEntry];
-    setPast(pastRef.current);
-    setStateRaw(next.state);
-    stateRef.current = next.state;
-    persistNow(next.state);
-    onRedo?.(next.state);
-  }, [onRedo, persistNow]);
-  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([]);
-    setFuture([]);
-  }, []);
-  const snapshot = react.useCallback(
-    (label) => {
-      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]
-  );
-  const clearDraft = react.useCallback(() => {
-    clearHistory();
-    if (persist) {
-      removeDraft(persist.key);
-    }
-    setStateRaw(initialState);
-    stateRef.current = initialState;
-  }, [clearHistory, initialState, persist]);
-  return {
-    state,
-    setState,
-    undo,
-    redo,
-    canUndo: past.length > 0,
-    canRedo: future.length > 0,
-    clearHistory,
-    clearDraft,
-    snapshot,
-    past,
-    future
-  };
-}
-
-exports.useFormHistory = useFormHistory;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+'use strict';var react=require('react');var j=100,V=300,X=500,Y=1;function q(e){return !e||typeof e=="boolean"?null:{key:e.key,debounceMs:e.debounceMs??X,version:e.version??Y}}function U(){return typeof window<"u"&&!!window.localStorage}function G(e,g){try{if(!U())return null;let f=window.localStorage.getItem(e);if(!f)return null;let E=JSON.parse(f);return E.__v!==g?(window.localStorage.removeItem(e),null):E.__s}catch{return null}}function K(e,g,f){try{if(!U())return;window.localStorage.setItem(e,JSON.stringify({__s:g,__v:f}));}catch{}}function Q(e){try{if(!U())return;window.localStorage.removeItem(e);}catch{}}function W(e,g={}){let{maxHistory:f=j,debounceMs:E=V,persist:C,keyboard:P=false,onUndo:k,onRedo:I,onSnapshot:M}=g,n=q(C),[R,h]=react.useState(()=>{if(n){let t=G(n.key,n.version);if(t!==null)return t}return e}),a=react.useRef(R);a.current=R;let u=react.useRef([]),c=react.useRef([]),[x,H]=react.useState([]),[L,S]=react.useState([]),o=react.useRef(null),m=react.useRef(null),i=react.useRef(null),y=react.useRef(null),T=react.useCallback(()=>{c.current=[],S([]);},[]),p=react.useCallback(t=>{let r=[...u.current,t];r.length>f&&r.splice(0,r.length-f),u.current=r,H(r);},[f]);react.useEffect(()=>()=>{o.current!==null&&clearTimeout(o.current),y.current!==null&&clearTimeout(y.current);},[]);let N=react.useCallback(t=>{n&&(y.current!==null&&clearTimeout(y.current),y.current=setTimeout(()=>{K(n.key,t,n.version),y.current=null;},n.debounceMs));},[n]),v=react.useCallback(t=>{n&&(y.current!==null&&(clearTimeout(y.current),y.current=null),K(n.key,t,n.version));},[n]),z=react.useCallback((t,r)=>{let s=a.current,d=typeof t=="function"?t(s):t;if(!Object.is(s,d)){if(h(d),a.current=d,N(d),E<=0){let F={state:s,timestamp:Date.now(),label:r};p(F),T();return}m.current===null&&(i.current=s),m.current=d,o.current!==null&&clearTimeout(o.current),o.current=setTimeout(()=>{let F={state:i.current,timestamp:Date.now(),label:r};p(F),T(),o.current=null,m.current=null,i.current=null;},E);}},[E,p,N,T]),D=react.useCallback(()=>{if(o.current!==null&&(clearTimeout(o.current),o.current=null),m.current!==null&&i.current!==null){let d={state:i.current,timestamp:Date.now()};p(d),T(),m.current=null,i.current=null;}if(u.current.length===0)return;let t=u.current[u.current.length-1],r=u.current.slice(0,-1);u.current=r,H(r);let s={state:a.current,timestamp:Date.now()};c.current=[...c.current,s],S(c.current),h(t.state),a.current=t.state,v(t.state),k?.(t.state);},[p,k,v,T]),_=react.useCallback(()=>{if(c.current.length===0)return;let t=c.current[c.current.length-1],r=c.current.slice(0,-1);c.current=r,S(r);let s={state:a.current,timestamp:Date.now()};u.current=[...u.current,s],H(u.current),h(t.state),a.current=t.state,v(t.state),I?.(t.state);},[I,v]);react.useEffect(()=>{if(!P)return;let t=r=>{!(r.metaKey||r.ctrlKey)||r.key!=="z"||(r.preventDefault(),r.shiftKey?_():D());};return window.addEventListener("keydown",t),()=>window.removeEventListener("keydown",t)},[P,D,_]);let b=react.useCallback(()=>{o.current!==null&&(clearTimeout(o.current),o.current=null),m.current=null,i.current=null,u.current=[],c.current=[],H([]),S([]);},[]),B=react.useCallback(t=>{let r=false;if(o.current!==null&&(clearTimeout(o.current),o.current=null),m.current!==null&&i.current!==null){let s={state:i.current,timestamp:Date.now()};p(s),T(),m.current=null,i.current=null,r=true;}if(r)t&&u.current.length>0&&(u.current[u.current.length-1].label=t,H([...u.current]));else {let s={state:a.current,timestamp:Date.now(),label:t};p(s),T(),M?.(s);}},[p,M,T]),J=react.useCallback(()=>{b(),n&&Q(n.key),h(e),a.current=e;},[b,e,n]);return {state:R,setState:z,undo:D,redo:_,canUndo:x.length>0,canRedo:L.length>0,clearHistory:b,clearDraft:J,snapshot:B,past:x,future:L}}exports.useFormHistory=W;

package/dist/index.mjs

@@ -1,282 +1 @@
-import { useRef, useState, useCallback, useEffect } from 'react';
-
-// src/useFormHistory.ts
-var DEFAULT_MAX_HISTORY = 100;
-var DEFAULT_DEBOUNCE_MS = 300;
-var DEFAULT_PERSIST_DEBOUNCE_MS = 500;
-var DEFAULT_PERSIST_VERSION = 1;
-function normalizePersist(persist) {
-  if (!persist) return null;
-  if (typeof persist === "boolean") return null;
-  return {
-    key: persist.key,
-    debounceMs: persist.debounceMs ?? DEFAULT_PERSIST_DEBOUNCE_MS,
-    version: persist.version ?? DEFAULT_PERSIST_VERSION
-  };
-}
-function readDraft(key, version) {
-  try {
-    if (typeof window === "undefined" || !window.localStorage) return null;
-    const raw = window.localStorage.getItem(key);
-    if (!raw) return null;
-    const parsed = JSON.parse(raw);
-    if (parsed.__version !== version) {
-      window.localStorage.removeItem(key);
-      return null;
-    }
-    return parsed.__state;
-  } catch {
-    return null;
-  }
-}
-function writeDraft(key, state, version) {
-  try {
-    if (typeof window === "undefined" || !window.localStorage) return;
-    window.localStorage.setItem(key, JSON.stringify({ __state: state, __version: version }));
-  } catch {
-  }
-}
-function removeDraft(key) {
-  try {
-    if (typeof window === "undefined" || !window.localStorage) return;
-    window.localStorage.removeItem(key);
-  } catch {
-  }
-}
-function useFormHistory(initialState, options = {}) {
-  const {
-    maxHistory = DEFAULT_MAX_HISTORY,
-    debounceMs = DEFAULT_DEBOUNCE_MS,
-    persist: persistOption,
-    onUndo,
-    onRedo,
-    onSnapshot
-  } = options;
-  const persist = normalizePersist(persistOption);
-  const initializedRef = useRef(false);
-  const [state, setStateRaw] = useState(() => {
-    if (persist) {
-      const draft = readDraft(persist.key, persist.version);
-      if (draft !== null) {
-        initializedRef.current = true;
-        return draft;
-      }
-    }
-    return initialState;
-  });
-  const stateRef = useRef(state);
-  stateRef.current = state;
-  const pastRef = useRef([]);
-  const futureRef = useRef([]);
-  const [past, setPast] = useState([]);
-  const [future, setFuture] = useState([]);
-  const debounceTimerRef = useRef(null);
-  const pendingStateRef = useRef(null);
-  const preDebounceStateRef = useRef(null);
-  const persistTimerRef = useRef(null);
-  const pushToPast = useCallback(
-    (entry) => {
-      const next = [...pastRef.current, entry];
-      if (next.length > maxHistory) {
-        next.splice(0, next.length - maxHistory);
-      }
-      pastRef.current = next;
-      setPast(next);
-    },
-    [maxHistory]
-  );
-  useEffect(() => {
-    return () => {
-      if (debounceTimerRef.current !== null) {
-        clearTimeout(debounceTimerRef.current);
-      }
-      if (persistTimerRef.current !== null) {
-        clearTimeout(persistTimerRef.current);
-      }
-    };
-  }, []);
-  const schedulePersist = useCallback(
-    (nextState) => {
-      if (!persist) return;
-      if (persistTimerRef.current !== null) {
-        clearTimeout(persistTimerRef.current);
-      }
-      persistTimerRef.current = setTimeout(() => {
-        writeDraft(persist.key, nextState, persist.version);
-        persistTimerRef.current = null;
-      }, persist.debounceMs);
-    },
-    [persist]
-  );
-  const persistNow = useCallback(
-    (nextState) => {
-      if (!persist) return;
-      if (persistTimerRef.current !== null) {
-        clearTimeout(persistTimerRef.current);
-        persistTimerRef.current = null;
-      }
-      writeDraft(persist.key, nextState, persist.version);
-    },
-    [persist]
-  );
-  const setState = useCallback(
-    (value, label) => {
-      const prev = stateRef.current;
-      const next = typeof value === "function" ? value(prev) : value;
-      if (Object.is(prev, next)) return;
-      setStateRaw(next);
-      stateRef.current = next;
-      schedulePersist(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);
-    },
-    [debounceMs, pushToPast, schedulePersist]
-  );
-  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);
-    pastRef.current = newPast;
-    setPast(newPast);
-    const currentEntry = {
-      state: stateRef.current,
-      timestamp: Date.now()
-    };
-    futureRef.current = [...futureRef.current, currentEntry];
-    setFuture(futureRef.current);
-    setStateRaw(prev.state);
-    stateRef.current = prev.state;
-    persistNow(prev.state);
-    onUndo?.(prev.state);
-  }, [pushToPast, onUndo, persistNow]);
-  const redo = useCallback(() => {
-    if (futureRef.current.length === 0) return;
-    const next = futureRef.current[futureRef.current.length - 1];
-    const newFuture = futureRef.current.slice(0, -1);
-    futureRef.current = newFuture;
-    setFuture(newFuture);
-    const currentEntry = {
-      state: stateRef.current,
-      timestamp: Date.now()
-    };
-    pastRef.current = [...pastRef.current, currentEntry];
-    setPast(pastRef.current);
-    setStateRaw(next.state);
-    stateRef.current = next.state;
-    persistNow(next.state);
-    onRedo?.(next.state);
-  }, [onRedo, persistNow]);
-  const clearHistory = useCallback(() => {
-    if (debounceTimerRef.current !== null) {
-      clearTimeout(debounceTimerRef.current);
-      debounceTimerRef.current = null;
-    }
-    pendingStateRef.current = null;
-    preDebounceStateRef.current = null;
-    pastRef.current = [];
-    futureRef.current = [];
-    setPast([]);
-    setFuture([]);
-  }, []);
-  const snapshot = useCallback(
-    (label) => {
-      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]
-  );
-  const clearDraft = useCallback(() => {
-    clearHistory();
-    if (persist) {
-      removeDraft(persist.key);
-    }
-    setStateRaw(initialState);
-    stateRef.current = initialState;
-  }, [clearHistory, initialState, persist]);
-  return {
-    state,
-    setState,
-    undo,
-    redo,
-    canUndo: past.length > 0,
-    canRedo: future.length > 0,
-    clearHistory,
-    clearDraft,
-    snapshot,
-    past,
-    future
-  };
-}
-
-export { useFormHistory };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+import {useState,useRef,useCallback,useEffect}from'react';var j=100,V=300,X=500,Y=1;function q(e){return !e||typeof e=="boolean"?null:{key:e.key,debounceMs:e.debounceMs??X,version:e.version??Y}}function U(){return typeof window<"u"&&!!window.localStorage}function G(e,g){try{if(!U())return null;let f=window.localStorage.getItem(e);if(!f)return null;let E=JSON.parse(f);return E.__v!==g?(window.localStorage.removeItem(e),null):E.__s}catch{return null}}function K(e,g,f){try{if(!U())return;window.localStorage.setItem(e,JSON.stringify({__s:g,__v:f}));}catch{}}function Q(e){try{if(!U())return;window.localStorage.removeItem(e);}catch{}}function W(e,g={}){let{maxHistory:f=j,debounceMs:E=V,persist:C,keyboard:P=false,onUndo:k,onRedo:I,onSnapshot:M}=g,n=q(C),[R,h]=useState(()=>{if(n){let t=G(n.key,n.version);if(t!==null)return t}return e}),a=useRef(R);a.current=R;let u=useRef([]),c=useRef([]),[x,H]=useState([]),[L,S]=useState([]),o=useRef(null),m=useRef(null),i=useRef(null),y=useRef(null),T=useCallback(()=>{c.current=[],S([]);},[]),p=useCallback(t=>{let r=[...u.current,t];r.length>f&&r.splice(0,r.length-f),u.current=r,H(r);},[f]);useEffect(()=>()=>{o.current!==null&&clearTimeout(o.current),y.current!==null&&clearTimeout(y.current);},[]);let N=useCallback(t=>{n&&(y.current!==null&&clearTimeout(y.current),y.current=setTimeout(()=>{K(n.key,t,n.version),y.current=null;},n.debounceMs));},[n]),v=useCallback(t=>{n&&(y.current!==null&&(clearTimeout(y.current),y.current=null),K(n.key,t,n.version));},[n]),z=useCallback((t,r)=>{let s=a.current,d=typeof t=="function"?t(s):t;if(!Object.is(s,d)){if(h(d),a.current=d,N(d),E<=0){let F={state:s,timestamp:Date.now(),label:r};p(F),T();return}m.current===null&&(i.current=s),m.current=d,o.current!==null&&clearTimeout(o.current),o.current=setTimeout(()=>{let F={state:i.current,timestamp:Date.now(),label:r};p(F),T(),o.current=null,m.current=null,i.current=null;},E);}},[E,p,N,T]),D=useCallback(()=>{if(o.current!==null&&(clearTimeout(o.current),o.current=null),m.current!==null&&i.current!==null){let d={state:i.current,timestamp:Date.now()};p(d),T(),m.current=null,i.current=null;}if(u.current.length===0)return;let t=u.current[u.current.length-1],r=u.current.slice(0,-1);u.current=r,H(r);let s={state:a.current,timestamp:Date.now()};c.current=[...c.current,s],S(c.current),h(t.state),a.current=t.state,v(t.state),k?.(t.state);},[p,k,v,T]),_=useCallback(()=>{if(c.current.length===0)return;let t=c.current[c.current.length-1],r=c.current.slice(0,-1);c.current=r,S(r);let s={state:a.current,timestamp:Date.now()};u.current=[...u.current,s],H(u.current),h(t.state),a.current=t.state,v(t.state),I?.(t.state);},[I,v]);useEffect(()=>{if(!P)return;let t=r=>{!(r.metaKey||r.ctrlKey)||r.key!=="z"||(r.preventDefault(),r.shiftKey?_():D());};return window.addEventListener("keydown",t),()=>window.removeEventListener("keydown",t)},[P,D,_]);let b=useCallback(()=>{o.current!==null&&(clearTimeout(o.current),o.current=null),m.current=null,i.current=null,u.current=[],c.current=[],H([]),S([]);},[]),B=useCallback(t=>{let r=false;if(o.current!==null&&(clearTimeout(o.current),o.current=null),m.current!==null&&i.current!==null){let s={state:i.current,timestamp:Date.now()};p(s),T(),m.current=null,i.current=null,r=true;}if(r)t&&u.current.length>0&&(u.current[u.current.length-1].label=t,H([...u.current]));else {let s={state:a.current,timestamp:Date.now(),label:t};p(s),T(),M?.(s);}},[p,M,T]),J=useCallback(()=>{b(),n&&Q(n.key),h(e),a.current=e;},[b,e,n]);return {state:R,setState:z,undo:D,redo:_,canUndo:x.length>0,canRedo:L.length>0,clearHistory:b,clearDraft:J,snapshot:B,past:x,future:L}}export{W as useFormHistory};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-rewind",
-  "version": "0.4.0",
+  "version": "0.5.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",

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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, PersistOptions, UseFormHistoryOptions, UseFormHistoryReturn } from \"./types\";\n\nconst DEFAULT_MAX_HISTORY = 100;\nconst DEFAULT_DEBOUNCE_MS = 300;\nconst DEFAULT_PERSIST_DEBOUNCE_MS = 500;\nconst DEFAULT_PERSIST_VERSION = 1;\n\ninterface PersistStorage {\n  key: string;\n  debounceMs: number;\n  version: number;\n}\n\nfunction normalizePersist(persist: boolean | PersistOptions | undefined): PersistStorage | null {\n  if (!persist) return null;\n  if (typeof persist === \"boolean\") return null;\n  return {\n    key: persist.key,\n    debounceMs: persist.debounceMs ?? DEFAULT_PERSIST_DEBOUNCE_MS,\n    version: persist.version ?? DEFAULT_PERSIST_VERSION,\n  };\n}\n\nfunction readDraft<T>(key: string, version: number): T | null {\n  try {\n    if (typeof window === \"undefined\" || !window.localStorage) return null;\n    const raw = window.localStorage.getItem(key);\n    if (!raw) return null;\n    const parsed = JSON.parse(raw);\n    if (parsed.__version !== version) {\n      window.localStorage.removeItem(key);\n      return null;\n    }\n    return parsed.__state as T;\n  } catch {\n    return null;\n  }\n}\n\nfunction writeDraft<T>(key: string, state: T, version: number): void {\n  try {\n    if (typeof window === \"undefined\" || !window.localStorage) return;\n    window.localStorage.setItem(key, JSON.stringify({ __state: state, __version: version }));\n  } catch {\n    // localStorage full or disabled — silently ignore\n  }\n}\n\nfunction removeDraft(key: string): void {\n  try {\n    if (typeof window === \"undefined\" || !window.localStorage) return;\n    window.localStorage.removeItem(key);\n  } catch {\n    // silently ignore\n  }\n}\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    persist: persistOption,\n    onUndo,\n    onRedo,\n    onSnapshot,\n  } = options;\n\n  const persist = normalizePersist(persistOption);\n  const initializedRef = useRef(false);\n\n  // Hydrate from localStorage on first render\n  const [state, setStateRaw] = useState<T>(() => {\n    if (persist) {\n      const draft = readDraft<T>(persist.key, persist.version);\n      if (draft !== null) {\n        initializedRef.current = true;\n        return draft;\n      }\n    }\n    return initialState;\n  });\n\n  const stateRef = useRef<T>(state);\n  stateRef.current = state;\n\n  const pastRef = useRef<HistoryEntry<T>[]>([]);\n  const futureRef = useRef<HistoryEntry<T>[]>([]);\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  // Persist debounce timer\n  const persistTimerRef = useRef<ReturnType<typeof setTimeout> | 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  // Cleanup timers on unmount\n  useEffect(() => {\n    return () => {\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      if (persistTimerRef.current !== null) {\n        clearTimeout(persistTimerRef.current);\n      }\n    };\n  }, []);\n\n  // Debounced persist helper\n  const schedulePersist = useCallback(\n    (nextState: T) => {\n      if (!persist) return;\n      if (persistTimerRef.current !== null) {\n        clearTimeout(persistTimerRef.current);\n      }\n      persistTimerRef.current = setTimeout(() => {\n        writeDraft(persist.key, nextState, persist.version);\n        persistTimerRef.current = null;\n      }, persist.debounceMs);\n    },\n    [persist],\n  );\n\n  // Persist immediately (used by undo/redo/snapshot/clearDraft which bypass debounce)\n  const persistNow = useCallback(\n    (nextState: T) => {\n      if (!persist) return;\n      if (persistTimerRef.current !== null) {\n        clearTimeout(persistTimerRef.current);\n        persistTimerRef.current = null;\n      }\n      writeDraft(persist.key, nextState, persist.version);\n    },\n    [persist],\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      schedulePersist(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, schedulePersist],\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    persistNow(prev.state);\n    onUndo?.(prev.state);\n  }, [pushToPast, onUndo, persistNow]);\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    persistNow(next.state);\n    onRedo?.(next.state);\n  }, [onRedo, persistNow]);\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    if (persist) {\n      removeDraft(persist.key);\n    }\n    setStateRaw(initialState);\n    stateRef.current = initialState;\n  }, [clearHistory, initialState, persist]);\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.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useFormHistory.ts"],"names":[],"mappings":";;;AAGA,IAAM,mBAAA,GAAsB,GAAA;AAC5B,IAAM,mBAAA,GAAsB,GAAA;AAC5B,IAAM,2BAAA,GAA8B,GAAA;AACpC,IAAM,uBAAA,GAA0B,CAAA;AAQhC,SAAS,iBAAiB,OAAA,EAAsE;AAC9F,EAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACrB,EAAA,IAAI,OAAO,OAAA,KAAY,SAAA,EAAW,OAAO,IAAA;AACzC,EAAA,OAAO;AAAA,IACL,KAAK,OAAA,CAAQ,GAAA;AAAA,IACb,UAAA,EAAY,QAAQ,UAAA,IAAc,2BAAA;AAAA,IAClC,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA,GAC9B;AACF;AAEA,SAAS,SAAA,CAAa,KAAa,OAAA,EAA2B;AAC5D,EAAA,IAAI;AACF,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,MAAA,CAAO,cAAc,OAAO,IAAA;AAClE,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,GAAG,CAAA;AAC3C,IAAA,IAAI,CAAC,KAAK,OAAO,IAAA;AACjB,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC7B,IAAA,IAAI,MAAA,CAAO,cAAc,OAAA,EAAS;AAChC,MAAA,MAAA,CAAO,YAAA,CAAa,WAAW,GAAG,CAAA;AAClC,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,OAAO,MAAA,CAAO,OAAA;AAAA,EAChB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEA,SAAS,UAAA,CAAc,GAAA,EAAa,KAAA,EAAU,OAAA,EAAuB;AACnE,EAAA,IAAI;AACF,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,YAAA,EAAc;AAC3D,IAAA,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAA,EAAS,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,CAAC,CAAA;AAAA,EACzF,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAEA,SAAS,YAAY,GAAA,EAAmB;AACtC,EAAA,IAAI;AACF,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,YAAA,EAAc;AAC3D,IAAA,MAAA,CAAO,YAAA,CAAa,WAAW,GAAG,CAAA;AAAA,EACpC,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAEO,SAAS,cAAA,CACd,YAAA,EACA,OAAA,GAAoC,EAAC,EACZ;AACzB,EAAA,MAAM;AAAA,IACJ,UAAA,GAAa,mBAAA;AAAA,IACb,UAAA,GAAa,mBAAA;AAAA,IACb,OAAA,EAAS,aAAA;AAAA,IACT,MAAA;AAAA,IACA,MAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,OAAA,GAAU,iBAAiB,aAAa,CAAA;AAC9C,EAAA,MAAM,cAAA,GAAiB,OAAO,KAAK,CAAA;AAGnC,EAAA,MAAM,CAAC,KAAA,EAAO,WAAW,CAAA,GAAI,SAAY,MAAM;AAC7C,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,MAAM,KAAA,GAAQ,SAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,QAAQ,OAAO,CAAA;AACvD,MAAA,IAAI,UAAU,IAAA,EAAM;AAClB,QAAA,cAAA,CAAe,OAAA,GAAU,IAAA;AACzB,QAAA,OAAO,KAAA;AAAA,MACT;AAAA,IACF;AACA,IAAA,OAAO,YAAA;AAAA,EACT,CAAC,CAAA;AAED,EAAA,MAAM,QAAA,GAAW,OAAU,KAAK,CAAA;AAChC,EAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAEnB,EAAA,MAAM,OAAA,GAAU,MAAA,CAA0B,EAAE,CAAA;AAC5C,EAAA,MAAM,SAAA,GAAY,MAAA,CAA0B,EAAE,CAAA;AAE9C,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAI,QAAA,CAA4B,EAAE,CAAA;AACtD,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,QAAA,CAA4B,EAAE,CAAA;AAE1D,EAAA,MAAM,gBAAA,GAAmB,OAA6C,IAAI,CAAA;AAC1E,EAAA,MAAM,eAAA,GAAkB,OAAiB,IAAI,CAAA;AAC7C,EAAA,MAAM,mBAAA,GAAsB,OAAiB,IAAI,CAAA;AAGjD,EAAA,MAAM,eAAA,GAAkB,OAA6C,IAAI,CAAA;AAEzE,EAAA,MAAM,UAAA,GAAa,WAAA;AAAA,IACjB,CAAC,KAAA,KAA2B;AAC1B,MAAA,MAAM,IAAA,GAAO,CAAC,GAAG,OAAA,CAAQ,SAAS,KAAK,CAAA;AACvC,MAAA,IAAI,IAAA,CAAK,SAAS,UAAA,EAAY;AAC5B,QAAA,IAAA,CAAK,MAAA,CAAO,CAAA,EAAG,IAAA,CAAK,MAAA,GAAS,UAAU,CAAA;AAAA,MACzC;AACA,MAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,MAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,IACd,CAAA;AAAA,IACA,CAAC,UAAU;AAAA,GACb;AAGA,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,gBAAA,CAAiB,YAAY,IAAA,EAAM;AACrC,QAAA,YAAA,CAAa,iBAAiB,OAAO,CAAA;AAAA,MACvC;AACA,MAAA,IAAI,eAAA,CAAgB,YAAY,IAAA,EAAM;AACpC,QAAA,YAAA,CAAa,gBAAgB,OAAO,CAAA;AAAA,MACtC;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,MAAM,eAAA,GAAkB,WAAA;AAAA,IACtB,CAAC,SAAA,KAAiB;AAChB,MAAA,IAAI,CAAC,OAAA,EAAS;AACd,MAAA,IAAI,eAAA,CAAgB,YAAY,IAAA,EAAM;AACpC,QAAA,YAAA,CAAa,gBAAgB,OAAO,CAAA;AAAA,MACtC;AACA,MAAA,eAAA,CAAgB,OAAA,GAAU,WAAW,MAAM;AACzC,QAAA,UAAA,CAAW,OAAA,CAAQ,GAAA,EAAK,SAAA,EAAW,OAAA,CAAQ,OAAO,CAAA;AAClD,QAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAAA,MAC5B,CAAA,EAAG,QAAQ,UAAU,CAAA;AAAA,IACvB,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAGA,EAAA,MAAM,UAAA,GAAa,WAAA;AAAA,IACjB,CAAC,SAAA,KAAiB;AAChB,MAAA,IAAI,CAAC,OAAA,EAAS;AACd,MAAA,IAAI,eAAA,CAAgB,YAAY,IAAA,EAAM;AACpC,QAAA,YAAA,CAAa,gBAAgB,OAAO,CAAA;AACpC,QAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAAA,MAC5B;AACA,MAAA,UAAA,CAAW,OAAA,CAAQ,GAAA,EAAK,SAAA,EAAW,OAAA,CAAQ,OAAO,CAAA;AAAA,IACpD,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,MAAM,QAAA,GAAW,WAAA;AAAA,IACf,CAAC,OAA6B,KAAA,KAAmB;AAC/C,MAAA,MAAM,OAAO,QAAA,CAAS,OAAA;AACtB,MAAA,MAAM,OAAO,OAAO,KAAA,KAAU,UAAA,GAAc,KAAA,CAAyB,IAAI,CAAA,GAAI,KAAA;AAE7E,MAAA,IAAI,MAAA,CAAO,EAAA,CAAG,IAAA,EAAM,IAAI,CAAA,EAAG;AAE3B,MAAA,WAAA,CAAY,IAAI,CAAA;AAChB,MAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AACnB,MAAA,eAAA,CAAgB,IAAI,CAAA;AAEpB,MAAA,IAAI,cAAc,CAAA,EAAG;AACnB,QAAA,MAAM,KAAA,GAAyB,EAAE,KAAA,EAAO,IAAA,EAAM,WAAW,IAAA,CAAK,GAAA,IAAO,KAAA,EAAM;AAC3E,QAAA,UAAA,CAAW,KAAK,CAAA;AAChB,QAAA,SAAA,CAAU,UAAU,EAAC;AACrB,QAAA,SAAA,CAAU,EAAE,CAAA;AACZ,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,eAAA,CAAgB,YAAY,IAAA,EAAM;AACpC,QAAA,mBAAA,CAAoB,OAAA,GAAU,IAAA;AAAA,MAChC;AAEA,MAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAE1B,MAAA,IAAI,gBAAA,CAAiB,YAAY,IAAA,EAAM;AACrC,QAAA,YAAA,CAAa,iBAAiB,OAAO,CAAA;AAAA,MACvC;AAEA,MAAA,gBAAA,CAAiB,OAAA,GAAU,WAAW,MAAM;AAC1C,QAAA,MAAM,KAAA,GAAyB;AAAA,UAC7B,OAAO,mBAAA,CAAoB,OAAA;AAAA,UAC3B,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,UACpB;AAAA,SACF;AACA,QAAA,UAAA,CAAW,KAAK,CAAA;AAChB,QAAA,SAAA,CAAU,UAAU,EAAC;AACrB,QAAA,SAAA,CAAU,EAAE,CAAA;AACZ,QAAA,gBAAA,CAAiB,OAAA,GAAU,IAAA;AAC3B,QAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAC1B,QAAA,mBAAA,CAAoB,OAAA,GAAU,IAAA;AAAA,MAChC,GAAG,UAAU,CAAA;AAAA,IACf,CAAA;AAAA,IACA,CAAC,UAAA,EAAY,UAAA,EAAY,eAAe;AAAA,GAC1C;AAEA,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM;AAC7B,IAAA,IAAI,gBAAA,CAAiB,YAAY,IAAA,EAAM;AACrC,MAAA,YAAA,CAAa,iBAAiB,OAAO,CAAA;AACrC,MAAA,gBAAA,CAAiB,OAAA,GAAU,IAAA;AAAA,IAC7B;AAEA,IAAA,IAAI,eAAA,CAAgB,OAAA,KAAY,IAAA,IAAQ,mBAAA,CAAoB,YAAY,IAAA,EAAM;AAC5E,MAAA,MAAM,KAAA,GAAyB;AAAA,QAC7B,OAAO,mBAAA,CAAoB,OAAA;AAAA,QAC3B,SAAA,EAAW,KAAK,GAAA;AAAI,OACtB;AACA,MAAA,UAAA,CAAW,KAAK,CAAA;AAChB,MAAA,SAAA,CAAU,UAAU,EAAC;AACrB,MAAA,SAAA,CAAU,EAAE,CAAA;AACZ,MAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAC1B,MAAA,mBAAA,CAAoB,OAAA,GAAU,IAAA;AAAA,IAChC;AAEA,IAAA,IAAI,OAAA,CAAQ,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG;AAElC,IAAA,MAAM,OAAO,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,SAAS,CAAC,CAAA;AACvD,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,OAAA,CAAQ,KAAA,CAAM,GAAG,EAAE,CAAA;AAC3C,IAAA,OAAA,CAAQ,OAAA,GAAU,OAAA;AAClB,IAAA,OAAA,CAAQ,OAAO,CAAA;AAEf,IAAA,MAAM,YAAA,GAAgC;AAAA,MACpC,OAAO,QAAA,CAAS,OAAA;AAAA,MAChB,SAAA,EAAW,KAAK,GAAA;AAAI,KACtB;AACA,IAAA,SAAA,CAAU,OAAA,GAAU,CAAC,GAAG,SAAA,CAAU,SAAS,YAAY,CAAA;AACvD,IAAA,SAAA,CAAU,UAAU,OAAO,CAAA;AAE3B,IAAA,WAAA,CAAY,KAAK,KAAK,CAAA;AACtB,IAAA,QAAA,CAAS,UAAU,IAAA,CAAK,KAAA;AACxB,IAAA,UAAA,CAAW,KAAK,KAAK,CAAA;AACrB,IAAA,MAAA,GAAS,KAAK,KAAK,CAAA;AAAA,EACrB,CAAA,EAAG,CAAC,UAAA,EAAY,MAAA,EAAQ,UAAU,CAAC,CAAA;AAEnC,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM;AAC7B,IAAA,IAAI,SAAA,CAAU,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG;AAEpC,IAAA,MAAM,OAAO,SAAA,CAAU,OAAA,CAAQ,SAAA,CAAU,OAAA,CAAQ,SAAS,CAAC,CAAA;AAC3D,IAAA,MAAM,SAAA,GAAY,SAAA,CAAU,OAAA,CAAQ,KAAA,CAAM,GAAG,EAAE,CAAA;AAC/C,IAAA,SAAA,CAAU,OAAA,GAAU,SAAA;AACpB,IAAA,SAAA,CAAU,SAAS,CAAA;AAEnB,IAAA,MAAM,YAAA,GAAgC;AAAA,MACpC,OAAO,QAAA,CAAS,OAAA;AAAA,MAChB,SAAA,EAAW,KAAK,GAAA;AAAI,KACtB;AACA,IAAA,OAAA,CAAQ,OAAA,GAAU,CAAC,GAAG,OAAA,CAAQ,SAAS,YAAY,CAAA;AACnD,IAAA,OAAA,CAAQ,QAAQ,OAAO,CAAA;AAEvB,IAAA,WAAA,CAAY,KAAK,KAAK,CAAA;AACtB,IAAA,QAAA,CAAS,UAAU,IAAA,CAAK,KAAA;AACxB,IAAA,UAAA,CAAW,KAAK,KAAK,CAAA;AACrB,IAAA,MAAA,GAAS,KAAK,KAAK,CAAA;AAAA,EACrB,CAAA,EAAG,CAAC,MAAA,EAAQ,UAAU,CAAC,CAAA;AAEvB,EAAA,MAAM,YAAA,GAAe,YAAY,MAAM;AACrC,IAAA,IAAI,gBAAA,CAAiB,YAAY,IAAA,EAAM;AACrC,MAAA,YAAA,CAAa,iBAAiB,OAAO,CAAA;AACrC,MAAA,gBAAA,CAAiB,OAAA,GAAU,IAAA;AAAA,IAC7B;AACA,IAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAC1B,IAAA,mBAAA,CAAoB,OAAA,GAAU,IAAA;AAC9B,IAAA,OAAA,CAAQ,UAAU,EAAC;AACnB,IAAA,SAAA,CAAU,UAAU,EAAC;AACrB,IAAA,OAAA,CAAQ,EAAE,CAAA;AACV,IAAA,SAAA,CAAU,EAAE,CAAA;AAAA,EACd,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,QAAA,GAAW,WAAA;AAAA,IACf,CAAC,KAAA,KAAmB;AAClB,MAAA,IAAI,QAAA,GAAW,KAAA;AAEf,MAAA,IAAI,gBAAA,CAAiB,YAAY,IAAA,EAAM;AACrC,QAAA,YAAA,CAAa,iBAAiB,OAAO,CAAA;AACrC,QAAA,gBAAA,CAAiB,OAAA,GAAU,IAAA;AAAA,MAC7B;AAEA,MAAA,IAAI,eAAA,CAAgB,OAAA,KAAY,IAAA,IAAQ,mBAAA,CAAoB,YAAY,IAAA,EAAM;AAC5E,QAAA,MAAM,KAAA,GAAyB;AAAA,UAC7B,OAAO,mBAAA,CAAoB,OAAA;AAAA,UAC3B,SAAA,EAAW,KAAK,GAAA;AAAI,SACtB;AACA,QAAA,UAAA,CAAW,KAAK,CAAA;AAChB,QAAA,SAAA,CAAU,UAAU,EAAC;AACrB,QAAA,SAAA,CAAU,EAAE,CAAA;AACZ,QAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAC1B,QAAA,mBAAA,CAAoB,OAAA,GAAU,IAAA;AAC9B,QAAA,QAAA,GAAW,IAAA;AAAA,MACb;AAEA,MAAA,IAAI,CAAC,QAAA,EAAU;AACb,QAAA,MAAM,KAAA,GAAyB;AAAA,UAC7B,OAAO,QAAA,CAAS,OAAA;AAAA,UAChB,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,UACpB;AAAA,SACF;AACA,QAAA,UAAA,CAAW,KAAK,CAAA;AAChB,QAAA,SAAA,CAAU,UAAU,EAAC;AACrB,QAAA,SAAA,CAAU,EAAE,CAAA;AACZ,QAAA,UAAA,GAAa,KAAK,CAAA;AAAA,MACpB,CAAA,MAAA,IAAW,KAAA,IAAS,OAAA,CAAQ,OAAA,CAAQ,SAAS,CAAA,EAAG;AAC9C,QAAA,OAAA,CAAQ,QAAQ,OAAA,CAAQ,OAAA,CAAQ,MAAA,GAAS,CAAC,EAAE,KAAA,GAAQ,KAAA;AACpD,QAAA,OAAA,CAAQ,CAAC,GAAG,OAAA,CAAQ,OAAO,CAAC,CAAA;AAAA,MAC9B;AAAA,IACF,CAAA;AAAA,IACA,CAAC,YAAY,UAAU;AAAA,GACzB;AAEA,EAAA,MAAM,UAAA,GAAa,YAAY,MAAM;AACnC,IAAA,YAAA,EAAa;AACb,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,WAAA,CAAY,QAAQ,GAAG,CAAA;AAAA,IACzB;AACA,IAAA,WAAA,CAAY,YAAY,CAAA;AACxB,IAAA,QAAA,CAAS,OAAA,GAAU,YAAA;AAAA,EACrB,CAAA,EAAG,CAAC,YAAA,EAAc,YAAA,EAAc,OAAO,CAAC,CAAA;AAExC,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,QAAA;AAAA,IACA,IAAA;AAAA,IACA,IAAA;AAAA,IACA,OAAA,EAAS,KAAK,MAAA,GAAS,CAAA;AAAA,IACvB,OAAA,EAAS,OAAO,MAAA,GAAS,CAAA;AAAA,IACzB,YAAA;AAAA,IACA,UAAA;AAAA,IACA,QAAA;AAAA,IACA,IAAA;AAAA,IACA;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { HistoryEntry, PersistOptions, UseFormHistoryOptions, UseFormHistoryReturn } from \"./types\";\n\nconst DEFAULT_MAX_HISTORY = 100;\nconst DEFAULT_DEBOUNCE_MS = 300;\nconst DEFAULT_PERSIST_DEBOUNCE_MS = 500;\nconst DEFAULT_PERSIST_VERSION = 1;\n\ninterface PersistStorage {\n  key: string;\n  debounceMs: number;\n  version: number;\n}\n\nfunction normalizePersist(persist: boolean | PersistOptions | undefined): PersistStorage | null {\n  if (!persist) return null;\n  if (typeof persist === \"boolean\") return null;\n  return {\n    key: persist.key,\n    debounceMs: persist.debounceMs ?? DEFAULT_PERSIST_DEBOUNCE_MS,\n    version: persist.version ?? DEFAULT_PERSIST_VERSION,\n  };\n}\n\nfunction readDraft<T>(key: string, version: number): T | null {\n  try {\n    if (typeof window === \"undefined\" || !window.localStorage) return null;\n    const raw = window.localStorage.getItem(key);\n    if (!raw) return null;\n    const parsed = JSON.parse(raw);\n    if (parsed.__version !== version) {\n      window.localStorage.removeItem(key);\n      return null;\n    }\n    return parsed.__state as T;\n  } catch {\n    return null;\n  }\n}\n\nfunction writeDraft<T>(key: string, state: T, version: number): void {\n  try {\n    if (typeof window === \"undefined\" || !window.localStorage) return;\n    window.localStorage.setItem(key, JSON.stringify({ __state: state, __version: version }));\n  } catch {\n    // localStorage full or disabled — silently ignore\n  }\n}\n\nfunction removeDraft(key: string): void {\n  try {\n    if (typeof window === \"undefined\" || !window.localStorage) return;\n    window.localStorage.removeItem(key);\n  } catch {\n    // silently ignore\n  }\n}\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    persist: persistOption,\n    onUndo,\n    onRedo,\n    onSnapshot,\n  } = options;\n\n  const persist = normalizePersist(persistOption);\n  const initializedRef = useRef(false);\n\n  // Hydrate from localStorage on first render\n  const [state, setStateRaw] = useState<T>(() => {\n    if (persist) {\n      const draft = readDraft<T>(persist.key, persist.version);\n      if (draft !== null) {\n        initializedRef.current = true;\n        return draft;\n      }\n    }\n    return initialState;\n  });\n\n  const stateRef = useRef<T>(state);\n  stateRef.current = state;\n\n  const pastRef = useRef<HistoryEntry<T>[]>([]);\n  const futureRef = useRef<HistoryEntry<T>[]>([]);\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  // Persist debounce timer\n  const persistTimerRef = useRef<ReturnType<typeof setTimeout> | 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  // Cleanup timers on unmount\n  useEffect(() => {\n    return () => {\n      if (debounceTimerRef.current !== null) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      if (persistTimerRef.current !== null) {\n        clearTimeout(persistTimerRef.current);\n      }\n    };\n  }, []);\n\n  // Debounced persist helper\n  const schedulePersist = useCallback(\n    (nextState: T) => {\n      if (!persist) return;\n      if (persistTimerRef.current !== null) {\n        clearTimeout(persistTimerRef.current);\n      }\n      persistTimerRef.current = setTimeout(() => {\n        writeDraft(persist.key, nextState, persist.version);\n        persistTimerRef.current = null;\n      }, persist.debounceMs);\n    },\n    [persist],\n  );\n\n  // Persist immediately (used by undo/redo/snapshot/clearDraft which bypass debounce)\n  const persistNow = useCallback(\n    (nextState: T) => {\n      if (!persist) return;\n      if (persistTimerRef.current !== null) {\n        clearTimeout(persistTimerRef.current);\n        persistTimerRef.current = null;\n      }\n      writeDraft(persist.key, nextState, persist.version);\n    },\n    [persist],\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      schedulePersist(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, schedulePersist],\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    persistNow(prev.state);\n    onUndo?.(prev.state);\n  }, [pushToPast, onUndo, persistNow]);\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    persistNow(next.state);\n    onRedo?.(next.state);\n  }, [onRedo, persistNow]);\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    if (persist) {\n      removeDraft(persist.key);\n    }\n    setStateRaw(initialState);\n    stateRef.current = initialState;\n  }, [clearHistory, initialState, persist]);\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"]}