@msobiecki/react-marauders-path 1.29.0 → 1.30.0

package/dist/use-drag/use-drag.js

@@ -1,42 +1,50 @@
-import { useRef as c, useCallback as l, useEffect as C } from "react";
-import { invokeDragAction as O } from "./invoke-drag-action.js";
-const I = {
-  eventPointerTypes: ["touch", "mouse", "pen"],
+import { useRef as o, useCallback as u, useEffect as M } from "react";
+import { DragEventPointerTypes as E } from "./use-drag.types.js";
+import { invokeDragAction as A } from "./invoke-drag-action.js";
+import { shouldHandleEvent as Y } from "./event-guards.js";
+const F = {
+  eventPointerTypes: [
+    E.Touch,
+    E.Mouse,
+    E.Pen
+  ],
   eventCapture: !1,
   eventOnce: !1,
   eventStopImmediatePropagation: !1,
   threshold: 0,
   container: { current: null },
   raf: !1
-}, U = (f, b = {}) => {
+}, j = (f, C = {}) => {
   const {
     eventPointerTypes: r,
-    eventCapture: o,
+    eventCapture: c,
     eventOnce: p,
     eventStopImmediatePropagation: d,
-    threshold: v,
-    container: y,
-    raf: E
-  } = { ...I, ...b }, a = c(null), i = c(null), s = c(null), Y = c(null), P = c(null), u = c({
+    threshold: g,
+    container: D,
+    raf: L
+  } = { ...F, ...C }, a = o(null), s = o(null), i = o(null), h = o(null), v = o(null), l = o({
     startX: 0,
     startY: 0,
     lastX: 0,
     lastY: 0,
     startTime: 0,
     active: !1
-  }), T = l(() => {
-    s.current = null;
-    const t = Y.current, e = P.current;
-    !t || !e || (O(e, t, f, {
+  }), T = u(() => {
+    i.current = null;
+    const t = h.current, e = v.current;
+    !t || !e || (A(e, t, f, {
       stopImmediate: d,
       once: p,
       onOnce: () => {
-        i.current?.abort();
+        s.current?.abort();
       }
-    }), Y.current = null, P.current = null);
-  }, [f, d, p]), L = l(
+    }), h.current = null, v.current = null);
+  }, [f, d, p]), R = u(
     (t) => {
-      t.isPrimary && r.includes(t.pointerType) && (u.current = {
+      Y(t, {
+        eventPointerTypes: r
+      }) && (l.current = {
         startX: t.clientX,
         startY: t.clientY,
         lastX: t.clientX,
@@ -46,94 +54,105 @@ const I = {
       });
     },
     [r]
-  ), g = l(
+  ), w = u(
     (t) => {
-      const e = u.current;
-      if (!e.active || !t.isPrimary || !r.includes(t.pointerType))
+      if (!Y(t, {
+        eventPointerTypes: r
+      }))
         return;
-      const m = t.clientX - e.startX, X = t.clientY - e.startY, h = t.clientX - e.lastX, n = t.clientY - e.lastY;
-      if (Math.hypot(m, X) < v)
+      const e = l.current;
+      if (!e.active)
         return;
-      const A = Date.now() - e.startTime, w = {
+      const m = t.clientX - e.startX, X = t.clientY - e.startY, P = t.clientX - e.lastX, n = t.clientY - e.lastY;
+      if (Math.hypot(m, X) < g)
+        return;
+      const I = Date.now() - e.startTime, y = {
         deltaX: m,
         deltaY: X,
-        movementX: h,
+        movementX: P,
         movementY: n,
-        duration: A,
+        duration: I,
         startX: e.startX,
         startY: e.startY,
         endX: t.clientX,
         endY: t.clientY
       };
-      if (e.lastX = t.clientX, e.lastY = t.clientY, !E) {
-        O(t, w, f, {
+      if (e.lastX = t.clientX, e.lastY = t.clientY, !L) {
+        A(t, y, f, {
           stopImmediate: d,
           once: p,
           onOnce: () => {
-            i.current?.abort();
+            s.current?.abort();
           }
         });
         return;
       }
-      Y.current = w, P.current = t, s.current === null && (s.current = requestAnimationFrame(T));
+      h.current = y, v.current = t, i.current === null && (i.current = requestAnimationFrame(T));
     },
     [
       r,
-      v,
-      E,
-      f,
       d,
       p,
+      g,
+      L,
+      f,
       T
     ]
-  ), D = l(
+  ), O = u(
+    (t) => {
+      Y(t, {
+        eventPointerTypes: r
+      }) && (l.current.active = !1);
+    },
+    [r]
+  ), b = u(
     (t) => {
-      t.isPrimary && r.includes(t.pointerType) && (u.current.active = !1);
+      Y(t, {
+        eventPointerTypes: r
+      }) && (l.current.active = !1);
     },
     [r]
-  ), R = l(() => {
-    u.current.active = !1;
-  }, []);
-  C(() => {
-    a.current = y?.current ?? globalThis, i.current = new AbortController();
-    const { signal: t } = i.current, e = (n) => n instanceof PointerEvent && L(n), m = (n) => n instanceof PointerEvent && g(n), X = (n) => n instanceof PointerEvent && D(n), h = () => R();
+  );
+  M(() => {
+    a.current = D?.current ?? globalThis, s.current = new AbortController();
+    const { signal: t } = s.current, e = (n) => n instanceof PointerEvent && R(n), m = (n) => n instanceof PointerEvent && w(n), X = (n) => n instanceof PointerEvent && O(n), P = (n) => n instanceof PointerEvent && b(n);
     return a.current.addEventListener(
       "pointerdown",
       e,
       {
-        capture: o,
+        capture: c,
         signal: t
       }
     ), a.current.addEventListener(
       "pointermove",
       m,
       {
-        capture: o,
+        capture: c,
         signal: t
       }
     ), a.current.addEventListener("pointerup", X, {
-      capture: o,
+      capture: c,
       signal: t
     }), a.current.addEventListener(
       "pointercancel",
-      h,
+      P,
       {
-        capture: o,
+        capture: c,
         signal: t
       }
     ), () => {
-      i.current?.abort(), u.current.active = !1, s.current !== null && cancelAnimationFrame(s.current);
+      s.current?.abort(), l.current.active = !1, i.current !== null && cancelAnimationFrame(i.current);
     };
   }, [
-    y,
-    o,
-    L,
-    g,
     D,
-    R
+    c,
+    R,
+    w,
+    O,
+    b
   ]);
 };
 export {
-  U as default
+  j as default
 };
 //# sourceMappingURL=use-drag.js.map

package/dist/use-drag/use-drag.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-drag.js","sources":["../../src/use-drag/use-drag.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\nimport {\n  DragState,\n  DragData,\n  UseDragCallback,\n  UseDragOptions,\n  DragOptions,\n  DragEventPointerType,\n} from \"./use-drag.types\";\nimport { invokeDragAction } from \"./invoke-drag-action\";\n\nconst defaultOptions: DragOptions = {\n  eventPointerTypes: [\"touch\", \"mouse\", \"pen\"],\n  eventCapture: false,\n  eventOnce: false,\n  eventStopImmediatePropagation: false,\n  threshold: 0,\n  container: { current: null },\n  raf: false,\n};\n\nconst useDrag = (\n  dragCallback: UseDragCallback,\n  options: UseDragOptions = {},\n) => {\n  const {\n    eventPointerTypes,\n    eventCapture,\n    eventOnce,\n    eventStopImmediatePropagation,\n    threshold,\n    container,\n    raf,\n  } = { ...defaultOptions, ...options };\n\n  const targetReference = useRef<EventTarget | null>(null);\n  const abortControllerReference = useRef<AbortController | null>(null);\n\n  const frameReference = useRef<number | null>(null);\n  const pendingDataReference = useRef<DragData | null>(null);\n  const pendingEventReference = useRef<PointerEvent | null>(null);\n\n  const dragStateReference = useRef<DragState>({\n    startX: 0,\n    startY: 0,\n    lastX: 0,\n    lastY: 0,\n    startTime: 0,\n    active: false,\n  });\n\n  const flushFrame = useCallback(() => {\n    frameReference.current = null;\n\n    const data = pendingDataReference.current;\n    const event = pendingEventReference.current;\n\n    if (!data || !event) {\n      return;\n    }\n\n    invokeDragAction(event, data, dragCallback, {\n      stopImmediate: eventStopImmediatePropagation,\n      once: eventOnce,\n      onOnce: () => {\n        abortControllerReference.current?.abort();\n      },\n    });\n\n    pendingDataReference.current = null;\n    pendingEventReference.current = null;\n  }, [dragCallback, eventStopImmediatePropagation, eventOnce]);\n\n  const handlePointerDown = useCallback(\n    (event: PointerEvent) => {\n      if (!event.isPrimary) {\n        return;\n      }\n\n      if (\n        !eventPointerTypes.includes(event.pointerType as DragEventPointerType)\n      ) {\n        return;\n      }\n\n      dragStateReference.current = {\n        startX: event.clientX,\n        startY: event.clientY,\n        lastX: event.clientX,\n        lastY: event.clientY,\n        startTime: Date.now(),\n        active: true,\n      };\n    },\n    [eventPointerTypes],\n  );\n\n  const handlePointerMove = useCallback(\n    (event: PointerEvent) => {\n      const state = dragStateReference.current;\n      if (!state.active) {\n        return;\n      }\n      if (!event.isPrimary) {\n        return;\n      }\n\n      if (\n        !eventPointerTypes.includes(event.pointerType as DragEventPointerType)\n      ) {\n        return;\n      }\n\n      const deltaX = event.clientX - state.startX;\n      const deltaY = event.clientY - state.startY;\n\n      const movementX = event.clientX - state.lastX;\n      const movementY = event.clientY - state.lastY;\n\n      const distance = Math.hypot(deltaX, deltaY);\n\n      if (distance < threshold) {\n        return;\n      }\n\n      const duration = Date.now() - state.startTime;\n\n      const data: DragData = {\n        deltaX,\n        deltaY,\n        movementX,\n        movementY,\n        duration,\n        startX: state.startX,\n        startY: state.startY,\n        endX: event.clientX,\n        endY: event.clientY,\n      };\n\n      state.lastX = event.clientX;\n      state.lastY = event.clientY;\n\n      if (!raf) {\n        invokeDragAction(event, data, dragCallback, {\n          stopImmediate: eventStopImmediatePropagation,\n          once: eventOnce,\n          onOnce: () => {\n            abortControllerReference.current?.abort();\n          },\n        });\n        return;\n      }\n\n      pendingDataReference.current = data;\n      pendingEventReference.current = event;\n\n      if (frameReference.current === null) {\n        frameReference.current = requestAnimationFrame(flushFrame);\n      }\n    },\n    [\n      eventPointerTypes,\n      threshold,\n      raf,\n      dragCallback,\n      eventStopImmediatePropagation,\n      eventOnce,\n      flushFrame,\n    ],\n  );\n\n  const handlePointerUp = useCallback(\n    (event: PointerEvent) => {\n      if (!event.isPrimary) {\n        return;\n      }\n\n      if (\n        !eventPointerTypes.includes(event.pointerType as DragEventPointerType)\n      ) {\n        return;\n      }\n\n      dragStateReference.current.active = false;\n    },\n    [eventPointerTypes],\n  );\n\n  const handlePointerCancel = useCallback(() => {\n    dragStateReference.current.active = false;\n  }, []);\n\n  useEffect(() => {\n    targetReference.current = container?.current ?? globalThis;\n    abortControllerReference.current = new AbortController();\n    const { signal } = abortControllerReference.current;\n\n    const pointerDownListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerDown(event);\n\n    const pointerMoveListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerMove(event);\n\n    const pointerUpListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerUp(event);\n\n    const pointerCancelListener = () => handlePointerCancel();\n\n    targetReference.current.addEventListener(\n      \"pointerdown\",\n      pointerDownListener,\n      {\n        capture: eventCapture,\n        signal,\n      },\n    );\n\n    targetReference.current.addEventListener(\n      \"pointermove\",\n      pointerMoveListener,\n      {\n        capture: eventCapture,\n        signal,\n      },\n    );\n\n    targetReference.current.addEventListener(\"pointerup\", pointerUpListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    targetReference.current.addEventListener(\n      \"pointercancel\",\n      pointerCancelListener,\n      {\n        capture: eventCapture,\n        signal,\n      },\n    );\n\n    return () => {\n      abortControllerReference.current?.abort();\n\n      dragStateReference.current.active = false;\n\n      if (frameReference.current !== null) {\n        cancelAnimationFrame(frameReference.current);\n      }\n    };\n  }, [\n    container,\n    eventCapture,\n    handlePointerDown,\n    handlePointerMove,\n    handlePointerUp,\n    handlePointerCancel,\n  ]);\n};\n\nexport default useDrag;\n"],"names":["defaultOptions","useDrag","dragCallback","options","eventPointerTypes","eventCapture","eventOnce","eventStopImmediatePropagation","threshold","container","raf","targetReference","useRef","abortControllerReference","frameReference","pendingDataReference","pendingEventReference","dragStateReference","flushFrame","useCallback","data","event","invokeDragAction","handlePointerDown","handlePointerMove","state","deltaX","deltaY","movementX","movementY","duration","handlePointerUp","handlePointerCancel","useEffect","signal","pointerDownListener","pointerMoveListener","pointerUpListener","pointerCancelListener"],"mappings":"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"}
+{"version":3,"file":"use-drag.js","sources":["../../src/use-drag/use-drag.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\nimport {\n  DragState,\n  DragData,\n  DragOptions,\n  DragEventPointerTypes,\n  UseDragCallback,\n  UseDragOptions,\n} from \"./use-drag.types\";\nimport { invokeDragAction } from \"./invoke-drag-action\";\nimport { shouldHandleEvent } from \"./event-guards\";\n\nconst defaultOptions: DragOptions = {\n  eventPointerTypes: [\n    DragEventPointerTypes.Touch,\n    DragEventPointerTypes.Mouse,\n    DragEventPointerTypes.Pen,\n  ],\n  eventCapture: false,\n  eventOnce: false,\n  eventStopImmediatePropagation: false,\n  threshold: 0,\n  container: { current: null },\n  raf: false,\n};\n\nconst useDrag = (\n  dragCallback: UseDragCallback,\n  options: UseDragOptions = {},\n) => {\n  const {\n    eventPointerTypes,\n    eventCapture,\n    eventOnce,\n    eventStopImmediatePropagation,\n    threshold,\n    container,\n    raf,\n  } = { ...defaultOptions, ...options };\n\n  const targetReference = useRef<EventTarget | null>(null);\n  const abortControllerReference = useRef<AbortController | null>(null);\n\n  const frameReference = useRef<number | null>(null);\n  const pendingDataReference = useRef<DragData | null>(null);\n  const pendingEventReference = useRef<PointerEvent | null>(null);\n\n  const dragStateReference = useRef<DragState>({\n    startX: 0,\n    startY: 0,\n    lastX: 0,\n    lastY: 0,\n    startTime: 0,\n    active: false,\n  });\n\n  const flushFrame = useCallback(() => {\n    frameReference.current = null;\n\n    const data = pendingDataReference.current;\n    const event = pendingEventReference.current;\n\n    if (!data || !event) {\n      return;\n    }\n\n    invokeDragAction(event, data, dragCallback, {\n      stopImmediate: eventStopImmediatePropagation,\n      once: eventOnce,\n      onOnce: () => {\n        abortControllerReference.current?.abort();\n      },\n    });\n\n    pendingDataReference.current = null;\n    pendingEventReference.current = null;\n  }, [dragCallback, eventStopImmediatePropagation, eventOnce]);\n\n  const handlePointerDown = useCallback(\n    (event: PointerEvent) => {\n      if (\n        !shouldHandleEvent(event, {\n          eventPointerTypes,\n        })\n      ) {\n        return;\n      }\n\n      dragStateReference.current = {\n        startX: event.clientX,\n        startY: event.clientY,\n        lastX: event.clientX,\n        lastY: event.clientY,\n        startTime: Date.now(),\n        active: true,\n      };\n    },\n    [eventPointerTypes],\n  );\n\n  const handlePointerMove = useCallback(\n    (event: PointerEvent) => {\n      if (\n        !shouldHandleEvent(event, {\n          eventPointerTypes,\n        })\n      ) {\n        return;\n      }\n\n      const state = dragStateReference.current;\n      if (!state.active) {\n        return;\n      }\n\n      const deltaX = event.clientX - state.startX;\n      const deltaY = event.clientY - state.startY;\n\n      const movementX = event.clientX - state.lastX;\n      const movementY = event.clientY - state.lastY;\n\n      const distance = Math.hypot(deltaX, deltaY);\n\n      if (distance < threshold) {\n        return;\n      }\n\n      const duration = Date.now() - state.startTime;\n\n      const data: DragData = {\n        deltaX,\n        deltaY,\n        movementX,\n        movementY,\n        duration,\n        startX: state.startX,\n        startY: state.startY,\n        endX: event.clientX,\n        endY: event.clientY,\n      };\n\n      state.lastX = event.clientX;\n      state.lastY = event.clientY;\n\n      if (!raf) {\n        invokeDragAction(event, data, dragCallback, {\n          stopImmediate: eventStopImmediatePropagation,\n          once: eventOnce,\n          onOnce: () => {\n            abortControllerReference.current?.abort();\n          },\n        });\n        return;\n      }\n\n      pendingDataReference.current = data;\n      pendingEventReference.current = event;\n\n      if (frameReference.current === null) {\n        frameReference.current = requestAnimationFrame(flushFrame);\n      }\n    },\n    [\n      eventPointerTypes,\n      eventStopImmediatePropagation,\n      eventOnce,\n      threshold,\n      raf,\n      dragCallback,\n      flushFrame,\n    ],\n  );\n\n  const handlePointerUp = useCallback(\n    (event: PointerEvent) => {\n      if (\n        !shouldHandleEvent(event, {\n          eventPointerTypes,\n        })\n      ) {\n        return;\n      }\n\n      dragStateReference.current.active = false;\n    },\n    [eventPointerTypes],\n  );\n\n  const handlePointerCancel = useCallback(\n    (event: PointerEvent) => {\n      if (\n        !shouldHandleEvent(event, {\n          eventPointerTypes,\n        })\n      ) {\n        return;\n      }\n\n      dragStateReference.current.active = false;\n    },\n    [eventPointerTypes],\n  );\n\n  useEffect(() => {\n    targetReference.current = container?.current ?? globalThis;\n    abortControllerReference.current = new AbortController();\n    const { signal } = abortControllerReference.current;\n\n    const pointerDownListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerDown(event);\n\n    const pointerMoveListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerMove(event);\n\n    const pointerUpListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerUp(event);\n\n    const pointerCancelListener = (event: Event) =>\n      event instanceof PointerEvent && handlePointerCancel(event);\n\n    targetReference.current.addEventListener(\n      \"pointerdown\",\n      pointerDownListener,\n      {\n        capture: eventCapture,\n        signal,\n      },\n    );\n\n    targetReference.current.addEventListener(\n      \"pointermove\",\n      pointerMoveListener,\n      {\n        capture: eventCapture,\n        signal,\n      },\n    );\n\n    targetReference.current.addEventListener(\"pointerup\", pointerUpListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    targetReference.current.addEventListener(\n      \"pointercancel\",\n      pointerCancelListener,\n      {\n        capture: eventCapture,\n        signal,\n      },\n    );\n\n    return () => {\n      abortControllerReference.current?.abort();\n\n      dragStateReference.current.active = false;\n\n      if (frameReference.current !== null) {\n        cancelAnimationFrame(frameReference.current);\n      }\n    };\n  }, [\n    container,\n    eventCapture,\n    handlePointerDown,\n    handlePointerMove,\n    handlePointerUp,\n    handlePointerCancel,\n  ]);\n};\n\nexport default useDrag;\n"],"names":["defaultOptions","DragEventPointerTypes","useDrag","dragCallback","options","eventPointerTypes","eventCapture","eventOnce","eventStopImmediatePropagation","threshold","container","raf","targetReference","useRef","abortControllerReference","frameReference","pendingDataReference","pendingEventReference","dragStateReference","flushFrame","useCallback","data","event","invokeDragAction","handlePointerDown","shouldHandleEvent","handlePointerMove","state","deltaX","deltaY","movementX","movementY","duration","handlePointerUp","handlePointerCancel","useEffect","signal","pointerDownListener","pointerMoveListener","pointerUpListener","pointerCancelListener"],"mappings":"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"}

package/dist/use-drag/use-drag.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-drag.types.js","sources":["../../src/use-drag/use-drag.types.ts"],"sourcesContent":["export interface DragState {\n  startX: number;\n  startY: number;\n  lastX: number;\n  lastY: number;\n  startTime: number;\n  active: boolean;\n}\n\nexport const DragEventPointerTypes = {\n  Touch: \"touch\",\n  Mouse: \"mouse\",\n  Pen: \"pen\",\n} as const;\n\nexport type DragEventPointerType =\n  (typeof DragEventPointerTypes)[keyof typeof DragEventPointerTypes];\n\nexport interface DragData {\n  deltaX: number;\n  deltaY: number;\n  movementX: number;\n  movementY: number;\n  duration: number;\n  startX: number;\n  startY: number;\n  endX: number;\n  endY: number;\n}\n\nexport interface DragOptions {\n  eventPointerTypes: DragEventPointerType[];\n  eventCapture: boolean;\n  eventOnce: boolean;\n  eventStopImmediatePropagation: boolean;\n  threshold: number;\n  container: { current: HTMLElement | null };\n  raf: boolean;\n}\n\nexport type UseDragCallback =\n  | ((event: PointerEvent, data: DragData) => boolean)\n  | ((event: PointerEvent, data: DragData) => void);\n\nexport type UseDragOptions = Partial<DragOptions>;\n"],"names":["DragEventPointerTypes"],"mappings":"AASO,MAAMA,IAAwB;AAAA,EACnC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,KAAK;AACP;"}
+{"version":3,"file":"use-drag.types.js","sources":["../../src/use-drag/use-drag.types.ts"],"sourcesContent":["export interface DragState {\n  startX: number;\n  startY: number;\n  lastX: number;\n  lastY: number;\n  startTime: number;\n  active: boolean;\n}\n\nexport const DragEventPointerTypes = {\n  Touch: \"touch\",\n  Mouse: \"mouse\",\n  Pen: \"pen\",\n} as const;\n\nexport type DragEventPointerType =\n  (typeof DragEventPointerTypes)[keyof typeof DragEventPointerTypes];\n\nexport interface DragData {\n  deltaX: number;\n  deltaY: number;\n  movementX: number;\n  movementY: number;\n  duration: number;\n  startX: number;\n  startY: number;\n  endX: number;\n  endY: number;\n}\n\nexport interface DragOptions {\n  eventPointerTypes: DragEventPointerType[];\n  eventCapture: boolean;\n  eventOnce: boolean;\n  eventStopImmediatePropagation: boolean;\n  threshold: number;\n  container: { current: EventTarget | null };\n  raf: boolean;\n}\n\nexport type UseDragCallback =\n  | ((event: PointerEvent, data: DragData) => boolean)\n  | ((event: PointerEvent, data: DragData) => void);\n\nexport type UseDragOptions = Partial<DragOptions>;\n"],"names":["DragEventPointerTypes"],"mappings":"AASO,MAAMA,IAAwB;AAAA,EACnC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,KAAK;AACP;"}

package/dist/use-key/event-guards.js

@@ -1,5 +1,5 @@
 const t = (e, r) => !(!r.repeat && e.repeat);
 export {
-  t as shouldHandleKeyboardEvent
+  t as shouldHandleEvent
 };
 //# sourceMappingURL=event-guards.js.map

package/dist/use-key/event-guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-guards.js","sources":["../../src/use-key/event-guards.ts"],"sourcesContent":["/**\n * Determines whether a keyboard event should be handled based on event options.\n *\n * @param {KeyboardEvent} event - The keyboard event to evaluate\n * @param {Object} options - Event handling options\n * @param {boolean} options.repeat - If true, repeated key presses are allowed\n * @returns {boolean} True if the event should be handled, false otherwise\n *\n * @example\n * const shouldHandle = shouldHandleKeyboardEvent(event, {\n *   repeat: false\n * });\n */\nexport const shouldHandleKeyboardEvent = (\n  event: KeyboardEvent,\n  options: {\n    repeat: boolean;\n  },\n) => {\n  if (!options.repeat && event.repeat) {\n    return false;\n  }\n  return true;\n};\n"],"names":["shouldHandleKeyboardEvent","event","options"],"mappings":"AAaO,MAAMA,IAA4B,CACvCC,GACAC,MAII,GAACA,EAAQ,UAAUD,EAAM;"}
+{"version":3,"file":"event-guards.js","sources":["../../src/use-key/event-guards.ts"],"sourcesContent":["/**\n * Determines whether a keyboard event should be handled based on event options.\n *\n * @param {KeyboardEvent} event - The keyboard event to evaluate\n * @param {Object} options - Event handling options\n * @param {boolean} options.repeat - If true, repeated key presses are allowed\n * @returns {boolean} True if the event should be handled, false otherwise\n *\n * @example\n * const shouldHandle = shouldHandleEvent(event, {\n *   repeat: false\n * });\n */\nexport const shouldHandleEvent = (\n  event: KeyboardEvent,\n  options: {\n    repeat: boolean;\n  },\n) => {\n  if (!options.repeat && event.repeat) {\n    return false;\n  }\n  return true;\n};\n"],"names":["shouldHandleEvent","event","options"],"mappings":"AAaO,MAAMA,IAAoB,CAC/BC,GACAC,MAII,GAACA,EAAQ,UAAUD,EAAM;"}

package/dist/use-key/use-key.js

@@ -1,11 +1,11 @@
-import { useRef as g, useCallback as c, useEffect as U } from "react";
+import { useRef as g, useCallback as c, useEffect as N } from "react";
 import { KeyEventTypes as w } from "./use-key.types.js";
-import { parseKeySequences as B } from "./parse-key-sequences.js";
-import { resetSequenceState as F, advanceSequenceState as H } from "./sequence-state.js";
+import { parseKeySequences as j } from "./parse-key-sequences.js";
+import { resetSequenceState as B, advanceSequenceState as U } from "./sequence-state.js";
 import { invokeKeyAction as b } from "./invoke-key-action.js";
-import { shouldHandleKeyboardEvent as G } from "./event-guards.js";
+import { shouldHandleEvent as F } from "./event-guards.js";
 import { SPECIAL_KEYS as u } from "./normalize-key.js";
-const _ = {
+const H = {
   eventType: w.KeyUp,
   eventRepeat: !1,
   eventCapture: !1,
@@ -14,69 +14,64 @@ const _ = {
   sequenceThreshold: 1e3,
   combinationThreshold: 200,
   container: { current: null }
-}, te = (x, f, j = _) => {
+}, ee = (P, f, _ = H) => {
   const {
     eventType: d,
     eventRepeat: R,
     eventCapture: v,
     eventOnce: m,
     eventStopImmediatePropagation: p,
-    sequenceThreshold: P,
+    sequenceThreshold: T,
     combinationThreshold: A,
     container: C
-  } = { ..._, ...j }, K = g(null), l = g(null), y = g({
+  } = { ...H, ..._ }, S = g(null), l = g(null), y = g({
     activeKeys: /* @__PURE__ */ new Map()
   }), a = g([]), L = c(() => {
     y.current.activeKeys.clear();
   }, []), i = c((e) => {
-    a.current = F(
+    a.current = B(
       e,
       a.current
     );
-  }, []), D = c(
-    (e) => G(e, {
-      repeat: R
-    }),
-    [R]
-  ), I = c((e) => {
+  }, []), D = c((e) => {
     const t = e.key === " " ? u.SPACE : e.key;
     y.current.activeKeys.set(t, {
       pressedAt: Date.now()
     });
-  }, []), O = c((e) => {
+  }, []), I = c((e) => {
     const t = e.key === " " ? u.SPACE : e.key, r = y.current.activeKeys.get(t);
     r && (r.releasedAt = Date.now());
-  }, []), z = c(() => {
+  }, []), O = c(() => {
     const e = Date.now(), t = y.current;
     [...t.activeKeys.entries()].forEach(([r, s]) => {
       d === w.KeyDown ? s.releasedAt && t.activeKeys.delete(r) : s.releasedAt && e - s.releasedAt > A && t.activeKeys.delete(r);
     });
-  }, [d, A]), S = c(
+  }, [d, A]), K = c(
     (e, t) => {
       if (d === w.KeyDown)
         return t.size === e.length && e.every((r) => r === u.ANY ? t.size > 0 : t.has(r));
       if (d === w.KeyUp) {
         const r = e.map((o) => {
           if (o === u.ANY) {
-            const N = [...t.entries()].at(-1);
-            return N ? N[1] : void 0;
+            const M = [...t.entries()].at(-1);
+            return M ? M[1] : void 0;
           }
           return t.get(o);
         });
         if (r.some((o) => !o?.releasedAt))
           return !1;
-        const s = r.map((o) => o?.pressedAt).filter((o) => o !== void 0), n = r.map((o) => o?.releasedAt).filter((o) => o !== void 0), E = Math.min(...n), T = Math.max(...n);
-        return !(Math.max(...s) > E || T - E > A);
+        const s = r.map((o) => o?.pressedAt).filter((o) => o !== void 0), n = r.map((o) => o?.releasedAt).filter((o) => o !== void 0), E = Math.min(...n), x = Math.max(...n);
+        return !(Math.max(...s) > E || x - E > A);
       }
       return !1;
     },
     [d, A]
-  ), k = c(
+  ), z = c(
     (e, t) => {
       const r = t.chord[0];
       if (Array.isArray(r)) {
         const { activeKeys: n } = y.current;
-        if (!S(r, n))
+        if (!K(r, n))
           return;
         b(e, t.key, f, {
           stopImmediate: p,
@@ -100,19 +95,19 @@ const _ = {
       p,
       m,
       f,
-      S
+      K
     ]
-  ), q = c(
+  ), k = c(
     (e, t) => {
       const r = t.chord[t.index];
       if (Array.isArray(r)) {
-        const { activeKeys: T } = y.current;
-        if (!S(r, T))
+        const { activeKeys: x } = y.current;
+        if (!K(r, x))
           return;
-        const [h, o] = H(
+        const [h, o] = U(
           t,
           a.current,
-          P,
+          T,
           i
         );
         a.current = o, h.index === h.chord.length && (b(e, h.key, f, {
@@ -129,10 +124,10 @@ const _ = {
         i(t);
         return;
       }
-      const [n, E] = H(
+      const [n, E] = U(
         t,
         a.current,
-        P,
+        T,
         i
       );
       a.current = E, n.index === n.chord.length && (b(e, n.key, f, {
@@ -146,36 +141,38 @@ const _ = {
     [
       m,
       p,
-      P,
+      T,
       f,
       i,
-      S
+      K
     ]
-  ), Y = c(
+  ), q = c(
     (e) => {
       a.current.forEach((t) => {
-        t.chord.length === 1 ? k(e, t) : q(e, t);
+        t.chord.length === 1 ? z(e, t) : k(e, t);
       });
     },
-    [k, q]
-  ), M = c(
+    [z, k]
+  ), Y = c(
     (e) => {
-      D(e) && (z(), Y(e));
+      F(e, {
+        repeat: R
+      }) && (O(), q(e));
     },
-    [D, z, Y]
+    [O, q, R]
   );
-  U(() => {
-    a.current = B(x);
-  }, [x]), U(() => {
-    K.current = C?.current ?? globalThis, l.current = new AbortController();
-    const { signal: e } = l.current, t = (n) => I(n), r = (n) => O(n), s = (n) => M(n);
-    return K.current.addEventListener("keydown", t, {
+  N(() => {
+    a.current = j(P);
+  }, [P]), N(() => {
+    S.current = C?.current ?? globalThis, l.current = new AbortController();
+    const { signal: e } = l.current, t = (n) => D(n), r = (n) => I(n), s = (n) => Y(n);
+    return S.current.addEventListener("keydown", t, {
       capture: v,
       signal: e
-    }), K.current.addEventListener("keyup", r, {
+    }), S.current.addEventListener("keyup", r, {
       capture: v,
       signal: e
-    }), K.current.addEventListener(d, s, {
+    }), S.current.addEventListener(d, s, {
       capture: v,
       signal: e
     }), () => {
@@ -185,14 +182,14 @@ const _ = {
     d,
     v,
     C,
+    D,
     I,
-    O,
-    M,
+    Y,
     L,
     i
   ]);
 };
 export {
-  te as default
+  ee as default
 };
 //# sourceMappingURL=use-key.js.map

package/dist/use-key/use-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-key.js","sources":["../../src/use-key/use-key.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\n\nimport {\n  KeyOptions,\n  SequenceState,\n  UseKeySchema,\n  UseKeyCallback,\n  UseKeyOptions,\n  CombinationState,\n  KeyEventTypes,\n} from \"./use-key.types\";\nimport { parseKeySequences } from \"./parse-key-sequences\";\nimport { advanceSequenceState, resetSequenceState } from \"./sequence-state\";\nimport { invokeKeyAction } from \"./invoke-key-action\";\nimport { shouldHandleKeyboardEvent } from \"./event-guards\";\nimport { SPECIAL_KEYS } from \"./normalize-key\";\n\nconst defaultOptions: KeyOptions = {\n  eventType: KeyEventTypes.KeyUp,\n  eventRepeat: false,\n  eventCapture: false,\n  eventOnce: false,\n  eventStopImmediatePropagation: false,\n  sequenceThreshold: 1000,\n  combinationThreshold: 200,\n  container: { current: null },\n};\n\n/**\n * React hook for handling keyboard events with support for key sequences and combinations.\n *\n * Enables listening for single key presses, key combinations, and sequential key presses.\n * Supports customizable options like event type, repeat handling, and one-time listeners.\n *\n * @template T - The callback function type\n * @param {UseKeySchema} key - Single key, combination, sequence, or array of patterns to listen for\n * @param {UseKeyCallback} keyCallback - Callback function invoked when key pattern matches\n * @param {UseKeyOptions} [options] - Configuration options for the hook\n * @param {KeyEventType} [options.eventType=KeyEventTypes.KeyUp] - Type of keyboard event ('keydown' or 'keyup')\n * @param {boolean} [options.eventRepeat=false] - Allow repeated key presses to trigger callback\n * @param {boolean} [options.eventCapture=false] - Use event capture phase instead of bubbling\n * @param {boolean} [options.eventOnce=false] - Trigger callback only once\n * @param {boolean} [options.eventStopImmediatePropagation=false] - Stop immediate propagation\n * @param {number} [options.sequenceThreshold=1000] - Timeout in ms between sequence keys\n * @param {number} [options.combinationThreshold=200] - Timeout in ms between combination keys\n * @param {RefObject<HTMLElement>} [options.container] - DOM element to attach listener to (default: window)\n *\n * @example\n * // Single key schema\n * useKey('a', (event, key) => console.log(`Pressed ${key}`));\n *\n * @example\n * // Multiple patterns of single key schema\n * useKey(['a', 'b', 'c'], (event, key) => console.log(`Pressed ${key}`));\n *\n * @example\n * // Combination key schema\n * useKey('a+b', (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Multiple patterns of combination key schema\n * useKey(['a+b', 'c+d'], (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Sequential key schema\n * useKey('ArrowUp ArrowUp ArrowDown ArrowDown', (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Multiple patterns of sequential key schema\n * useKey(['ArrowUp ArrowUp ArrowDown ArrowDown', 'ArrowLeft ArrowRight'], (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Using options to listen for a key on keydown event and stop propagation\n * useKey('Any', handleSubmit, {\n *   eventType: KeyEventTypes.KeyDown,\n *   eventStopImmediatePropagation: true,\n *   container: inputRef\n * });\n *\n */\nconst useKey = (\n  key: UseKeySchema,\n  keyCallback: UseKeyCallback,\n  options: UseKeyOptions = defaultOptions,\n) => {\n  const {\n    eventType,\n    eventRepeat,\n    eventCapture,\n    eventOnce,\n    eventStopImmediatePropagation,\n    sequenceThreshold,\n    combinationThreshold,\n    container,\n  } = { ...defaultOptions, ...options };\n\n  const targetReference = useRef<EventTarget | null>(null);\n  const abortControllerReference = useRef<AbortController | null>(null);\n\n  const combinationReference = useRef<CombinationState>({\n    activeKeys: new Map(),\n  });\n  const sequenceReference = useRef<SequenceState[]>([]);\n\n  const resetCombination = useCallback(() => {\n    combinationReference.current.activeKeys.clear();\n  }, []);\n\n  const resetSequence = useCallback((sequence: SequenceState) => {\n    sequenceReference.current = resetSequenceState(\n      sequence,\n      sequenceReference.current,\n    );\n  }, []);\n\n  const shouldProcessEvent = useCallback(\n    (event: KeyboardEvent) => {\n      return shouldHandleKeyboardEvent(event, {\n        repeat: eventRepeat,\n      });\n    },\n    [eventRepeat],\n  );\n\n  const registerKeyDown = useCallback((event: KeyboardEvent) => {\n    const normalizedEventKey =\n      event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n    combinationReference.current.activeKeys.set(normalizedEventKey, {\n      pressedAt: Date.now(),\n    });\n  }, []);\n\n  const registerKeyUp = useCallback((event: KeyboardEvent) => {\n    const normalizedEventKey =\n      event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n    const state =\n      combinationReference.current.activeKeys.get(normalizedEventKey);\n    if (state) state.releasedAt = Date.now();\n  }, []);\n\n  const cleanupCombinationKeys = useCallback(() => {\n    const now = Date.now();\n    const combo = combinationReference.current;\n\n    [...combo.activeKeys.entries()].forEach(([key, state]) => {\n      if (eventType === KeyEventTypes.KeyDown) {\n        if (state.releasedAt) {\n          combo.activeKeys.delete(key);\n        }\n      } else if (\n        state.releasedAt &&\n        now - state.releasedAt > combinationThreshold\n      ) {\n        combo.activeKeys.delete(key);\n      }\n    });\n  }, [eventType, combinationThreshold]);\n\n  const validateCombination = useCallback(\n    (\n      expectedKey: string[],\n      activeKeys: Map<string, { pressedAt: number; releasedAt?: number }>,\n    ): boolean => {\n      if (eventType === KeyEventTypes.KeyDown) {\n        return (\n          activeKeys.size === expectedKey.length &&\n          expectedKey.every((key) => {\n            if (key === SPECIAL_KEYS.ANY) {\n              return activeKeys.size > 0;\n            }\n            return activeKeys.has(key);\n          })\n        );\n      }\n      if (eventType === KeyEventTypes.KeyUp) {\n        const keyStates = expectedKey.map((key) => {\n          if (key === SPECIAL_KEYS.ANY) {\n            const entries = [...activeKeys.entries()];\n            const lastEntry = entries.at(-1);\n            return lastEntry ? lastEntry[1] : undefined;\n          }\n          return activeKeys.get(key);\n        });\n\n        if (keyStates.some((state) => !state?.releasedAt)) {\n          return false;\n        }\n\n        const pressedTimes: number[] = keyStates\n          .map((state) => state?.pressedAt)\n          .filter((value): value is number => value !== undefined);\n        const releasedTimes: number[] = keyStates\n          .map((state) => state?.releasedAt)\n          .filter((value): value is number => value !== undefined);\n\n        const minReleased = Math.min(...releasedTimes);\n        const maxReleased = Math.max(...releasedTimes);\n        const maxPressed = Math.max(...pressedTimes);\n\n        if (maxPressed > minReleased) {\n          return false;\n        }\n\n        if (maxReleased - minReleased > combinationThreshold) {\n          return false;\n        }\n\n        return true;\n      }\n\n      return false;\n    },\n    [eventType, combinationThreshold],\n  );\n\n  const handleSingleKey = useCallback(\n    (event: KeyboardEvent, sequence: SequenceState) => {\n      const expectedKey = sequence.chord[0];\n\n      if (Array.isArray(expectedKey)) {\n        const { activeKeys } = combinationReference.current;\n\n        if (!validateCombination(expectedKey, activeKeys)) {\n          return;\n        }\n\n        invokeKeyAction(event, sequence.key, keyCallback, {\n          stopImmediate: eventStopImmediatePropagation,\n          once: eventOnce,\n          onOnce: () => {\n            abortControllerReference.current?.abort();\n          },\n        });\n\n        return;\n      }\n\n      const normalizedEventKey =\n        event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n      if (\n        expectedKey !== SPECIAL_KEYS.ANY &&\n        expectedKey !== normalizedEventKey\n      ) {\n        return;\n      }\n\n      invokeKeyAction(event, sequence.key, keyCallback, {\n        stopImmediate: eventStopImmediatePropagation,\n        once: eventOnce,\n        onOnce: () => {\n          abortControllerReference.current?.abort();\n        },\n      });\n    },\n    [\n      eventStopImmediatePropagation,\n      eventOnce,\n      keyCallback,\n      validateCombination,\n    ],\n  );\n\n  const handleSequenceStep = useCallback(\n    (event: KeyboardEvent, sequence: SequenceState) => {\n      const expectedKey = sequence.chord[sequence.index];\n\n      if (Array.isArray(expectedKey)) {\n        const { activeKeys } = combinationReference.current;\n\n        if (!validateCombination(expectedKey, activeKeys)) {\n          return;\n        }\n\n        const [updatedSequence, updatedSequences] = advanceSequenceState(\n          sequence,\n          sequenceReference.current,\n          sequenceThreshold,\n          resetSequence,\n        );\n        sequenceReference.current = updatedSequences;\n\n        if (updatedSequence.index === updatedSequence.chord.length) {\n          invokeKeyAction(event, updatedSequence.key, keyCallback, {\n            stopImmediate: eventStopImmediatePropagation,\n            once: eventOnce,\n            onOnce: () => {\n              abortControllerReference.current?.abort();\n            },\n          });\n\n          resetSequence(updatedSequence);\n        }\n\n        return;\n      }\n\n      const normalizedEventKey =\n        event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n      if (\n        expectedKey !== SPECIAL_KEYS.ANY &&\n        expectedKey !== normalizedEventKey\n      ) {\n        resetSequence(sequence);\n        return;\n      }\n\n      const [updatedSequence, updatedSequences] = advanceSequenceState(\n        sequence,\n        sequenceReference.current,\n        sequenceThreshold,\n        resetSequence,\n      );\n      sequenceReference.current = updatedSequences;\n\n      if (updatedSequence.index === updatedSequence.chord.length) {\n        invokeKeyAction(event, updatedSequence.key, keyCallback, {\n          stopImmediate: eventStopImmediatePropagation,\n          once: eventOnce,\n          onOnce: () => {\n            abortControllerReference.current?.abort();\n          },\n        });\n\n        resetSequence(updatedSequence);\n      }\n    },\n    [\n      eventOnce,\n      eventStopImmediatePropagation,\n      sequenceThreshold,\n      keyCallback,\n      resetSequence,\n      validateCombination,\n    ],\n  );\n\n  const evaluateSequences = useCallback(\n    (event: KeyboardEvent) => {\n      sequenceReference.current.forEach((sequence) => {\n        if (sequence.chord.length === 1) {\n          handleSingleKey(event, sequence);\n        } else {\n          handleSequenceStep(event, sequence);\n        }\n      });\n    },\n    [handleSingleKey, handleSequenceStep],\n  );\n\n  const handleEventListener = useCallback(\n    (event: KeyboardEvent) => {\n      if (!shouldProcessEvent(event)) {\n        return;\n      }\n\n      cleanupCombinationKeys();\n      evaluateSequences(event);\n    },\n    [shouldProcessEvent, cleanupCombinationKeys, evaluateSequences],\n  );\n\n  useEffect(() => {\n    sequenceReference.current = parseKeySequences(key);\n  }, [key]);\n\n  useEffect(() => {\n    targetReference.current = container?.current ?? globalThis;\n    abortControllerReference.current = new AbortController();\n    const { signal } = abortControllerReference.current;\n\n    const keyDownListener = (event: Event) =>\n      registerKeyDown(event as KeyboardEvent);\n\n    const keyUpListener = (event: Event) =>\n      registerKeyUp(event as KeyboardEvent);\n\n    const eventListener = (event: Event) =>\n      handleEventListener(event as KeyboardEvent);\n\n    targetReference.current.addEventListener(\"keydown\", keyDownListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    targetReference.current.addEventListener(\"keyup\", keyUpListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    targetReference.current.addEventListener(eventType, eventListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    return () => {\n      abortControllerReference.current?.abort();\n\n      resetCombination();\n      sequenceReference.current.forEach((sequence) => resetSequence(sequence));\n    };\n  }, [\n    eventType,\n    eventCapture,\n    container,\n    registerKeyDown,\n    registerKeyUp,\n    handleEventListener,\n    resetCombination,\n    resetSequence,\n  ]);\n};\n\nexport default useKey;\n"],"names":["defaultOptions","KeyEventTypes","useKey","key","keyCallback","options","eventType","eventRepeat","eventCapture","eventOnce","eventStopImmediatePropagation","sequenceThreshold","combinationThreshold","container","targetReference","useRef","abortControllerReference","combinationReference","sequenceReference","resetCombination","useCallback","resetSequence","sequence","resetSequenceState","shouldProcessEvent","event","shouldHandleKeyboardEvent","registerKeyDown","normalizedEventKey","SPECIAL_KEYS","registerKeyUp","state","cleanupCombinationKeys","now","combo","validateCombination","expectedKey","activeKeys","keyStates","lastEntry","pressedTimes","value","releasedTimes","minReleased","maxReleased","handleSingleKey","invokeKeyAction","handleSequenceStep","updatedSequence","updatedSequences","advanceSequenceState","evaluateSequences","handleEventListener","useEffect","parseKeySequences","signal","keyDownListener","keyUpListener","eventListener"],"mappings":"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"}
+{"version":3,"file":"use-key.js","sources":["../../src/use-key/use-key.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\n\nimport {\n  KeyOptions,\n  KeyEventTypes,\n  SequenceState,\n  CombinationState,\n  UseKeySchema,\n  UseKeyCallback,\n  UseKeyOptions,\n} from \"./use-key.types\";\nimport { parseKeySequences } from \"./parse-key-sequences\";\nimport { advanceSequenceState, resetSequenceState } from \"./sequence-state\";\nimport { invokeKeyAction } from \"./invoke-key-action\";\nimport { shouldHandleEvent } from \"./event-guards\";\nimport { SPECIAL_KEYS } from \"./normalize-key\";\n\nconst defaultOptions: KeyOptions = {\n  eventType: KeyEventTypes.KeyUp,\n  eventRepeat: false,\n  eventCapture: false,\n  eventOnce: false,\n  eventStopImmediatePropagation: false,\n  sequenceThreshold: 1000,\n  combinationThreshold: 200,\n  container: { current: null },\n};\n\n/**\n * React hook for handling keyboard events with support for key sequences and combinations.\n *\n * Enables listening for single key presses, key combinations, and sequential key presses.\n * Supports customizable options like event type, repeat handling, and one-time listeners.\n *\n * @template T - The callback function type\n * @param {UseKeySchema} key - Single key, combination, sequence, or array of patterns to listen for\n * @param {UseKeyCallback} keyCallback - Callback function invoked when key pattern matches\n * @param {UseKeyOptions} [options] - Configuration options for the hook\n * @param {KeyEventType} [options.eventType=KeyEventTypes.KeyUp] - Type of keyboard event ('keydown' or 'keyup')\n * @param {boolean} [options.eventRepeat=false] - Allow repeated key presses to trigger callback\n * @param {boolean} [options.eventCapture=false] - Use event capture phase instead of bubbling\n * @param {boolean} [options.eventOnce=false] - Trigger callback only once\n * @param {boolean} [options.eventStopImmediatePropagation=false] - Stop immediate propagation\n * @param {number} [options.sequenceThreshold=1000] - Timeout in ms between sequence keys\n * @param {number} [options.combinationThreshold=200] - Timeout in ms between combination keys\n * @param {RefObject<HTMLElement>} [options.container] - DOM element to attach listener to (default: window)\n *\n * @example\n * // Single key schema\n * useKey('a', (event, key) => console.log(`Pressed ${key}`));\n *\n * @example\n * // Multiple patterns of single key schema\n * useKey(['a', 'b', 'c'], (event, key) => console.log(`Pressed ${key}`));\n *\n * @example\n * // Combination key schema\n * useKey('a+b', (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Multiple patterns of combination key schema\n * useKey(['a+b', 'c+d'], (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Sequential key schema\n * useKey('ArrowUp ArrowUp ArrowDown ArrowDown', (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Multiple patterns of sequential key schema\n * useKey(['ArrowUp ArrowUp ArrowDown ArrowDown', 'ArrowLeft ArrowRight'], (event, key) => {\n *   console.log(`Pressed ${key}`);\n * });\n *\n * @example\n * // Using options to listen for a key on keydown event and stop propagation\n * useKey('Any', handleSubmit, {\n *   eventType: KeyEventTypes.KeyDown,\n *   eventStopImmediatePropagation: true,\n *   container: inputRef\n * });\n *\n */\nconst useKey = (\n  key: UseKeySchema,\n  keyCallback: UseKeyCallback,\n  options: UseKeyOptions = defaultOptions,\n) => {\n  const {\n    eventType,\n    eventRepeat,\n    eventCapture,\n    eventOnce,\n    eventStopImmediatePropagation,\n    sequenceThreshold,\n    combinationThreshold,\n    container,\n  } = { ...defaultOptions, ...options };\n\n  const targetReference = useRef<EventTarget | null>(null);\n  const abortControllerReference = useRef<AbortController | null>(null);\n\n  const combinationReference = useRef<CombinationState>({\n    activeKeys: new Map(),\n  });\n  const sequenceReference = useRef<SequenceState[]>([]);\n\n  const resetCombination = useCallback(() => {\n    combinationReference.current.activeKeys.clear();\n  }, []);\n\n  const resetSequence = useCallback((sequence: SequenceState) => {\n    sequenceReference.current = resetSequenceState(\n      sequence,\n      sequenceReference.current,\n    );\n  }, []);\n\n  const registerKeyDown = useCallback((event: KeyboardEvent) => {\n    const normalizedEventKey =\n      event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n    combinationReference.current.activeKeys.set(normalizedEventKey, {\n      pressedAt: Date.now(),\n    });\n  }, []);\n\n  const registerKeyUp = useCallback((event: KeyboardEvent) => {\n    const normalizedEventKey =\n      event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n    const state =\n      combinationReference.current.activeKeys.get(normalizedEventKey);\n    if (state) state.releasedAt = Date.now();\n  }, []);\n\n  const cleanupCombinationKeys = useCallback(() => {\n    const now = Date.now();\n    const combo = combinationReference.current;\n\n    [...combo.activeKeys.entries()].forEach(([key, state]) => {\n      if (eventType === KeyEventTypes.KeyDown) {\n        if (state.releasedAt) {\n          combo.activeKeys.delete(key);\n        }\n      } else if (\n        state.releasedAt &&\n        now - state.releasedAt > combinationThreshold\n      ) {\n        combo.activeKeys.delete(key);\n      }\n    });\n  }, [eventType, combinationThreshold]);\n\n  const validateCombination = useCallback(\n    (\n      expectedKey: string[],\n      activeKeys: Map<string, { pressedAt: number; releasedAt?: number }>,\n    ): boolean => {\n      if (eventType === KeyEventTypes.KeyDown) {\n        return (\n          activeKeys.size === expectedKey.length &&\n          expectedKey.every((key) => {\n            if (key === SPECIAL_KEYS.ANY) {\n              return activeKeys.size > 0;\n            }\n            return activeKeys.has(key);\n          })\n        );\n      }\n      if (eventType === KeyEventTypes.KeyUp) {\n        const keyStates = expectedKey.map((key) => {\n          if (key === SPECIAL_KEYS.ANY) {\n            const entries = [...activeKeys.entries()];\n            const lastEntry = entries.at(-1);\n            return lastEntry ? lastEntry[1] : undefined;\n          }\n          return activeKeys.get(key);\n        });\n\n        if (keyStates.some((state) => !state?.releasedAt)) {\n          return false;\n        }\n\n        const pressedTimes: number[] = keyStates\n          .map((state) => state?.pressedAt)\n          .filter((value): value is number => value !== undefined);\n        const releasedTimes: number[] = keyStates\n          .map((state) => state?.releasedAt)\n          .filter((value): value is number => value !== undefined);\n\n        const minReleased = Math.min(...releasedTimes);\n        const maxReleased = Math.max(...releasedTimes);\n        const maxPressed = Math.max(...pressedTimes);\n\n        if (maxPressed > minReleased) {\n          return false;\n        }\n\n        if (maxReleased - minReleased > combinationThreshold) {\n          return false;\n        }\n\n        return true;\n      }\n\n      return false;\n    },\n    [eventType, combinationThreshold],\n  );\n\n  const handleSingleKey = useCallback(\n    (event: KeyboardEvent, sequence: SequenceState) => {\n      const expectedKey = sequence.chord[0];\n\n      if (Array.isArray(expectedKey)) {\n        const { activeKeys } = combinationReference.current;\n\n        if (!validateCombination(expectedKey, activeKeys)) {\n          return;\n        }\n\n        invokeKeyAction(event, sequence.key, keyCallback, {\n          stopImmediate: eventStopImmediatePropagation,\n          once: eventOnce,\n          onOnce: () => {\n            abortControllerReference.current?.abort();\n          },\n        });\n\n        return;\n      }\n\n      const normalizedEventKey =\n        event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n      if (\n        expectedKey !== SPECIAL_KEYS.ANY &&\n        expectedKey !== normalizedEventKey\n      ) {\n        return;\n      }\n\n      invokeKeyAction(event, sequence.key, keyCallback, {\n        stopImmediate: eventStopImmediatePropagation,\n        once: eventOnce,\n        onOnce: () => {\n          abortControllerReference.current?.abort();\n        },\n      });\n    },\n    [\n      eventStopImmediatePropagation,\n      eventOnce,\n      keyCallback,\n      validateCombination,\n    ],\n  );\n\n  const handleSequenceStep = useCallback(\n    (event: KeyboardEvent, sequence: SequenceState) => {\n      const expectedKey = sequence.chord[sequence.index];\n\n      if (Array.isArray(expectedKey)) {\n        const { activeKeys } = combinationReference.current;\n\n        if (!validateCombination(expectedKey, activeKeys)) {\n          return;\n        }\n\n        const [updatedSequence, updatedSequences] = advanceSequenceState(\n          sequence,\n          sequenceReference.current,\n          sequenceThreshold,\n          resetSequence,\n        );\n        sequenceReference.current = updatedSequences;\n\n        if (updatedSequence.index === updatedSequence.chord.length) {\n          invokeKeyAction(event, updatedSequence.key, keyCallback, {\n            stopImmediate: eventStopImmediatePropagation,\n            once: eventOnce,\n            onOnce: () => {\n              abortControllerReference.current?.abort();\n            },\n          });\n\n          resetSequence(updatedSequence);\n        }\n\n        return;\n      }\n\n      const normalizedEventKey =\n        event.key === \" \" ? SPECIAL_KEYS.SPACE : event.key;\n      if (\n        expectedKey !== SPECIAL_KEYS.ANY &&\n        expectedKey !== normalizedEventKey\n      ) {\n        resetSequence(sequence);\n        return;\n      }\n\n      const [updatedSequence, updatedSequences] = advanceSequenceState(\n        sequence,\n        sequenceReference.current,\n        sequenceThreshold,\n        resetSequence,\n      );\n      sequenceReference.current = updatedSequences;\n\n      if (updatedSequence.index === updatedSequence.chord.length) {\n        invokeKeyAction(event, updatedSequence.key, keyCallback, {\n          stopImmediate: eventStopImmediatePropagation,\n          once: eventOnce,\n          onOnce: () => {\n            abortControllerReference.current?.abort();\n          },\n        });\n\n        resetSequence(updatedSequence);\n      }\n    },\n    [\n      eventOnce,\n      eventStopImmediatePropagation,\n      sequenceThreshold,\n      keyCallback,\n      resetSequence,\n      validateCombination,\n    ],\n  );\n\n  const evaluateSequences = useCallback(\n    (event: KeyboardEvent) => {\n      sequenceReference.current.forEach((sequence) => {\n        if (sequence.chord.length === 1) {\n          handleSingleKey(event, sequence);\n        } else {\n          handleSequenceStep(event, sequence);\n        }\n      });\n    },\n    [handleSingleKey, handleSequenceStep],\n  );\n\n  const handleEventListener = useCallback(\n    (event: KeyboardEvent) => {\n      if (\n        !shouldHandleEvent(event, {\n          repeat: eventRepeat,\n        })\n      ) {\n        return;\n      }\n\n      cleanupCombinationKeys();\n      evaluateSequences(event);\n    },\n    [cleanupCombinationKeys, evaluateSequences, eventRepeat],\n  );\n\n  useEffect(() => {\n    sequenceReference.current = parseKeySequences(key);\n  }, [key]);\n\n  useEffect(() => {\n    targetReference.current = container?.current ?? globalThis;\n    abortControllerReference.current = new AbortController();\n    const { signal } = abortControllerReference.current;\n\n    const keyDownListener = (event: Event) =>\n      registerKeyDown(event as KeyboardEvent);\n\n    const keyUpListener = (event: Event) =>\n      registerKeyUp(event as KeyboardEvent);\n\n    const eventListener = (event: Event) =>\n      handleEventListener(event as KeyboardEvent);\n\n    targetReference.current.addEventListener(\"keydown\", keyDownListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    targetReference.current.addEventListener(\"keyup\", keyUpListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    targetReference.current.addEventListener(eventType, eventListener, {\n      capture: eventCapture,\n      signal,\n    });\n\n    return () => {\n      abortControllerReference.current?.abort();\n\n      resetCombination();\n      sequenceReference.current.forEach((sequence) => resetSequence(sequence));\n    };\n  }, [\n    eventType,\n    eventCapture,\n    container,\n    registerKeyDown,\n    registerKeyUp,\n    handleEventListener,\n    resetCombination,\n    resetSequence,\n  ]);\n};\n\nexport default useKey;\n"],"names":["defaultOptions","KeyEventTypes","useKey","key","keyCallback","options","eventType","eventRepeat","eventCapture","eventOnce","eventStopImmediatePropagation","sequenceThreshold","combinationThreshold","container","targetReference","useRef","abortControllerReference","combinationReference","sequenceReference","resetCombination","useCallback","resetSequence","sequence","resetSequenceState","registerKeyDown","event","normalizedEventKey","SPECIAL_KEYS","registerKeyUp","state","cleanupCombinationKeys","now","combo","validateCombination","expectedKey","activeKeys","keyStates","lastEntry","pressedTimes","value","releasedTimes","minReleased","maxReleased","handleSingleKey","invokeKeyAction","handleSequenceStep","updatedSequence","updatedSequences","advanceSequenceState","evaluateSequences","handleEventListener","shouldHandleEvent","useEffect","parseKeySequences","signal","keyDownListener","keyUpListener","eventListener"],"mappings":"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"}

package/dist/use-key/use-key.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-key.types.js","sources":["../../src/use-key/use-key.types.ts"],"sourcesContent":["import { RefObject } from \"react\";\n\nexport type Key = string;\n\nexport type KeyEvent = Key | Key[];\n\nexport const KeyEventTypes = {\n  KeyUp: \"keyup\",\n  KeyDown: \"keydown\",\n} as const;\n\nexport type KeyEventType = (typeof KeyEventTypes)[keyof typeof KeyEventTypes];\n\nexport interface KeyOptions {\n  eventType: KeyEventType;\n  eventRepeat: boolean;\n  eventCapture: boolean;\n  eventOnce: boolean;\n  eventStopImmediatePropagation: boolean;\n  sequenceThreshold: number;\n  combinationThreshold: number;\n  container: RefObject<HTMLElement | null>;\n}\n\nexport interface CombinationActiveKey {\n  pressedAt: number;\n  releasedAt?: number;\n}\n\nexport interface CombinationState {\n  activeKeys: Map<Key, CombinationActiveKey>;\n}\n\nexport type KeyChord = (Key | Key[])[];\n\nexport interface SequenceState {\n  key: Key;\n  chord: KeyChord;\n  index: number;\n  sequenceTimeout: ReturnType<typeof setTimeout> | null;\n}\n\nexport type UseKeySchema = KeyEvent;\n\nexport type UseKeyCallback =\n  | ((event: KeyboardEvent, key: Key, ...properties: unknown[]) => boolean)\n  | ((event: KeyboardEvent, key: Key, ...properties: unknown[]) => void);\n\nexport type UseKeyOptions = Partial<KeyOptions>;\n"],"names":["KeyEventTypes"],"mappings":"AAMO,MAAMA,IAAgB;AAAA,EAC3B,OAAO;AAAA,EACP,SAAS;AACX;"}
+{"version":3,"file":"use-key.types.js","sources":["../../src/use-key/use-key.types.ts"],"sourcesContent":["export type Key = string;\n\nexport type KeyEvent = Key | Key[];\n\nexport const KeyEventTypes = {\n  KeyUp: \"keyup\",\n  KeyDown: \"keydown\",\n} as const;\n\nexport type KeyEventType = (typeof KeyEventTypes)[keyof typeof KeyEventTypes];\n\nexport interface KeyOptions {\n  eventType: KeyEventType;\n  eventRepeat: boolean;\n  eventCapture: boolean;\n  eventOnce: boolean;\n  eventStopImmediatePropagation: boolean;\n  sequenceThreshold: number;\n  combinationThreshold: number;\n  container: { current: EventTarget | null };\n}\n\nexport interface CombinationActiveKey {\n  pressedAt: number;\n  releasedAt?: number;\n}\n\nexport interface CombinationState {\n  activeKeys: Map<Key, CombinationActiveKey>;\n}\n\nexport type KeyChord = (Key | Key[])[];\n\nexport interface SequenceState {\n  key: Key;\n  chord: KeyChord;\n  index: number;\n  sequenceTimeout: ReturnType<typeof setTimeout> | null;\n}\n\nexport type UseKeySchema = KeyEvent;\n\nexport type UseKeyCallback =\n  | ((event: KeyboardEvent, key: Key, ...properties: unknown[]) => boolean)\n  | ((event: KeyboardEvent, key: Key, ...properties: unknown[]) => void);\n\nexport type UseKeyOptions = Partial<KeyOptions>;\n"],"names":["KeyEventTypes"],"mappings":"AAIO,MAAMA,IAAgB;AAAA,EAC3B,OAAO;AAAA,EACP,SAAS;AACX;"}