@versini/ui-hooks 4.3.0 → 4.4.0

package/dist/hooks/useInViewport.js

@@ -0,0 +1,13 @@
+import { useRef as f, useState as u, useCallback as l } from "react";
+function b() {
+  const e = f(null), [i, t] = u(!1);
+  return { ref: l((r) => {
+    var n, s;
+    typeof IntersectionObserver < "u" && (r && !e.current ? e.current = new IntersectionObserver(
+      (o) => t(o.some((c) => c.isIntersecting))
+    ) : (n = e.current) == null || n.disconnect(), r ? (s = e.current) == null || s.observe(r) : t(!1));
+  }, []), inViewport: i };
+}
+export {
+  b as useInViewport
+};

package/dist/index.d.ts

@@ -11,8 +11,20 @@ type HotkeyItem = [
     (event: KeyboardEvent) => void,
     HotkeyItemOptions?
 ];
+declare function shouldFireEvent(event: KeyboardEvent, tagsToIgnore: string[], triggerOnContentEditable?: boolean): boolean;
 declare function useHotkeys(hotkeys: HotkeyItem[], tagsToIgnore?: string[], triggerOnContentEditable?: boolean): void;
 
+/**
+ * Hook that checks if an element is visible in the viewport.
+ * @returns
+ * ref: React ref object to attach to the element you want to monitor.
+ * inViewport: Boolean indicating if the element is in the viewport.
+ */
+declare function useInViewport<T extends HTMLElement = any>(): {
+    ref: (node: T | null) => void;
+    inViewport: boolean;
+};
+
 /**
  * Custom hook that returns a function indicating whether the component
  * is mounted or not.
@@ -142,4 +154,4 @@ type UseUniqueIdOptions = string | number | {
 };
 declare function useUniqueId(options?: UseUniqueIdOptions): string | undefined;
 
-export { getHotkeyHandler, useHotkeys, useIsMounted, useLocalStorage, useMergeRefs, useResizeObserver, useUncontrolled, useUniqueId };
+export { type HotkeyItem, type HotkeyItemOptions, type StorageProperties, type UseUniqueIdOptions, getHotkeyHandler, shouldFireEvent, useHotkeys, useInViewport, useIsMounted, useLocalStorage, useMergeRefs, useResizeObserver, useUncontrolled, useUniqueId };

package/dist/index.js

@@ -1,21 +1,24 @@
-import { getHotkeyHandler as r, useHotkeys as t } from "./hooks/useHotkeys.js";
-import { useIsMounted as u } from "./hooks/useIsMounted.js";
-import { useLocalStorage as m } from "./hooks/useLocalStorage.js";
-import { useMergeRefs as x } from "./hooks/useMergeRefs.js";
-import { useResizeObserver as d } from "./hooks/useResizeObserver.js";
-import { useUncontrolled as a } from "./hooks/useUncontrolled.js";
-import { useUniqueId as H } from "./hooks/useUniqueId.js";
+import { getHotkeyHandler as r, shouldFireEvent as t, useHotkeys as s } from "./hooks/useHotkeys.js";
+import { useInViewport as f } from "./hooks/useInViewport.js";
+import { useIsMounted as m } from "./hooks/useIsMounted.js";
+import { useLocalStorage as n } from "./hooks/useLocalStorage.js";
+import { useMergeRefs as l } from "./hooks/useMergeRefs.js";
+import { useResizeObserver as a } from "./hooks/useResizeObserver.js";
+import { useUncontrolled as H } from "./hooks/useUncontrolled.js";
+import { useUniqueId as c } from "./hooks/useUniqueId.js";
 /*!
-  @versini/ui-hooks v4.3.0
-  © 2024 gizmette.com
+  @versini/ui-hooks v4.4.0
+  © 2025 gizmette.com
 */
 export {
   r as getHotkeyHandler,
-  t as useHotkeys,
-  u as useIsMounted,
-  m as useLocalStorage,
-  x as useMergeRefs,
-  d as useResizeObserver,
-  a as useUncontrolled,
-  H as useUniqueId
+  t as shouldFireEvent,
+  s as useHotkeys,
+  f as useInViewport,
+  m as useIsMounted,
+  n as useLocalStorage,
+  l as useMergeRefs,
+  a as useResizeObserver,
+  H as useUncontrolled,
+  c as useUniqueId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/ui-hooks",
-	"version": "4.3.0",
+	"version": "4.4.0",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -37,5 +37,5 @@
 		"react": "^18.3.1 || ^19.0.0",
 		"react-dom": "^18.3.1 || ^19.0.0"
 	},
-	"gitHead": "413e5c7cd8228d2f135f54fa897101401207229b"
+	"gitHead": "bc91b8aaa11a672d219b6f32da04f001f33e38d7"
 }