@patch-kit/history 1.0.0 → 1.0.2

package/README.md

@@ -2,12 +2,16 @@
 
 A self-contained undo/redo system for using the Command Pattern.
 
+**Interactive demo:** [Default](https://xkeexe.github.io/patchkit/?path=/story/history--default)
+
 ---
 
 ## Overview
 
 Each user action is recorded as a command with `undo()` and `redo()` functions, enabling full history traversal. The factory pattern ensures each history instance is independently scoped and fully typed.
 
+Example usage
+
 ---
 
 ## Setup

package/dist/index.js

@@ -19,7 +19,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// index.tsx
+// src/index.tsx
 var index_exports = {};
 __export(index_exports, {
   createHistory: () => createHistory

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.tsx"],"sourcesContent":["\"use client\";\n\nimport React, {\n  createContext,\n  useContext,\n  useReducer,\n  useCallback,\n  useMemo,\n} from \"react\";\nimport { Command } from \"./types\";\n\ninterface HistoryContextType<T> {\n  addHistory: (command: Command<T>, immediate?: boolean) => void;\n  undo: () => void;\n  redo: () => void;\n  canUndo: boolean;\n  canRedo: boolean;\n  resetHistory: () => void;\n}\n\n// State and action types for the reducer\ninterface HistoryState {\n  commands: Command<any>[];\n  step: number;\n}\n\ntype HistoryAction =\n  | { type: \"ADD\"; command: Command<any>; limit: number }\n  | { type: \"UNDO\" }\n  | { type: \"REDO\" }\n  | { type: \"RESET\" };\n\nconst initialState: HistoryState = {\n  commands: [],\n  step: 0,\n};\n\n/**\n * Pure reducer function that handles all history state transitions atomically.\n * Side effects (undo/redo) are handled outside the reducer to avoid\n * state updates during render.\n */\nfunction historyReducer(state: HistoryState, action: HistoryAction): HistoryState {\n  switch (action.type) {\n    case \"ADD\": {\n      try {\n        const newHistory = state.commands.slice(0, state.step);\n        newHistory.push(action.command);\n\n        if (newHistory.length > action.limit) {\n          newHistory.shift();\n        }\n\n        return { commands: newHistory, step: newHistory.length };\n      } catch (error) {\n        console.error(`Failed to add command ${action.command.name}: ${error}`);\n        return state;\n      }\n    }\n    case \"UNDO\": {\n      if (state.step <= 0) return state;\n      return { ...state, step: state.step - 1 };\n    }\n    case \"REDO\": {\n      if (state.step >= state.commands.length) return state;\n      return { ...state, step: state.step + 1 };\n    }\n    case \"RESET\":\n      return initialState;\n    default:\n      return state;\n  }\n}\n\ninterface HistoryProviderProps<T> {\n  children: React.ReactNode;\n  limit?: number;\n  onUndo?: (value: T) => void;\n  onRedo?: (value: T) => void;\n}\n\n/**\n * Manages a history of commands to provide undo and redo functionality.\n *\n * Implements the Command design pattern's history tracking. It stores\n * a list of executed commands in a buffer with a limit.\n * When a new command is added after an `undo` operation, any existing `redo`\n * history is cleared. If the history limit is exceeded, the oldest command is\n * discarded.\n */\nexport function createHistory<T = any>() {\n  const Context = createContext<HistoryContextType<T> | null>(null);\n\n  function HistoryProvider({\n    children,\n    limit = 64,\n    onUndo,\n    onRedo,\n  }: HistoryProviderProps<T>) {\n    const [state, dispatch] = useReducer(historyReducer, initialState);\n\n    const canUndo = state.step > 0;\n    const canRedo = state.step < state.commands.length;\n\n    const addHistory = useCallback(\n      (command: Command<T>, immediate = false) => {\n        if (immediate) command.redo();\n        dispatch({ type: \"ADD\", command, limit });\n      },\n      [limit]\n    );\n\n    const undo = useCallback(() => {\n      const { commands, step } = state;\n      if (step <= 0) return;\n\n      const command = commands[step - 1];\n      const value = command.undo();\n      onUndo?.(value as T);\n      dispatch({ type: \"UNDO\" });\n    }, [state, onUndo]);\n\n    const redo = useCallback(() => {\n      const { commands, step } = state;\n      if (step >= commands.length) return;\n\n      const command = commands[step];\n      const value = command.redo();\n      onRedo?.(value as T);\n      dispatch({ type: \"REDO\" });\n    }, [state, onRedo]);\n\n    const resetHistory = useCallback(() => {\n      dispatch({ type: \"RESET\" });\n    }, []);\n\n    const value = useMemo(\n      () => ({\n        addHistory,\n        undo,\n        redo,\n        canUndo,\n        canRedo,\n        resetHistory,\n      }),\n      [addHistory, undo, redo, canUndo, canRedo, resetHistory]\n    );\n\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n  }\n\n  function useHistory() {\n    const context = useContext(Context);\n    if (!context) throw new Error(\"useHistory must be used within a HistoryProvider\");\n    return context;\n  }\n\n  return { HistoryProvider, useHistory };\n}"],"mappings":"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","names":["value"]}
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["\"use client\";\n\nimport React, {\n  createContext,\n  useContext,\n  useReducer,\n  useCallback,\n  useMemo,\n} from \"react\";\nimport { Command } from \"./types\";\n\ninterface HistoryContextType<T> {\n  addHistory: (command: Command<T>, immediate?: boolean) => void;\n  undo: () => void;\n  redo: () => void;\n  canUndo: boolean;\n  canRedo: boolean;\n  resetHistory: () => void;\n}\n\n// State and action types for the reducer\ninterface HistoryState {\n  commands: Command<any>[];\n  step: number;\n}\n\ntype HistoryAction =\n  | { type: \"ADD\"; command: Command<any>; limit: number }\n  | { type: \"UNDO\" }\n  | { type: \"REDO\" }\n  | { type: \"RESET\" };\n\nconst initialState: HistoryState = {\n  commands: [],\n  step: 0,\n};\n\n/**\n * Pure reducer function that handles all history state transitions atomically.\n * Side effects (undo/redo) are handled outside the reducer to avoid\n * state updates during render.\n */\nfunction historyReducer(state: HistoryState, action: HistoryAction): HistoryState {\n  switch (action.type) {\n    case \"ADD\": {\n      try {\n        const newHistory = state.commands.slice(0, state.step);\n        newHistory.push(action.command);\n\n        if (newHistory.length > action.limit) {\n          newHistory.shift();\n        }\n\n        return { commands: newHistory, step: newHistory.length };\n      } catch (error) {\n        console.error(`Failed to add command ${action.command.name}: ${error}`);\n        return state;\n      }\n    }\n    case \"UNDO\": {\n      if (state.step <= 0) return state;\n      return { ...state, step: state.step - 1 };\n    }\n    case \"REDO\": {\n      if (state.step >= state.commands.length) return state;\n      return { ...state, step: state.step + 1 };\n    }\n    case \"RESET\":\n      return initialState;\n    default:\n      return state;\n  }\n}\n\ninterface HistoryProviderProps<T> {\n  children: React.ReactNode;\n  limit?: number;\n  onUndo?: (value: T) => void;\n  onRedo?: (value: T) => void;\n}\n\n/**\n * Manages a history of commands to provide undo and redo functionality.\n *\n * Implements the Command design pattern's history tracking. It stores\n * a list of executed commands in a buffer with a limit.\n * When a new command is added after an `undo` operation, any existing `redo`\n * history is cleared. If the history limit is exceeded, the oldest command is\n * discarded.\n */\nexport function createHistory<T = any>() {\n  const Context = createContext<HistoryContextType<T> | null>(null);\n\n  function HistoryProvider({\n    children,\n    limit = 64,\n    onUndo,\n    onRedo,\n  }: HistoryProviderProps<T>) {\n    const [state, dispatch] = useReducer(historyReducer, initialState);\n\n    const canUndo = state.step > 0;\n    const canRedo = state.step < state.commands.length;\n\n    const addHistory = useCallback(\n      (command: Command<T>, immediate = false) => {\n        if (immediate) command.redo();\n        dispatch({ type: \"ADD\", command, limit });\n      },\n      [limit]\n    );\n\n    const undo = useCallback(() => {\n      const { commands, step } = state;\n      if (step <= 0) return;\n\n      const command = commands[step - 1];\n      const value = command.undo();\n      onUndo?.(value as T);\n      dispatch({ type: \"UNDO\" });\n    }, [state, onUndo]);\n\n    const redo = useCallback(() => {\n      const { commands, step } = state;\n      if (step >= commands.length) return;\n\n      const command = commands[step];\n      const value = command.redo();\n      onRedo?.(value as T);\n      dispatch({ type: \"REDO\" });\n    }, [state, onRedo]);\n\n    const resetHistory = useCallback(() => {\n      dispatch({ type: \"RESET\" });\n    }, []);\n\n    const value = useMemo(\n      () => ({\n        addHistory,\n        undo,\n        redo,\n        canUndo,\n        canRedo,\n        resetHistory,\n      }),\n      [addHistory, undo, redo, canUndo, canRedo, resetHistory]\n    );\n\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n  }\n\n  function useHistory() {\n    const context = useContext(Context);\n    if (!context) throw new Error(\"useHistory must be used within a HistoryProvider\");\n    return context;\n  }\n\n  return { HistoryProvider, useHistory };\n}"],"mappings":"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","names":["value"]}

package/dist/index.mjs

@@ -1,7 +1,7 @@
 "use client";
 "use client";
 
-// index.tsx
+// src/index.tsx
 import {
   createContext,
   useContext,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.tsx"],"sourcesContent":["\"use client\";\n\nimport React, {\n  createContext,\n  useContext,\n  useReducer,\n  useCallback,\n  useMemo,\n} from \"react\";\nimport { Command } from \"./types\";\n\ninterface HistoryContextType<T> {\n  addHistory: (command: Command<T>, immediate?: boolean) => void;\n  undo: () => void;\n  redo: () => void;\n  canUndo: boolean;\n  canRedo: boolean;\n  resetHistory: () => void;\n}\n\n// State and action types for the reducer\ninterface HistoryState {\n  commands: Command<any>[];\n  step: number;\n}\n\ntype HistoryAction =\n  | { type: \"ADD\"; command: Command<any>; limit: number }\n  | { type: \"UNDO\" }\n  | { type: \"REDO\" }\n  | { type: \"RESET\" };\n\nconst initialState: HistoryState = {\n  commands: [],\n  step: 0,\n};\n\n/**\n * Pure reducer function that handles all history state transitions atomically.\n * Side effects (undo/redo) are handled outside the reducer to avoid\n * state updates during render.\n */\nfunction historyReducer(state: HistoryState, action: HistoryAction): HistoryState {\n  switch (action.type) {\n    case \"ADD\": {\n      try {\n        const newHistory = state.commands.slice(0, state.step);\n        newHistory.push(action.command);\n\n        if (newHistory.length > action.limit) {\n          newHistory.shift();\n        }\n\n        return { commands: newHistory, step: newHistory.length };\n      } catch (error) {\n        console.error(`Failed to add command ${action.command.name}: ${error}`);\n        return state;\n      }\n    }\n    case \"UNDO\": {\n      if (state.step <= 0) return state;\n      return { ...state, step: state.step - 1 };\n    }\n    case \"REDO\": {\n      if (state.step >= state.commands.length) return state;\n      return { ...state, step: state.step + 1 };\n    }\n    case \"RESET\":\n      return initialState;\n    default:\n      return state;\n  }\n}\n\ninterface HistoryProviderProps<T> {\n  children: React.ReactNode;\n  limit?: number;\n  onUndo?: (value: T) => void;\n  onRedo?: (value: T) => void;\n}\n\n/**\n * Manages a history of commands to provide undo and redo functionality.\n *\n * Implements the Command design pattern's history tracking. It stores\n * a list of executed commands in a buffer with a limit.\n * When a new command is added after an `undo` operation, any existing `redo`\n * history is cleared. If the history limit is exceeded, the oldest command is\n * discarded.\n */\nexport function createHistory<T = any>() {\n  const Context = createContext<HistoryContextType<T> | null>(null);\n\n  function HistoryProvider({\n    children,\n    limit = 64,\n    onUndo,\n    onRedo,\n  }: HistoryProviderProps<T>) {\n    const [state, dispatch] = useReducer(historyReducer, initialState);\n\n    const canUndo = state.step > 0;\n    const canRedo = state.step < state.commands.length;\n\n    const addHistory = useCallback(\n      (command: Command<T>, immediate = false) => {\n        if (immediate) command.redo();\n        dispatch({ type: \"ADD\", command, limit });\n      },\n      [limit]\n    );\n\n    const undo = useCallback(() => {\n      const { commands, step } = state;\n      if (step <= 0) return;\n\n      const command = commands[step - 1];\n      const value = command.undo();\n      onUndo?.(value as T);\n      dispatch({ type: \"UNDO\" });\n    }, [state, onUndo]);\n\n    const redo = useCallback(() => {\n      const { commands, step } = state;\n      if (step >= commands.length) return;\n\n      const command = commands[step];\n      const value = command.redo();\n      onRedo?.(value as T);\n      dispatch({ type: \"REDO\" });\n    }, [state, onRedo]);\n\n    const resetHistory = useCallback(() => {\n      dispatch({ type: \"RESET\" });\n    }, []);\n\n    const value = useMemo(\n      () => ({\n        addHistory,\n        undo,\n        redo,\n        canUndo,\n        canRedo,\n        resetHistory,\n      }),\n      [addHistory, undo, redo, canUndo, canRedo, resetHistory]\n    );\n\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n  }\n\n  function useHistory() {\n    const context = useContext(Context);\n    if (!context) throw new Error(\"useHistory must be used within a HistoryProvider\");\n    return context;\n  }\n\n  return { HistoryProvider, useHistory };\n}"],"mappings":"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","names":["value"]}
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["\"use client\";\n\nimport React, {\n  createContext,\n  useContext,\n  useReducer,\n  useCallback,\n  useMemo,\n} from \"react\";\nimport { Command } from \"./types\";\n\ninterface HistoryContextType<T> {\n  addHistory: (command: Command<T>, immediate?: boolean) => void;\n  undo: () => void;\n  redo: () => void;\n  canUndo: boolean;\n  canRedo: boolean;\n  resetHistory: () => void;\n}\n\n// State and action types for the reducer\ninterface HistoryState {\n  commands: Command<any>[];\n  step: number;\n}\n\ntype HistoryAction =\n  | { type: \"ADD\"; command: Command<any>; limit: number }\n  | { type: \"UNDO\" }\n  | { type: \"REDO\" }\n  | { type: \"RESET\" };\n\nconst initialState: HistoryState = {\n  commands: [],\n  step: 0,\n};\n\n/**\n * Pure reducer function that handles all history state transitions atomically.\n * Side effects (undo/redo) are handled outside the reducer to avoid\n * state updates during render.\n */\nfunction historyReducer(state: HistoryState, action: HistoryAction): HistoryState {\n  switch (action.type) {\n    case \"ADD\": {\n      try {\n        const newHistory = state.commands.slice(0, state.step);\n        newHistory.push(action.command);\n\n        if (newHistory.length > action.limit) {\n          newHistory.shift();\n        }\n\n        return { commands: newHistory, step: newHistory.length };\n      } catch (error) {\n        console.error(`Failed to add command ${action.command.name}: ${error}`);\n        return state;\n      }\n    }\n    case \"UNDO\": {\n      if (state.step <= 0) return state;\n      return { ...state, step: state.step - 1 };\n    }\n    case \"REDO\": {\n      if (state.step >= state.commands.length) return state;\n      return { ...state, step: state.step + 1 };\n    }\n    case \"RESET\":\n      return initialState;\n    default:\n      return state;\n  }\n}\n\ninterface HistoryProviderProps<T> {\n  children: React.ReactNode;\n  limit?: number;\n  onUndo?: (value: T) => void;\n  onRedo?: (value: T) => void;\n}\n\n/**\n * Manages a history of commands to provide undo and redo functionality.\n *\n * Implements the Command design pattern's history tracking. It stores\n * a list of executed commands in a buffer with a limit.\n * When a new command is added after an `undo` operation, any existing `redo`\n * history is cleared. If the history limit is exceeded, the oldest command is\n * discarded.\n */\nexport function createHistory<T = any>() {\n  const Context = createContext<HistoryContextType<T> | null>(null);\n\n  function HistoryProvider({\n    children,\n    limit = 64,\n    onUndo,\n    onRedo,\n  }: HistoryProviderProps<T>) {\n    const [state, dispatch] = useReducer(historyReducer, initialState);\n\n    const canUndo = state.step > 0;\n    const canRedo = state.step < state.commands.length;\n\n    const addHistory = useCallback(\n      (command: Command<T>, immediate = false) => {\n        if (immediate) command.redo();\n        dispatch({ type: \"ADD\", command, limit });\n      },\n      [limit]\n    );\n\n    const undo = useCallback(() => {\n      const { commands, step } = state;\n      if (step <= 0) return;\n\n      const command = commands[step - 1];\n      const value = command.undo();\n      onUndo?.(value as T);\n      dispatch({ type: \"UNDO\" });\n    }, [state, onUndo]);\n\n    const redo = useCallback(() => {\n      const { commands, step } = state;\n      if (step >= commands.length) return;\n\n      const command = commands[step];\n      const value = command.redo();\n      onRedo?.(value as T);\n      dispatch({ type: \"REDO\" });\n    }, [state, onRedo]);\n\n    const resetHistory = useCallback(() => {\n      dispatch({ type: \"RESET\" });\n    }, []);\n\n    const value = useMemo(\n      () => ({\n        addHistory,\n        undo,\n        redo,\n        canUndo,\n        canRedo,\n        resetHistory,\n      }),\n      [addHistory, undo, redo, canUndo, canRedo, resetHistory]\n    );\n\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n  }\n\n  function useHistory() {\n    const context = useContext(Context);\n    if (!context) throw new Error(\"useHistory must be used within a HistoryProvider\");\n    return context;\n  }\n\n  return { HistoryProvider, useHistory };\n}"],"mappings":"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","names":["value"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patch-kit/history",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "History Manager for React",
   "license": "MIT",
   "repository": {
@@ -18,7 +18,12 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",