@versini/ui-hooks 4.1.3 → 4.2.1

package/dist/hooks/useHotkeys.js

@@ -0,0 +1,56 @@
+import { useEffect as y } from "react";
+function E(t) {
+  const e = t.toLowerCase().split("+").map((s) => s.trim()), r = {
+    alt: e.includes("alt"),
+    ctrl: e.includes("ctrl"),
+    meta: e.includes("meta"),
+    mod: e.includes("mod"),
+    shift: e.includes("shift")
+  }, a = ["alt", "ctrl", "meta", "shift", "mod"], n = e.find((s) => !a.includes(s));
+  return {
+    ...r,
+    key: n
+  };
+}
+function p(t, e) {
+  const { alt: r, ctrl: a, meta: n, mod: s, shift: i, key: f } = t, { altKey: c, ctrlKey: o, metaKey: u, shiftKey: d, key: m } = e;
+  if (r !== c)
+    return !1;
+  if (s) {
+    if (!o && !u)
+      return !1;
+  } else if (a !== o || n !== u)
+    return !1;
+  return i !== d ? !1 : !!(f && (m.toLowerCase() === f.toLowerCase() || e.code.replace("Key", "").toLowerCase() === f.toLowerCase()));
+}
+function l(t) {
+  return (e) => p(E(t), e);
+}
+function h(t) {
+  return (e) => {
+    const r = "nativeEvent" in e ? e.nativeEvent : e;
+    t.forEach(([a, n, s = { preventDefault: !0 }]) => {
+      l(a)(r) && (s.preventDefault && e.preventDefault(), n(r));
+    });
+  };
+}
+function k(t, e, r = !1) {
+  return t.target instanceof HTMLElement ? (r || !t.target.isContentEditable) && !e.includes(t.target.tagName) : !0;
+}
+function w(t, e = ["INPUT", "TEXTAREA", "SELECT"], r = !1) {
+  y(() => {
+    const a = (n) => {
+      t.forEach(
+        ([s, i, f = { preventDefault: !0 }]) => {
+          l(s)(n) && k(n, e, r) && (f.preventDefault && n.preventDefault(), i(n));
+        }
+      );
+    };
+    return document.documentElement.addEventListener("keydown", a), () => document.documentElement.removeEventListener("keydown", a);
+  }, [t, e, r]);
+}
+export {
+  h as getHotkeyHandler,
+  k as shouldFireEvent,
+  w as useHotkeys
+};

package/dist/index.d.ts

@@ -1,5 +1,16 @@
 import * as react from 'react';
 
+interface HotkeyItemOptions {
+    preventDefault?: boolean;
+}
+
+type HotkeyItem = [
+    string,
+    (event: KeyboardEvent) => void,
+    HotkeyItemOptions?
+];
+declare function useHotkeys(hotkeys: HotkeyItem[], tagsToIgnore?: string[], triggerOnContentEditable?: boolean): void;
+
 /**
  * Custom hook that returns a function indicating whether the component
  * is mounted or not.
@@ -129,4 +140,4 @@ type UseUniqueIdOptions = string | number | {
 };
 declare function useUniqueId(options?: UseUniqueIdOptions): string | undefined;
 
-export { useIsMounted, useLocalStorage, useMergeRefs, useResizeObserver, useUncontrolled, useUniqueId };
+export { useHotkeys, useIsMounted, useLocalStorage, useMergeRefs, useResizeObserver, useUncontrolled, useUniqueId };

package/dist/index.js

@@ -1,18 +1,20 @@
-import { useIsMounted as r } from "./hooks/useIsMounted.js";
-import { useLocalStorage as t } from "./hooks/useLocalStorage.js";
-import { useMergeRefs as f } from "./hooks/useMergeRefs.js";
-import { useResizeObserver as p } from "./hooks/useResizeObserver.js";
-import { useUncontrolled as n } from "./hooks/useUncontrolled.js";
-import { useUniqueId as l } from "./hooks/useUniqueId.js";
+import { useHotkeys as r } from "./hooks/useHotkeys.js";
+import { useIsMounted as t } from "./hooks/useIsMounted.js";
+import { useLocalStorage as f } from "./hooks/useLocalStorage.js";
+import { useMergeRefs as p } from "./hooks/useMergeRefs.js";
+import { useResizeObserver as n } from "./hooks/useResizeObserver.js";
+import { useUncontrolled as l } from "./hooks/useUncontrolled.js";
+import { useUniqueId as c } from "./hooks/useUniqueId.js";
 /*!
-  @versini/ui-hooks v4.1.3
+  @versini/ui-hooks v4.2.1
   © 2024 gizmette.com
 */
 export {
-  r as useIsMounted,
-  t as useLocalStorage,
-  f as useMergeRefs,
-  p as useResizeObserver,
-  n as useUncontrolled,
-  l as useUniqueId
+  r as useHotkeys,
+  t as useIsMounted,
+  f as useLocalStorage,
+  p as useMergeRefs,
+  n as useResizeObserver,
+  l as useUncontrolled,
+  c as useUniqueId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/ui-hooks",
-	"version": "4.1.3",
+	"version": "4.2.1",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -41,5 +41,5 @@
 		"react": "18.3.1",
 		"react-dom": "18.3.1"
 	},
-	"gitHead": "5398941244aa5c6642426325c804d7cb9529b688"
+	"gitHead": "b4cbab083052f7f45b00e98c2992fffa31d05c1f"
 }