react-form-rewind 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -35,4 +35,6 @@ interface UseFormHistoryReturn<T> {
     future: HistoryEntry<T>[];
 }
 
-export type { HistoryEntry, HistoryStack, PersistOptions, UseFormHistoryOptions, UseFormHistoryReturn };
+declare function useFormHistory<T>(initialState: T, options?: UseFormHistoryOptions<T>): UseFormHistoryReturn<T>;
+
+export { type HistoryEntry, type HistoryStack, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };

package/dist/index.d.ts

@@ -35,4 +35,6 @@ interface UseFormHistoryReturn<T> {
     future: HistoryEntry<T>[];
 }
 
-export type { HistoryEntry, HistoryStack, PersistOptions, UseFormHistoryOptions, UseFormHistoryReturn };
+declare function useFormHistory<T>(initialState: T, options?: UseFormHistoryOptions<T>): UseFormHistoryReturn<T>;
+
+export { type HistoryEntry, type HistoryStack, type PersistOptions, type UseFormHistoryOptions, type UseFormHistoryReturn, useFormHistory };

package/dist/index.js

@@ -1,4 +1,115 @@
 'use strict';
 
+var react = require('react');
+
+// src/useFormHistory.ts
+var DEFAULT_MAX_HISTORY = 100;
+function useFormHistory(initialState, options = {}) {
+  const { maxHistory = DEFAULT_MAX_HISTORY, onUndo, onRedo, onSnapshot } = options;
+  const pastRef = react.useRef([]);
+  const futureRef = react.useRef([]);
+  const [state, setStateRaw] = react.useState(initialState);
+  const stateRef = react.useRef(initialState);
+  stateRef.current = state;
+  const [past, setPast] = react.useState([]);
+  const [future, setFuture] = react.useState([]);
+  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]
+  );
+  const setState = react.useCallback(
+    (value, label) => {
+      const prev = stateRef.current;
+      const next = typeof value === "function" ? value(prev) : value;
+      if (Object.is(prev, next)) return;
+      const entry = { state: prev, timestamp: Date.now(), label };
+      pushToPast(entry);
+      futureRef.current = [];
+      setFuture([]);
+      setStateRaw(next);
+      stateRef.current = next;
+    },
+    [pushToPast]
+  );
+  const undo = react.useCallback(() => {
+    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;
+    onUndo?.(prev.state);
+  }, [onUndo]);
+  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;
+    onRedo?.(next.state);
+  }, [onRedo]);
+  const clearHistory = react.useCallback(() => {
+    pastRef.current = [];
+    futureRef.current = [];
+    setPast([]);
+    setFuture([]);
+  }, []);
+  const snapshot = react.useCallback(
+    (label) => {
+      const entry = {
+        state: stateRef.current,
+        timestamp: Date.now(),
+        label
+      };
+      pushToPast(entry);
+      futureRef.current = [];
+      setFuture([]);
+      onSnapshot?.(entry);
+    },
+    [pushToPast, onSnapshot]
+  );
+  const clearDraft = react.useCallback(() => {
+    clearHistory();
+    setStateRaw(initialState);
+    stateRef.current = initialState;
+  }, [clearHistory, initialState]);
+  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

package/dist/index.js.map

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

package/dist/index.mjs

@@ -1,3 +1,113 @@
+import { useRef, useState, useCallback } from 'react';
 
+// src/useFormHistory.ts
+var DEFAULT_MAX_HISTORY = 100;
+function useFormHistory(initialState, options = {}) {
+  const { maxHistory = DEFAULT_MAX_HISTORY, onUndo, onRedo, onSnapshot } = options;
+  const pastRef = useRef([]);
+  const futureRef = useRef([]);
+  const [state, setStateRaw] = useState(initialState);
+  const stateRef = useRef(initialState);
+  stateRef.current = state;
+  const [past, setPast] = useState([]);
+  const [future, setFuture] = useState([]);
+  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]
+  );
+  const setState = useCallback(
+    (value, label) => {
+      const prev = stateRef.current;
+      const next = typeof value === "function" ? value(prev) : value;
+      if (Object.is(prev, next)) return;
+      const entry = { state: prev, timestamp: Date.now(), label };
+      pushToPast(entry);
+      futureRef.current = [];
+      setFuture([]);
+      setStateRaw(next);
+      stateRef.current = next;
+    },
+    [pushToPast]
+  );
+  const undo = useCallback(() => {
+    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;
+    onUndo?.(prev.state);
+  }, [onUndo]);
+  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;
+    onRedo?.(next.state);
+  }, [onRedo]);
+  const clearHistory = useCallback(() => {
+    pastRef.current = [];
+    futureRef.current = [];
+    setPast([]);
+    setFuture([]);
+  }, []);
+  const snapshot = useCallback(
+    (label) => {
+      const entry = {
+        state: stateRef.current,
+        timestamp: Date.now(),
+        label
+      };
+      pushToPast(entry);
+      futureRef.current = [];
+      setFuture([]);
+      onSnapshot?.(entry);
+    },
+    [pushToPast, onSnapshot]
+  );
+  const clearDraft = useCallback(() => {
+    clearHistory();
+    setStateRaw(initialState);
+    stateRef.current = initialState;
+  }, [clearHistory, initialState]);
+  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

package/dist/index.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-rewind",
-  "version": "0.1.0",
+  "version": "0.2.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",
@@ -25,6 +25,8 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
@@ -32,11 +34,15 @@
     "react": ">=18.0.0"
   },
   "devDependencies": {
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
     "@types/react": "^18.2.0",
+    "jsdom": "^30.0.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^5.0.0"
   },
   "keywords": [
     "react",