react-form-rewind 0.4.0 → 1.0.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

@@ -1,17 +1,47 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface FieldRules {
+    required?: boolean | string;
+    pattern?: RegExp | {
+        value: RegExp;
+        message: string;
+    };
+    minLength?: number | {
+        value: number;
+        message: string;
+    };
+    maxLength?: number | {
+        value: number;
+        message: string;
+    };
+    min?: number | {
+        value: number;
+        message: string;
+    };
+    max?: number | {
+        value: number;
+        message: string;
+    };
+    validate?: (value: unknown) => string | null;
+}
+interface FieldError {
+    message: string;
+    type: string;
+}
+declare function validateField(value: unknown, rules: FieldRules): FieldError | null;
+declare function validateAll(state: Record<string, unknown>, fieldRules: Record<string, FieldRules>): Record<string, FieldError>;
+
 interface HistoryEntry<T> {
     state: 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;
@@ -34,7 +64,65 @@ interface UseFormHistoryReturn<T> {
     past: HistoryEntry<T>[];
     future: HistoryEntry<T>[];
 }
+interface FieldMeta {
+    name: string;
+    rules?: FieldRules;
+    touched: boolean;
+}
+interface FormRewindContextValue {
+    state: Record<string, unknown>;
+    setState: (name: string, value: unknown) => void;
+    errors: Record<string, FieldError>;
+    setError: (name: string, error: FieldError) => void;
+    clearError: (name: string) => void;
+    touched: Record<string, boolean>;
+    touch: (name: string) => void;
+    fields: Record<string, FieldMeta>;
+    registerField: (name: string, rules?: FieldRules) => void;
+    unregisterField: (name: string) => void;
+}
 
 declare function useFormHistory<T>(initialState: T, options?: UseFormHistoryOptions<T>): UseFormHistoryReturn<T>;
 
-export { type HistoryEntry, type HistoryStack, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };
+declare function useFormRewindContext(): FormRewindContextValue;
+interface FormRewindProps<T extends Record<string, unknown>> {
+    initialState: T;
+    children: ReactNode;
+    onSubmit?: (state: T) => void;
+    maxHistory?: UseFormHistoryOptions<T>["maxHistory"];
+    debounceMs?: UseFormHistoryOptions<T>["debounceMs"];
+    persist?: UseFormHistoryOptions<T>["persist"];
+    keyboard?: UseFormHistoryOptions<T>["keyboard"];
+}
+declare function FormRewind<T extends Record<string, unknown>>({ initialState, children, onSubmit, maxHistory, debounceMs, persist, keyboard, }: FormRewindProps<T>): react.JSX.Element;
+
+interface BaseFieldProps {
+    name: string;
+    label?: string;
+    rules?: FieldRules;
+    className?: string;
+    style?: React.CSSProperties;
+}
+interface TextFieldProps extends BaseFieldProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, "name" | "value" | "onChange"> {
+}
+declare function TextField({ name, label, rules, className, style, ...inputProps }: TextFieldProps): react.JSX.Element;
+interface NumberFieldProps extends BaseFieldProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, "name" | "value" | "onChange" | "type"> {
+}
+declare function NumberField({ name, label, rules, className, style, ...inputProps }: NumberFieldProps): react.JSX.Element;
+interface CheckboxFieldProps extends BaseFieldProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, "name" | "checked" | "onChange"> {
+}
+declare function CheckboxField({ name, label, rules, className, style, ...inputProps }: CheckboxFieldProps): react.JSX.Element;
+interface SelectOption {
+    value: string;
+    label: string;
+}
+interface SelectFieldProps extends BaseFieldProps {
+    options: SelectOption[];
+    placeholder?: string;
+}
+declare function SelectField({ name, label, rules, options, placeholder, className, style }: SelectFieldProps): react.JSX.Element;
+interface TextareaFieldProps extends BaseFieldProps, Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "name" | "value" | "onChange"> {
+}
+declare function TextareaField({ name, label, rules, className, style, ...textareaProps }: TextareaFieldProps): react.JSX.Element;
+
+export { CheckboxField, type FieldError, type FieldMeta, type FieldRules, FormRewind, type FormRewindContextValue, type FormRewindProps, type HistoryEntry, NumberField, type PersistOptions, SelectField, TextField, TextareaField, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory, useFormRewindContext, validateAll, validateField };

package/dist/index.d.ts

@@ -1,17 +1,47 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface FieldRules {
+    required?: boolean | string;
+    pattern?: RegExp | {
+        value: RegExp;
+        message: string;
+    };
+    minLength?: number | {
+        value: number;
+        message: string;
+    };
+    maxLength?: number | {
+        value: number;
+        message: string;
+    };
+    min?: number | {
+        value: number;
+        message: string;
+    };
+    max?: number | {
+        value: number;
+        message: string;
+    };
+    validate?: (value: unknown) => string | null;
+}
+interface FieldError {
+    message: string;
+    type: string;
+}
+declare function validateField(value: unknown, rules: FieldRules): FieldError | null;
+declare function validateAll(state: Record<string, unknown>, fieldRules: Record<string, FieldRules>): Record<string, FieldError>;
+
 interface HistoryEntry<T> {
     state: 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;
@@ -34,7 +64,65 @@ interface UseFormHistoryReturn<T> {
     past: HistoryEntry<T>[];
     future: HistoryEntry<T>[];
 }
+interface FieldMeta {
+    name: string;
+    rules?: FieldRules;
+    touched: boolean;
+}
+interface FormRewindContextValue {
+    state: Record<string, unknown>;
+    setState: (name: string, value: unknown) => void;
+    errors: Record<string, FieldError>;
+    setError: (name: string, error: FieldError) => void;
+    clearError: (name: string) => void;
+    touched: Record<string, boolean>;
+    touch: (name: string) => void;
+    fields: Record<string, FieldMeta>;
+    registerField: (name: string, rules?: FieldRules) => void;
+    unregisterField: (name: string) => void;
+}
 
 declare function useFormHistory<T>(initialState: T, options?: UseFormHistoryOptions<T>): UseFormHistoryReturn<T>;
 
-export { type HistoryEntry, type HistoryStack, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };
+declare function useFormRewindContext(): FormRewindContextValue;
+interface FormRewindProps<T extends Record<string, unknown>> {
+    initialState: T;
+    children: ReactNode;
+    onSubmit?: (state: T) => void;
+    maxHistory?: UseFormHistoryOptions<T>["maxHistory"];
+    debounceMs?: UseFormHistoryOptions<T>["debounceMs"];
+    persist?: UseFormHistoryOptions<T>["persist"];
+    keyboard?: UseFormHistoryOptions<T>["keyboard"];
+}
+declare function FormRewind<T extends Record<string, unknown>>({ initialState, children, onSubmit, maxHistory, debounceMs, persist, keyboard, }: FormRewindProps<T>): react.JSX.Element;
+
+interface BaseFieldProps {
+    name: string;
+    label?: string;
+    rules?: FieldRules;
+    className?: string;
+    style?: React.CSSProperties;
+}
+interface TextFieldProps extends BaseFieldProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, "name" | "value" | "onChange"> {
+}
+declare function TextField({ name, label, rules, className, style, ...inputProps }: TextFieldProps): react.JSX.Element;
+interface NumberFieldProps extends BaseFieldProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, "name" | "value" | "onChange" | "type"> {
+}
+declare function NumberField({ name, label, rules, className, style, ...inputProps }: NumberFieldProps): react.JSX.Element;
+interface CheckboxFieldProps extends BaseFieldProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, "name" | "checked" | "onChange"> {
+}
+declare function CheckboxField({ name, label, rules, className, style, ...inputProps }: CheckboxFieldProps): react.JSX.Element;
+interface SelectOption {
+    value: string;
+    label: string;
+}
+interface SelectFieldProps extends BaseFieldProps {
+    options: SelectOption[];
+    placeholder?: string;
+}
+declare function SelectField({ name, label, rules, options, placeholder, className, style }: SelectFieldProps): react.JSX.Element;
+interface TextareaFieldProps extends BaseFieldProps, Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "name" | "value" | "onChange"> {
+}
+declare function TextareaField({ name, label, rules, className, style, ...textareaProps }: TextareaFieldProps): react.JSX.Element;
+
+export { CheckboxField, type FieldError, type FieldMeta, type FieldRules, FormRewind, type FormRewindContextValue, type FormRewindProps, type HistoryEntry, NumberField, type PersistOptions, SelectField, TextField, TextareaField, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory, useFormRewindContext, validateAll, validateField };

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'),jsxRuntime=require('react/jsx-runtime');var ue=100,ce=300,ae=500,de=1;function pe(e){return !e||typeof e=="boolean"?null:{key:e.key,debounceMs:e.debounceMs??ae,version:e.version??de}}function K(){return typeof window<"u"&&!!window.localStorage}function me(e,t){try{if(!K())return null;let s=window.localStorage.getItem(e);if(!s)return null;let u=JSON.parse(s);return u.__v!==t?(window.localStorage.removeItem(e),null):u.__s}catch{return null}}function Y(e,t,s){try{if(!K())return;window.localStorage.setItem(e,JSON.stringify({__s:t,__v:s}));}catch{}}function ge(e){try{if(!K())return;window.localStorage.removeItem(e);}catch{}}function z(e,t={}){let{maxHistory:s=ue,debounceMs:u=ce,persist:i,keyboard:a=false,onUndo:r,onRedo:c,onSnapshot:T}=t,n=pe(i),[m,x]=react.useState(()=>{if(n){let l=me(n.key,n.version);if(l!==null)return l}return e}),d=react.useRef(m);d.current=m;let y=react.useRef([]),b=react.useRef([]),[U,S]=react.useState([]),[I,L]=react.useState([]),F=react.useRef(null),E=react.useRef(null),o=react.useRef(null),p=react.useRef(null),f=react.useCallback(()=>{b.current=[],L([]);},[]),R=react.useCallback(l=>{let g=[...y.current,l];g.length>s&&g.splice(0,g.length-s),y.current=g,S(g);},[s]);react.useEffect(()=>()=>{F.current!==null&&clearTimeout(F.current),p.current!==null&&clearTimeout(p.current);},[]);let M=react.useCallback(l=>{n&&(p.current!==null&&clearTimeout(p.current),p.current=setTimeout(()=>{Y(n.key,l,n.version),p.current=null;},n.debounceMs));},[n]),_=react.useCallback(l=>{n&&(p.current!==null&&(clearTimeout(p.current),p.current=null),Y(n.key,l,n.version));},[n]),se=react.useCallback((l,g)=>{let v=d.current,C=typeof l=="function"?l(v):l;if(!Object.is(v,C)){if(x(C),d.current=C,M(C),u<=0){let q={state:v,timestamp:Date.now(),label:g};R(q),f();return}E.current===null&&(o.current=v),E.current=C,F.current!==null&&clearTimeout(F.current),F.current=setTimeout(()=>{let q={state:o.current,timestamp:Date.now(),label:g};R(q),f(),F.current=null,E.current=null,o.current=null;},u);}},[u,R,M,f]),A=react.useCallback(()=>{if(F.current!==null&&(clearTimeout(F.current),F.current=null),E.current!==null&&o.current!==null){let C={state:o.current,timestamp:Date.now()};R(C),f(),E.current=null,o.current=null;}if(y.current.length===0)return;let l=y.current[y.current.length-1],g=y.current.slice(0,-1);y.current=g,S(g);let v={state:d.current,timestamp:Date.now()};b.current=[...b.current,v],L(b.current),x(l.state),d.current=l.state,_(l.state),r?.(l.state);},[R,r,_,f]),$=react.useCallback(()=>{if(b.current.length===0)return;let l=b.current[b.current.length-1],g=b.current.slice(0,-1);b.current=g,L(g);let v={state:d.current,timestamp:Date.now()};y.current=[...y.current,v],S(y.current),x(l.state),d.current=l.state,_(l.state),c?.(l.state);},[c,_]);react.useEffect(()=>{if(!a)return;let l=g=>{!(g.metaKey||g.ctrlKey)||g.key!=="z"||(g.preventDefault(),g.shiftKey?$():A());};return window.addEventListener("keydown",l),()=>window.removeEventListener("keydown",l)},[a,A,$]);let V=react.useCallback(()=>{F.current!==null&&(clearTimeout(F.current),F.current=null),E.current=null,o.current=null,y.current=[],b.current=[],S([]),L([]);},[]),ie=react.useCallback(l=>{let g=false;if(F.current!==null&&(clearTimeout(F.current),F.current=null),E.current!==null&&o.current!==null){let v={state:o.current,timestamp:Date.now()};R(v),f(),E.current=null,o.current=null,g=true;}if(g)l&&y.current.length>0&&(y.current[y.current.length-1].label=l,S([...y.current]));else {let v={state:d.current,timestamp:Date.now(),label:l};R(v),f(),T?.(v);}},[R,T,f]),le=react.useCallback(()=>{V(),n&&ge(n.key),x(e),d.current=e;},[V,e,n]);return {state:m,setState:se,undo:A,redo:$,canUndo:U.length>0,canRedo:I.length>0,clearHistory:V,clearDraft:le,snapshot:ie,past:U,future:I}}function N(e,t){return e&&typeof e=="object"&&"value"in e?e:{value:e,message:t}}function B(e,t){let u=typeof e=="number"?e:Number(e);if(t.required&&(typeof e=="string"?e.trim()==="":e==null||e===false))return {message:typeof t.required=="string"?t.required:"Required",type:"required"};if(t.pattern!=null){let{value:i,message:a}=N(t.pattern,"Invalid format");if(typeof e=="string"&&!i.test(e))return {message:a,type:"pattern"}}if(t.minLength!=null&&typeof e=="string"){let{value:i,message:a}=N(t.minLength,`Min ${t.minLength} characters`);if(e.length<i)return {message:a,type:"minLength"}}if(t.maxLength!=null&&typeof e=="string"){let{value:i,message:a}=N(t.maxLength,`Max ${t.maxLength} characters`);if(e.length>i)return {message:a,type:"maxLength"}}if(t.min!=null&&!isNaN(u)){let{value:i,message:a}=N(t.min,`Min ${t.min}`);if(u<i)return {message:a,type:"min"}}if(t.max!=null&&!isNaN(u)){let{value:i,message:a}=N(t.max,`Max ${t.max}`);if(u>i)return {message:a,type:"max"}}if(t.validate){let i=t.validate(e);if(i)return {message:i,type:"validate"}}return null}function J(e,t){let s={};for(let u in t){let i=B(e[u],t[u]);i&&(s[u]=i);}return s}var W=react.createContext(null);function H(){let e=react.useContext(W);if(!e)throw new Error("useFormRewindContext must be used within <FormRewind>");return e}function Z({initialState:e,children:t,onSubmit:s,maxHistory:u,debounceMs:i,persist:a,keyboard:r}){let c=z(e,{maxHistory:u,debounceMs:i,persist:a,keyboard:r}),[T,n]=react.useState({}),[m,x]=react.useState({}),d=react.useRef({}),y=react.useCallback((o,p)=>{d.current[o]=p??{};},[]),b=react.useCallback(o=>{delete d.current[o];},[]),U=react.useCallback((o,p)=>{n(f=>({...f,[o]:p}));},[]),S=react.useCallback(o=>{n(p=>{let f={...p};return delete f[o],f});},[]),I=react.useCallback(o=>{x(p=>({...p,[o]:true}));},[]),L=react.useCallback((o,p)=>{if(c.setState(f=>({...f,[o]:p}),o),m[o]&&d.current[o]){let f=B(p,d.current[o]);n(f?R=>({...R,[o]:f}):R=>{let M={...R};return delete M[o],M});}},[c.setState,m]),F=react.useCallback(o=>{o&&o.preventDefault();let p={};for(let R in d.current)p[R]=true;x(p);let f=J(c.state,d.current);return n(f),Object.keys(f).length===0&&s&&s(c.state),Object.keys(f).length===0},[c.state,s]),E={state:c.state,setState:L,errors:T,setError:U,clearError:S,touched:m,touch:I,fields:Object.fromEntries(Object.entries(d.current).map(([o,p])=>[o,{name:o,rules:p,touched:!!m[o]}])),registerField:y,unregisterField:b};return jsxRuntime.jsx(W.Provider,{value:E,children:jsxRuntime.jsx("form",{onSubmit:F,noValidate:true,children:t})})}function ee({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();react.useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=x=>{r.setState(e,x.target.value);},T=()=>{r.touch(e);},n=r.errors[e],m=String(r.state[e]??"");return jsxRuntime.jsxs("div",{className:u,style:i,children:[t&&jsxRuntime.jsx("label",{htmlFor:e,children:t}),jsxRuntime.jsx("input",{id:e,type:"text",value:m,onChange:c,onBlur:T,"aria-invalid":!!n,"aria-describedby":n?`${e}-error`:void 0,...a}),n&&jsxRuntime.jsx("span",{id:`${e}-error`,role:"alert",children:n.message})]})}function te({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();react.useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=x=>{let d=x.target.value===""?"":Number(x.target.value);r.setState(e,d);},T=()=>{r.touch(e);},n=r.errors[e],m=r.state[e];return jsxRuntime.jsxs("div",{className:u,style:i,children:[t&&jsxRuntime.jsx("label",{htmlFor:e,children:t}),jsxRuntime.jsx("input",{id:e,type:"number",value:m===""||m==null?"":Number(m),onChange:c,onBlur:T,"aria-invalid":!!n,"aria-describedby":n?`${e}-error`:void 0,...a}),n&&jsxRuntime.jsx("span",{id:`${e}-error`,role:"alert",children:n.message})]})}function re({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();react.useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=m=>{r.setState(e,m.target.checked);},T=r.errors[e],n=!!r.state[e];return jsxRuntime.jsxs("div",{className:u,style:i,children:[jsxRuntime.jsxs("label",{children:[jsxRuntime.jsx("input",{type:"checkbox",checked:n,onChange:c,"aria-invalid":!!T,...a}),t]}),T&&jsxRuntime.jsx("span",{role:"alert",children:T.message})]})}function ne({name:e,label:t,rules:s,options:u,placeholder:i,className:a,style:r}){let c=H();react.useEffect(()=>(c.registerField(e,s),()=>c.unregisterField(e)),[e,s,c.registerField,c.unregisterField]);let T=d=>{c.setState(e,d.target.value);},n=()=>{c.touch(e);},m=c.errors[e],x=String(c.state[e]??"");return jsxRuntime.jsxs("div",{className:a,style:r,children:[t&&jsxRuntime.jsx("label",{htmlFor:e,children:t}),jsxRuntime.jsxs("select",{id:e,value:x,onChange:T,onBlur:n,"aria-invalid":!!m,"aria-describedby":m?`${e}-error`:void 0,children:[i&&jsxRuntime.jsx("option",{value:"",disabled:true,children:i}),u.map(d=>jsxRuntime.jsx("option",{value:d.value,children:d.label},d.value))]}),m&&jsxRuntime.jsx("span",{id:`${e}-error`,role:"alert",children:m.message})]})}function oe({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();react.useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=x=>{r.setState(e,x.target.value);},T=()=>{r.touch(e);},n=r.errors[e],m=String(r.state[e]??"");return jsxRuntime.jsxs("div",{className:u,style:i,children:[t&&jsxRuntime.jsx("label",{htmlFor:e,children:t}),jsxRuntime.jsx("textarea",{id:e,value:m,onChange:c,onBlur:T,"aria-invalid":!!n,"aria-describedby":n?`${e}-error`:void 0,...a}),n&&jsxRuntime.jsx("span",{id:`${e}-error`,role:"alert",children:n.message})]})}exports.CheckboxField=re;exports.FormRewind=Z;exports.NumberField=te;exports.SelectField=ne;exports.TextField=ee;exports.TextareaField=oe;exports.useFormHistory=z;exports.useFormRewindContext=H;exports.validateAll=J;exports.validateField=B;

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 {createContext,useState,useRef,useCallback,useEffect,useContext}from'react';import {jsx,jsxs}from'react/jsx-runtime';var ue=100,ce=300,ae=500,de=1;function pe(e){return !e||typeof e=="boolean"?null:{key:e.key,debounceMs:e.debounceMs??ae,version:e.version??de}}function K(){return typeof window<"u"&&!!window.localStorage}function me(e,t){try{if(!K())return null;let s=window.localStorage.getItem(e);if(!s)return null;let u=JSON.parse(s);return u.__v!==t?(window.localStorage.removeItem(e),null):u.__s}catch{return null}}function Y(e,t,s){try{if(!K())return;window.localStorage.setItem(e,JSON.stringify({__s:t,__v:s}));}catch{}}function ge(e){try{if(!K())return;window.localStorage.removeItem(e);}catch{}}function z(e,t={}){let{maxHistory:s=ue,debounceMs:u=ce,persist:i,keyboard:a=false,onUndo:r,onRedo:c,onSnapshot:T}=t,n=pe(i),[m,x]=useState(()=>{if(n){let l=me(n.key,n.version);if(l!==null)return l}return e}),d=useRef(m);d.current=m;let y=useRef([]),b=useRef([]),[U,S]=useState([]),[I,L]=useState([]),F=useRef(null),E=useRef(null),o=useRef(null),p=useRef(null),f=useCallback(()=>{b.current=[],L([]);},[]),R=useCallback(l=>{let g=[...y.current,l];g.length>s&&g.splice(0,g.length-s),y.current=g,S(g);},[s]);useEffect(()=>()=>{F.current!==null&&clearTimeout(F.current),p.current!==null&&clearTimeout(p.current);},[]);let M=useCallback(l=>{n&&(p.current!==null&&clearTimeout(p.current),p.current=setTimeout(()=>{Y(n.key,l,n.version),p.current=null;},n.debounceMs));},[n]),_=useCallback(l=>{n&&(p.current!==null&&(clearTimeout(p.current),p.current=null),Y(n.key,l,n.version));},[n]),se=useCallback((l,g)=>{let v=d.current,C=typeof l=="function"?l(v):l;if(!Object.is(v,C)){if(x(C),d.current=C,M(C),u<=0){let q={state:v,timestamp:Date.now(),label:g};R(q),f();return}E.current===null&&(o.current=v),E.current=C,F.current!==null&&clearTimeout(F.current),F.current=setTimeout(()=>{let q={state:o.current,timestamp:Date.now(),label:g};R(q),f(),F.current=null,E.current=null,o.current=null;},u);}},[u,R,M,f]),A=useCallback(()=>{if(F.current!==null&&(clearTimeout(F.current),F.current=null),E.current!==null&&o.current!==null){let C={state:o.current,timestamp:Date.now()};R(C),f(),E.current=null,o.current=null;}if(y.current.length===0)return;let l=y.current[y.current.length-1],g=y.current.slice(0,-1);y.current=g,S(g);let v={state:d.current,timestamp:Date.now()};b.current=[...b.current,v],L(b.current),x(l.state),d.current=l.state,_(l.state),r?.(l.state);},[R,r,_,f]),$=useCallback(()=>{if(b.current.length===0)return;let l=b.current[b.current.length-1],g=b.current.slice(0,-1);b.current=g,L(g);let v={state:d.current,timestamp:Date.now()};y.current=[...y.current,v],S(y.current),x(l.state),d.current=l.state,_(l.state),c?.(l.state);},[c,_]);useEffect(()=>{if(!a)return;let l=g=>{!(g.metaKey||g.ctrlKey)||g.key!=="z"||(g.preventDefault(),g.shiftKey?$():A());};return window.addEventListener("keydown",l),()=>window.removeEventListener("keydown",l)},[a,A,$]);let V=useCallback(()=>{F.current!==null&&(clearTimeout(F.current),F.current=null),E.current=null,o.current=null,y.current=[],b.current=[],S([]),L([]);},[]),ie=useCallback(l=>{let g=false;if(F.current!==null&&(clearTimeout(F.current),F.current=null),E.current!==null&&o.current!==null){let v={state:o.current,timestamp:Date.now()};R(v),f(),E.current=null,o.current=null,g=true;}if(g)l&&y.current.length>0&&(y.current[y.current.length-1].label=l,S([...y.current]));else {let v={state:d.current,timestamp:Date.now(),label:l};R(v),f(),T?.(v);}},[R,T,f]),le=useCallback(()=>{V(),n&&ge(n.key),x(e),d.current=e;},[V,e,n]);return {state:m,setState:se,undo:A,redo:$,canUndo:U.length>0,canRedo:I.length>0,clearHistory:V,clearDraft:le,snapshot:ie,past:U,future:I}}function N(e,t){return e&&typeof e=="object"&&"value"in e?e:{value:e,message:t}}function B(e,t){let u=typeof e=="number"?e:Number(e);if(t.required&&(typeof e=="string"?e.trim()==="":e==null||e===false))return {message:typeof t.required=="string"?t.required:"Required",type:"required"};if(t.pattern!=null){let{value:i,message:a}=N(t.pattern,"Invalid format");if(typeof e=="string"&&!i.test(e))return {message:a,type:"pattern"}}if(t.minLength!=null&&typeof e=="string"){let{value:i,message:a}=N(t.minLength,`Min ${t.minLength} characters`);if(e.length<i)return {message:a,type:"minLength"}}if(t.maxLength!=null&&typeof e=="string"){let{value:i,message:a}=N(t.maxLength,`Max ${t.maxLength} characters`);if(e.length>i)return {message:a,type:"maxLength"}}if(t.min!=null&&!isNaN(u)){let{value:i,message:a}=N(t.min,`Min ${t.min}`);if(u<i)return {message:a,type:"min"}}if(t.max!=null&&!isNaN(u)){let{value:i,message:a}=N(t.max,`Max ${t.max}`);if(u>i)return {message:a,type:"max"}}if(t.validate){let i=t.validate(e);if(i)return {message:i,type:"validate"}}return null}function J(e,t){let s={};for(let u in t){let i=B(e[u],t[u]);i&&(s[u]=i);}return s}var W=createContext(null);function H(){let e=useContext(W);if(!e)throw new Error("useFormRewindContext must be used within <FormRewind>");return e}function Z({initialState:e,children:t,onSubmit:s,maxHistory:u,debounceMs:i,persist:a,keyboard:r}){let c=z(e,{maxHistory:u,debounceMs:i,persist:a,keyboard:r}),[T,n]=useState({}),[m,x]=useState({}),d=useRef({}),y=useCallback((o,p)=>{d.current[o]=p??{};},[]),b=useCallback(o=>{delete d.current[o];},[]),U=useCallback((o,p)=>{n(f=>({...f,[o]:p}));},[]),S=useCallback(o=>{n(p=>{let f={...p};return delete f[o],f});},[]),I=useCallback(o=>{x(p=>({...p,[o]:true}));},[]),L=useCallback((o,p)=>{if(c.setState(f=>({...f,[o]:p}),o),m[o]&&d.current[o]){let f=B(p,d.current[o]);n(f?R=>({...R,[o]:f}):R=>{let M={...R};return delete M[o],M});}},[c.setState,m]),F=useCallback(o=>{o&&o.preventDefault();let p={};for(let R in d.current)p[R]=true;x(p);let f=J(c.state,d.current);return n(f),Object.keys(f).length===0&&s&&s(c.state),Object.keys(f).length===0},[c.state,s]),E={state:c.state,setState:L,errors:T,setError:U,clearError:S,touched:m,touch:I,fields:Object.fromEntries(Object.entries(d.current).map(([o,p])=>[o,{name:o,rules:p,touched:!!m[o]}])),registerField:y,unregisterField:b};return jsx(W.Provider,{value:E,children:jsx("form",{onSubmit:F,noValidate:true,children:t})})}function ee({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=x=>{r.setState(e,x.target.value);},T=()=>{r.touch(e);},n=r.errors[e],m=String(r.state[e]??"");return jsxs("div",{className:u,style:i,children:[t&&jsx("label",{htmlFor:e,children:t}),jsx("input",{id:e,type:"text",value:m,onChange:c,onBlur:T,"aria-invalid":!!n,"aria-describedby":n?`${e}-error`:void 0,...a}),n&&jsx("span",{id:`${e}-error`,role:"alert",children:n.message})]})}function te({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=x=>{let d=x.target.value===""?"":Number(x.target.value);r.setState(e,d);},T=()=>{r.touch(e);},n=r.errors[e],m=r.state[e];return jsxs("div",{className:u,style:i,children:[t&&jsx("label",{htmlFor:e,children:t}),jsx("input",{id:e,type:"number",value:m===""||m==null?"":Number(m),onChange:c,onBlur:T,"aria-invalid":!!n,"aria-describedby":n?`${e}-error`:void 0,...a}),n&&jsx("span",{id:`${e}-error`,role:"alert",children:n.message})]})}function re({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=m=>{r.setState(e,m.target.checked);},T=r.errors[e],n=!!r.state[e];return jsxs("div",{className:u,style:i,children:[jsxs("label",{children:[jsx("input",{type:"checkbox",checked:n,onChange:c,"aria-invalid":!!T,...a}),t]}),T&&jsx("span",{role:"alert",children:T.message})]})}function ne({name:e,label:t,rules:s,options:u,placeholder:i,className:a,style:r}){let c=H();useEffect(()=>(c.registerField(e,s),()=>c.unregisterField(e)),[e,s,c.registerField,c.unregisterField]);let T=d=>{c.setState(e,d.target.value);},n=()=>{c.touch(e);},m=c.errors[e],x=String(c.state[e]??"");return jsxs("div",{className:a,style:r,children:[t&&jsx("label",{htmlFor:e,children:t}),jsxs("select",{id:e,value:x,onChange:T,onBlur:n,"aria-invalid":!!m,"aria-describedby":m?`${e}-error`:void 0,children:[i&&jsx("option",{value:"",disabled:true,children:i}),u.map(d=>jsx("option",{value:d.value,children:d.label},d.value))]}),m&&jsx("span",{id:`${e}-error`,role:"alert",children:m.message})]})}function oe({name:e,label:t,rules:s,className:u,style:i,...a}){let r=H();useEffect(()=>(r.registerField(e,s),()=>r.unregisterField(e)),[e,s,r.registerField,r.unregisterField]);let c=x=>{r.setState(e,x.target.value);},T=()=>{r.touch(e);},n=r.errors[e],m=String(r.state[e]??"");return jsxs("div",{className:u,style:i,children:[t&&jsx("label",{htmlFor:e,children:t}),jsx("textarea",{id:e,value:m,onChange:c,onBlur:T,"aria-invalid":!!n,"aria-describedby":n?`${e}-error`:void 0,...a}),n&&jsx("span",{id:`${e}-error`,role:"alert",children:n.message})]})}export{re as CheckboxField,Z as FormRewind,te as NumberField,ne as SelectField,ee as TextField,oe as TextareaField,z as useFormHistory,H as useFormRewindContext,J as validateAll,B as validateField};

package/package.json

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