@siberiacancode/reactuse 0.0.112 → 0.0.113

package/dist/esm/hooks/useHover/useHover.mjs

@@ -0,0 +1,26 @@
+import { useState as l, useRef as L, useEffect as d } from "react";
+import { useRefState as g } from "../useRefState/useRefState.mjs";
+import { isTarget as y } from "../../utils/helpers/isTarget.mjs";
+import { getElement as R } from "../../utils/helpers/getElement.mjs";
+const H = (...t) => {
+  const n = y(t[0]) ? t[0] : void 0, f = n ? typeof t[1] == "object" ? t[1] : { onEntry: t[1] } : typeof t[0] == "object" ? t[0] : { onEntry: t[0] }, [c, v] = l(!1), s = g(), u = L(f);
+  return u.current = f, d(() => {
+    if (!n && !s.state) return;
+    const o = n ? R(n) : s.current;
+    if (!o) return;
+    const E = (i) => {
+      var e, r;
+      (r = (e = u.current) == null ? void 0 : e.onEntry) == null || r.call(e, i), v(!0);
+    }, m = (i) => {
+      var e, r;
+      (r = (e = u.current) == null ? void 0 : e.onLeave) == null || r.call(e, i), v(!1);
+    };
+    return o.addEventListener("mouseenter", E), o.addEventListener("mouseleave", m), () => {
+      o.removeEventListener("mouseenter", E), o.removeEventListener("mouseleave", m);
+    };
+  }, [n, s.state]), n ? c : [s, c];
+};
+export {
+  H as useHover
+};
+//# sourceMappingURL=useHover.mjs.map

package/dist/esm/hooks/useHover/useHover.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHover.mjs","sources":["../../../../src/hooks/useHover/useHover.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use hover options type */\nexport interface UseHoverOptions {\n  /** The on entry callback */\n  onEntry?: (event: Event) => void;\n  /** The on leave callback */\n  onLeave?: (event: Event) => void;\n}\n\nexport interface UseHover {\n  (target: HookTarget, callback?: (event: Event) => void): boolean;\n\n  (target: HookTarget, options?: UseHoverOptions): boolean;\n\n  <Target extends Element>(\n    callback?: (event: Event) => void,\n    target?: never\n  ): [StateRef<Target>, boolean];\n\n  <Target extends Element>(options?: UseHoverOptions, target?: never): [StateRef<Target>, boolean];\n}\n\n/**\n * @name useHover\n * @description - Hook that defines the logic when hovering an element\n * @category Sensors\n *\n * @overload\n * @param {HookTarget} target The target element to be hovered\n * @param {(event: Event) => void} [callback] The callback function to be invoked on mouse enter\n * @returns {boolean} The state of the hover\n *\n * @example\n * const hovering = useHover(ref, () => console.log('callback'));\n *\n * @overload\n * @param {HookTarget} target The target element to be hovered\n * @param {(event: Event) => void} [options.onEntry] The callback function to be invoked on mouse enter\n * @param {(event: Event) => void} [options.onLeave] The callback function to be invoked on mouse leave\n * @returns {boolean} The state of the hover\n *\n * @example\n * const hovering = useHover(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(event: Event) => void} [callback] The callback function to be invoked on mouse enter\n * @returns {UseHoverReturn<Target>} The state of the hover\n *\n * @example\n * const [ref, hovering] = useHover(() => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {(event: Event) => void} [options.onEntry] The callback function to be invoked on mouse enter\n * @param {(event: Event) => void} [options.onLeave] The callback function to be invoked on mouse leave\n * @returns {UseHoverReturn<Target>} The state of the hover\n *\n * @example\n * const [ref, hovering] = useHover(options);\n */\nexport const useHover = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onEntry: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onEntry: params[0] }\n  ) as UseHoverOptions | undefined;\n\n  const [hovering, setHovering] = useState(false);\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n\n    if (!element) return;\n\n    const onMouseEnter = (event: Event) => {\n      internalOptionsRef.current?.onEntry?.(event);\n      setHovering(true);\n    };\n\n    const onMouseLeave = (event: Event) => {\n      internalOptionsRef.current?.onLeave?.(event);\n      setHovering(false);\n    };\n\n    element.addEventListener('mouseenter', onMouseEnter);\n    element.addEventListener('mouseleave', onMouseLeave);\n\n    return () => {\n      element.removeEventListener('mouseenter', onMouseEnter);\n      element.removeEventListener('mouseleave', onMouseLeave);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return hovering;\n  return [internalRef, hovering] as const;\n}) as UseHover;\n"],"names":["useHover","params","target","isTarget","options","hovering","setHovering","useState","internalRef","useRefState","internalOptionsRef","useRef","useEffect","element","getElement","onMouseEnter","event","_b","_a","onMouseLeave"],"mappings":";;;;AAsEa,MAAAA,IAAY,IAAIC,MAAkB;AACvC,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAE5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,SAASA,EAAO,CAAC,EAAE,IACvB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,SAASA,EAAO,CAAC,EAAE,GAGvB,CAACI,GAAUC,CAAW,IAAIC,EAAS,EAAK,GACxCC,IAAcC,EAAqB,GACnCC,IAAqBC,EAAOP,CAAO;AA4BzC,SA3BAM,EAAmB,UAAUN,GAE7BQ,EAAU,MAAM;AACd,QAAI,CAACV,KAAU,CAACM,EAAY,MAAO;AACnC,UAAMK,IAAWX,IAASY,EAAWZ,CAAM,IAAIM,EAAY;AAE3D,QAAI,CAACK,EAAS;AAER,UAAAE,IAAe,CAACC,MAAiB;;AAClB,OAAAC,KAAAC,IAAAR,EAAA,YAAA,gBAAAQ,EAAS,YAAT,QAAAD,EAAA,KAAAC,GAAmBF,IACtCV,EAAY,EAAI;AAAA,IAClB,GAEMa,IAAe,CAACH,MAAiB;;AAClB,OAAAC,KAAAC,IAAAR,EAAA,YAAA,gBAAAQ,EAAS,YAAT,QAAAD,EAAA,KAAAC,GAAmBF,IACtCV,EAAY,EAAK;AAAA,IACnB;AAEQ,WAAAO,EAAA,iBAAiB,cAAcE,CAAY,GAC3CF,EAAA,iBAAiB,cAAcM,CAAY,GAE5C,MAAM;AACH,MAAAN,EAAA,oBAAoB,cAAcE,CAAY,GAC9CF,EAAA,oBAAoB,cAAcM,CAAY;AAAA,IACxD;AAAA,EACC,GAAA,CAACjB,GAAQM,EAAY,KAAK,CAAC,GAE1BN,IAAeG,IACZ,CAACG,GAAaH,CAAQ;AAC/B;"}

package/dist/esm/hooks/useIdle/useIdle.mjs

@@ -0,0 +1,27 @@
+import { useState as a, useEffect as l } from "react";
+import { throttle as f } from "../../utils/helpers/throttle.mjs";
+const h = [
+  "mousemove",
+  "mousedown",
+  "keydown",
+  "touchstart",
+  "wheel",
+  "resize"
+], v = 6e4, L = (t = v, { initialValue: u = !1, events: o = h } = {}) => {
+  const [d, s] = a(u), [m, E] = a(Date.now());
+  return l(() => {
+    let e;
+    const r = () => s(!0), n = f(() => {
+      s(!1), E(Date.now()), clearTimeout(e), e = setTimeout(r, t);
+    }, 500), c = () => {
+      document.hidden || n();
+    };
+    return e = setTimeout(r, t), o.forEach((i) => window.addEventListener(i, n)), document.addEventListener("visibilitychange", c), () => {
+      o.forEach((i) => window.addEventListener(i, n)), document.removeEventListener("visibilitychange", c), clearTimeout(e);
+    };
+  }, [t, o]), { idle: d, lastActive: m };
+};
+export {
+  L as useIdle
+};
+//# sourceMappingURL=useIdle.mjs.map

package/dist/esm/hooks/useIdle/useIdle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIdle.mjs","sources":["../../../../src/hooks/useIdle/useIdle.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { throttle } from '@/utils/helpers';\n\n/** The use idle options type */\nexport interface UseIdleOptions {\n  /** The idle events */\n  events?: Array<keyof DocumentEventMap>;\n  /** The idle state */\n  initialValue?: boolean;\n}\n\nconst IDLE_EVENTS = [\n  'mousemove',\n  'mousedown',\n  'keydown',\n  'touchstart',\n  'wheel',\n  'resize'\n] satisfies Array<keyof DocumentEventMap>;\nconst ONE_MINUTE = 60e3;\n\n/** The use idle return type */\nexport interface UseIdleReturn {\n  /** The idle state */\n  idle: boolean;\n  /** The last active time */\n  lastActive: number;\n}\n\n/**\n * @name useIdle\n * @description - Hook that defines the logic when the user is idle\n * @category Sensors\n *\n * @param {number} [milliseconds=ONE_MINUTE] The idle time in milliseconds\n * @param {boolean} [options.initialState=false] The options for the hook\n * @param {Array<keyof WindowEventMap>} [options.events=IDLE_EVENTS]\n * @returns {UseIdleReturn} An object containing the idle state and the last active time\n *\n * @example\n * const { idle, lastActive } = useIdle();\n */\nexport const useIdle = (\n  milliseconds = ONE_MINUTE,\n  { initialValue = false, events = IDLE_EVENTS }: UseIdleOptions = {}\n): UseIdleReturn => {\n  const [idle, setIdle] = useState(initialValue);\n  const [lastActive, setLastActive] = useState(Date.now());\n\n  useEffect(() => {\n    let timeoutId: ReturnType<typeof setTimeout>;\n    const onTimeout = () => setIdle(true);\n\n    const onEvent = throttle(() => {\n      setIdle(false);\n      setLastActive(Date.now());\n      clearTimeout(timeoutId);\n      timeoutId = setTimeout(onTimeout, milliseconds);\n    }, 500);\n\n    const onVisibilitychange = () => {\n      if (!document.hidden) onEvent();\n    };\n\n    timeoutId = setTimeout(onTimeout, milliseconds);\n\n    events.forEach((event) => window.addEventListener(event, onEvent));\n    document.addEventListener('visibilitychange', onVisibilitychange);\n\n    return () => {\n      events.forEach((event) => window.addEventListener(event, onEvent));\n      document.removeEventListener('visibilitychange', onVisibilitychange);\n      clearTimeout(timeoutId);\n    };\n  }, [milliseconds, events]);\n\n  return { idle, lastActive };\n};\n"],"names":["IDLE_EVENTS","ONE_MINUTE","useIdle","milliseconds","initialValue","events","idle","setIdle","useState","lastActive","setLastActive","useEffect","timeoutId","onTimeout","onEvent","throttle","onVisibilitychange","event"],"mappings":";;AAYA,MAAMA,IAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GACMC,IAAa,KAuBNC,IAAU,CACrBC,IAAeF,GACf,EAAE,cAAAG,IAAe,IAAO,QAAAC,IAASL,EAAgC,IAAA,OAC/C;AAClB,QAAM,CAACM,GAAMC,CAAO,IAAIC,EAASJ,CAAY,GACvC,CAACK,GAAYC,CAAa,IAAIF,EAAS,KAAK,KAAK;AAEvD,SAAAG,EAAU,MAAM;AACV,QAAAC;AACE,UAAAC,IAAY,MAAMN,EAAQ,EAAI,GAE9BO,IAAUC,EAAS,MAAM;AAC7B,MAAAR,EAAQ,EAAK,GACCG,EAAA,KAAK,KAAK,GACxB,aAAaE,CAAS,GACVA,IAAA,WAAWC,GAAWV,CAAY;AAAA,OAC7C,GAAG,GAEAa,IAAqB,MAAM;AAC3B,MAAC,SAAS,UAAgBF,EAAA;AAAA,IAChC;AAEY,WAAAF,IAAA,WAAWC,GAAWV,CAAY,GAE9CE,EAAO,QAAQ,CAACY,MAAU,OAAO,iBAAiBA,GAAOH,CAAO,CAAC,GACxD,SAAA,iBAAiB,oBAAoBE,CAAkB,GAEzD,MAAM;AACX,MAAAX,EAAO,QAAQ,CAACY,MAAU,OAAO,iBAAiBA,GAAOH,CAAO,CAAC,GACxD,SAAA,oBAAoB,oBAAoBE,CAAkB,GACnE,aAAaJ,CAAS;AAAA,IACxB;AAAA,EAAA,GACC,CAACT,GAAcE,CAAM,CAAC,GAElB,EAAE,MAAAC,GAAM,YAAAG,EAAW;AAC5B;"}

package/dist/esm/hooks/useImage/useImage.mjs

@@ -0,0 +1,12 @@
+import { useQuery as g } from "../useQuery/useQuery.mjs";
+const t = async (e, o = {}) => new Promise((r, m) => {
+  const s = new Image(), { srcset: i, sizes: c, class: a, loading: n, crossorigin: f, referrerPolicy: l } = o;
+  s.src = e, i && (s.srcset = i), c && (s.sizes = c), a && (s.className = a), n && (s.loading = n), f && (s.crossOrigin = f), l && (s.referrerPolicy = l), s.onload = () => r(s), s.onerror = m;
+}), d = (e, o, r = {}) => g(() => t(e, o), {
+  keys: [e, ...r.keys ?? []],
+  ...r
+});
+export {
+  d as useImage
+};
+//# sourceMappingURL=useImage.mjs.map

package/dist/esm/hooks/useImage/useImage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImage.mjs","sources":["../../../../src/hooks/useImage/useImage.ts"],"sourcesContent":["import type { UseQueryOptions, UseQueryReturn } from '../useQuery/useQuery';\n\nimport { useQuery } from '../useQuery/useQuery';\n\n/** The use image options */\nexport interface UseImageOptions {\n  /** The alt of the image */\n  alt?: string;\n  /** The class of the image */\n  class?: string;\n  /** The crossorigin of the image */\n  crossorigin?: string;\n  /** The loading of the image */\n  loading?: HTMLImageElement['loading'];\n  /** The referrer policy of the image */\n  referrerPolicy?: HTMLImageElement['referrerPolicy'];\n  /** The sizes of the image */\n  sizes?: string;\n  /** The srcset of the image */\n  srcset?: string;\n}\n\n/** The use image return type */\nexport type UseImageReturn = UseQueryReturn<HTMLImageElement>;\n\nconst loadImage = async (src: string, options: UseImageOptions = {}): Promise<HTMLImageElement> =>\n  new Promise((resolve, reject) => {\n    const img = new Image();\n    const { srcset, sizes, class: className, loading, crossorigin, referrerPolicy } = options;\n\n    img.src = src;\n    if (srcset) img.srcset = srcset;\n    if (sizes) img.sizes = sizes;\n    if (className) img.className = className;\n    if (loading) img.loading = loading;\n    if (crossorigin) img.crossOrigin = crossorigin;\n\n    if (referrerPolicy) img.referrerPolicy = referrerPolicy;\n\n    img.onload = () => resolve(img);\n    img.onerror = reject;\n  });\n\n/**\n * @name useImage\n * @description - Hook that load an image in the browser\n * @category Browser\n *\n * @param {string} src The source of the image\n * @param {string} [options.srcset] The srcset of the image\n * @param {string} [options.sizes] The sizes of the image\n * @param {string} [options.alt] The alt of the image\n * @param {string} [options.class] The class of the image\n * @param {HTMLImageElement['loading']} [options.loading] The loading of the image\n * @param {string} [options.crossorigin] The crossorigin of the image\n * @param {HTMLImageElement['referrerPolicy']} [options.referrerPolicy] The referrerPolicy of the image\n * @param {DependencyList} [useQueryOptions.keys] The dependencies for the hook\n * @param {(data: Data) => void} [useQueryOptions.onSuccess] The callback function to be invoked on success\n * @param {(error: Error) => void} [useQueryOptions.onError] The callback function to be invoked on error\n * @param {number} [useQueryOptions.refetchInterval] The refetch interval\n * @param {boolean | number} [useQueryOptions.retry] The retry count of requests\n * @returns {UseImageReturn} An object with the state of the image\n *\n * @example\n * const { data, isLoading, isError, isSuccess, error, refetch, isRefetching } = useImage('https://example.com/image.png');\n */\nexport const useImage = (\n  src: string,\n  options?: UseImageOptions,\n  useQueryOptions: Omit<\n    UseQueryOptions<HTMLImageElement, HTMLImageElement>,\n    'initialData' | 'placeholderData' | 'select'\n  > = {}\n) =>\n  useQuery(() => loadImage(src, options), {\n    keys: [src, ...(useQueryOptions.keys ?? [])],\n    ...useQueryOptions\n  });\n"],"names":["loadImage","src","options","resolve","reject","img","srcset","sizes","className","loading","crossorigin","referrerPolicy","useImage","useQueryOptions","useQuery"],"mappings":";AAyBA,MAAMA,IAAY,OAAOC,GAAaC,IAA2B,CAAA,MAC/D,IAAI,QAAQ,CAACC,GAASC,MAAW;AACzB,QAAAC,IAAM,IAAI,MAAM,GAChB,EAAE,QAAAC,GAAQ,OAAAC,GAAO,OAAOC,GAAW,SAAAC,GAAS,aAAAC,GAAa,gBAAAC,MAAmBT;AAElF,EAAAG,EAAI,MAAMJ,GACNK,QAAY,SAASA,IACrBC,QAAW,QAAQA,IACnBC,QAAe,YAAYA,IAC3BC,QAAa,UAAUA,IACvBC,QAAiB,cAAcA,IAE/BC,QAAoB,iBAAiBA,IAErCN,EAAA,SAAS,MAAMF,EAAQE,CAAG,GAC9BA,EAAI,UAAUD;AAChB,CAAC,GAyBUQ,IAAW,CACtBX,GACAC,GACAW,IAGI,CAAA,MAEJC,EAAS,MAAMd,EAAUC,GAAKC,CAAO,GAAG;AAAA,EACtC,MAAM,CAACD,GAAK,GAAIY,EAAgB,QAAQ,CAAA,CAAG;AAAA,EAC3C,GAAGA;AACL,CAAC;"}

package/dist/esm/hooks/useInfiniteScroll/useInfiniteScroll.mjs

@@ -0,0 +1,34 @@
+import { useState as v, useRef as S, useEffect as k } from "react";
+import { useEvent as H } from "../useEvent/useEvent.mjs";
+import { useRefState as I } from "../useRefState/useRefState.mjs";
+import { isTarget as T } from "../../utils/helpers/isTarget.mjs";
+import { getElement as W } from "../../utils/helpers/getElement.mjs";
+const j = (...e) => {
+  const t = T(e[0]) ? e[0] : void 0, s = t ? e[1] : e[0], r = t ? e[2] : e[1], i = (r == null ? void 0 : r.direction) ?? "bottom", l = (r == null ? void 0 : r.distance) ?? 10, [c, f] = v(!1), n = I(), a = S(s);
+  a.current = s;
+  const u = H(async (o) => {
+    if (c) return;
+    const { clientHeight: g, scrollHeight: h, scrollTop: d, clientWidth: E, scrollWidth: L, scrollLeft: m } = o.target, R = h - (d + g), b = L - (m + E);
+    ({
+      bottom: R,
+      top: d,
+      right: b,
+      left: m
+    })[i] <= l && (f(!0), await a.current(o), f(!1));
+  });
+  return k(() => {
+    if (!t && !n.state) return;
+    const o = t ? W(t) : n.current;
+    if (o)
+      return o.addEventListener("scroll", u), () => {
+        o.removeEventListener("scroll", u);
+      };
+  }, [t, n.state, i, l]), t ? c : {
+    ref: n,
+    loading: c
+  };
+};
+export {
+  j as useInfiniteScroll
+};
+//# sourceMappingURL=useInfiniteScroll.mjs.map

package/dist/esm/hooks/useInfiniteScroll/useInfiniteScroll.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteScroll.mjs","sources":["../../../../src/hooks/useInfiniteScroll/useInfiniteScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useEvent } from '../useEvent/useEvent';\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use infinite scroll options type */\nexport interface UseInfiniteScrollOptions {\n  /** The direction to trigger the callback */\n  direction?: 'bottom' | 'left' | 'right' | 'top';\n  /** The distance in pixels to trigger the callback */\n  distance?: number;\n}\n\nexport interface UseInfiniteScroll {\n  (\n    target: HookTarget,\n    callback: (event: Event) => void,\n    options?: UseInfiniteScrollOptions\n  ): boolean;\n\n  <Target extends Element>(\n    callback: (event: Event) => void,\n    options?: UseInfiniteScrollOptions,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    loading: boolean;\n  };\n}\n\n/**\n * @name useInfiniteScroll\n * @description - Hook that defines the logic for infinite scroll\n * @category Sensors\n *\n * @overload\n * @template Target The target element\n * @param {(event: Event) => void} callback The callback to execute when a click outside the target is detected\n * @param {number} [options.distance=10] The distance in pixels to trigger the callback\n * @param {string} [options.direction='bottom'] The direction to trigger the callback\n * @returns {{ ref: StateRef<Target>, loading: boolean }} An object containing the ref and loading\n *\n * @example\n * const { ref, loading } = useInfiniteScroll(() => console.log('infinite scroll'));\n *\n * @overload\n * @param {HookTarget} target The target element to detect infinite scroll for\n * @param {(event: Event) => void} callback The callback to execute when a click outside the target is detected\n * @param {number} [options.distance=10] The distance in pixels to trigger the callback\n * @param {string} [options.direction='bottom'] The direction to trigger the callback\n * @returns {boolean} A loading indicator of the infinite scroll\n *\n * @example\n * const loading = useInfiniteScroll(ref, () => console.log('infinite scroll'));\n */\nexport const useInfiniteScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const callback = (target ? params[1] : params[0]) as (event: Event) => void;\n  const options = (target ? params[2] : params[1]) as UseInfiniteScrollOptions | undefined;\n\n  const direction = options?.direction ?? 'bottom';\n  const distance = options?.distance ?? 10;\n\n  const [loading, setIsLoading] = useState(false);\n\n  const internalRef = useRefState<Element>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  const onLoadMore = useEvent(async (event: Event) => {\n    if (loading) return;\n    const { clientHeight, scrollHeight, scrollTop, clientWidth, scrollWidth, scrollLeft } =\n      event.target as Element;\n    const scrollBottom = scrollHeight - (scrollTop + clientHeight);\n    const scrollRight = scrollWidth - (scrollLeft + clientWidth);\n\n    const distances = {\n      bottom: scrollBottom,\n      top: scrollTop,\n      right: scrollRight,\n      left: scrollLeft\n    };\n\n    if (distances[direction] <= distance) {\n      setIsLoading(true);\n      await internalCallbackRef.current(event);\n      setIsLoading(false);\n    }\n  });\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    element.addEventListener('scroll', onLoadMore);\n\n    return () => {\n      element.removeEventListener('scroll', onLoadMore);\n    };\n  }, [target, internalRef.state, direction, distance]);\n\n  if (target) return loading;\n  return {\n    ref: internalRef,\n    loading\n  };\n}) as UseInfiniteScroll;\n"],"names":["useInfiniteScroll","params","target","isTarget","callback","options","direction","distance","loading","setIsLoading","useState","internalRef","useRefState","internalCallbackRef","useRef","onLoadMore","useEvent","event","clientHeight","scrollHeight","scrollTop","clientWidth","scrollWidth","scrollLeft","scrollBottom","scrollRight","useEffect","element","getElement"],"mappings":";;;;;AA6Da,MAAAA,IAAqB,IAAIC,MAAkB;AAChD,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAYF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACzCI,IAAWH,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCK,KAAYD,KAAA,gBAAAA,EAAS,cAAa,UAClCE,KAAWF,KAAA,gBAAAA,EAAS,aAAY,IAEhC,CAACG,GAASC,CAAY,IAAIC,EAAS,EAAK,GAExCC,IAAcC,EAAqB,GACnCC,IAAsBC,EAAOV,CAAQ;AAC3C,EAAAS,EAAoB,UAAUT;AAExB,QAAAW,IAAaC,EAAS,OAAOC,MAAiB;AAClD,QAAIT,EAAS;AACP,UAAA,EAAE,cAAAU,GAAc,cAAAC,GAAc,WAAAC,GAAW,aAAAC,GAAa,aAAAC,GAAa,YAAAC,MACvEN,EAAM,QACFO,IAAeL,KAAgBC,IAAYF,IAC3CO,IAAcH,KAAeC,IAAaF;AAS5C,KAPc;AAAA,MAChB,QAAQG;AAAA,MACR,KAAKJ;AAAA,MACL,OAAOK;AAAA,MACP,MAAMF;AAAA,IACR,GAEcjB,CAAS,KAAKC,MAC1BE,EAAa,EAAI,GACX,MAAAI,EAAoB,QAAQI,CAAK,GACvCR,EAAa,EAAK;AAAA,EACpB,CACD;AAcD,SAZAiB,EAAU,MAAM;AACd,QAAI,CAACxB,KAAU,CAACS,EAAY,MAAO;AACnC,UAAMgB,IAAWzB,IAAS0B,EAAW1B,CAAM,IAAIS,EAAY;AAC3D,QAAKgB;AAEG,aAAAA,EAAA,iBAAiB,UAAUZ,CAAU,GAEtC,MAAM;AACH,QAAAY,EAAA,oBAAoB,UAAUZ,CAAU;AAAA,MAClD;AAAA,EAAA,GACC,CAACb,GAAQS,EAAY,OAAOL,GAAWC,CAAQ,CAAC,GAE/CL,IAAeM,IACZ;AAAA,IACL,KAAKG;AAAA,IACL,SAAAH;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useIntersectionObserver/useIntersectionObserver.mjs

@@ -0,0 +1,33 @@
+import { useState as d, useRef as l, useEffect as v } from "react";
+import { useRefState as a } from "../useRefState/useRefState.mjs";
+import { isTarget as I } from "../../utils/helpers/isTarget.mjs";
+import { getElement as g } from "../../utils/helpers/getElement.mjs";
+const S = (...n) => {
+  const t = I(n[0]) ? n[0] : void 0, e = t ? n[1] : n[0], s = (e == null ? void 0 : e.enabled) ?? !0, [r, b] = d(), c = a(), u = l(e == null ? void 0 : e.onChange);
+  return u.current = e == null ? void 0 : e.onChange, v(() => {
+    if (!s && !t && !c.state) return;
+    const f = t ? g(t) : c.current;
+    if (!f) return;
+    const o = new IntersectionObserver(
+      ([i]) => {
+        var m;
+        b(i), (m = u.current) == null || m.call(u, i);
+      },
+      {
+        ...e,
+        root: e != null && e.root ? g(e.root) : document
+      }
+    );
+    return o.observe(f), () => {
+      o.disconnect();
+    };
+  }, [t, c.state, e == null ? void 0 : e.rootMargin, e == null ? void 0 : e.threshold, e == null ? void 0 : e.root, s]), t ? { entry: r, inView: !!(r != null && r.isIntersecting) } : {
+    ref: c,
+    entry: r,
+    inView: !!(r != null && r.isIntersecting)
+  };
+};
+export {
+  S as useIntersectionObserver
+};
+//# sourceMappingURL=useIntersectionObserver.mjs.map

package/dist/esm/hooks/useIntersectionObserver/useIntersectionObserver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIntersectionObserver.mjs","sources":["../../../../src/hooks/useIntersectionObserver/useIntersectionObserver.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The intersection observer options type */\nexport interface UseIntersectionObserverOptions extends Omit<IntersectionObserverInit, 'root'> {\n  enabled?: boolean;\n  root?: HookTarget;\n  onChange?: (entry: IntersectionObserverEntry) => void;\n}\n\n/** The intersection observer return type */\nexport interface UseIntersectionObserverReturn {\n  entry?: IntersectionObserverEntry;\n  inView: boolean;\n}\n\nexport interface UseIntersectionObserver {\n  <Target extends Element>(\n    options?: UseIntersectionObserverOptions,\n    target?: never\n  ): UseIntersectionObserverReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, options?: UseIntersectionObserverOptions): UseIntersectionObserverReturn;\n}\n\n/**\n * @name useIntersectionObserver\n * @description - Hook that gives you intersection observer state\n * @category Browser\n *\n * @overload\n * @param {HookTarget} target The target element to detect intersection\n * @param {boolean} [options.enabled=true] The IntersectionObserver options\n * @param {((entries: IntersectionObserverEntry[], observer: IntersectionObserver) => void) | undefined} [options.onChange] The callback to execute when intersection is detected\n * @param {HookTarget} [options.root] The root element to observe\n * @returns {UseIntersectionObserverReturn} An object containing the state and the supported status\n *\n * @example\n * const { ref, entry, inView } = useIntersectionObserver();\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The IntersectionObserver options\n * @param {((entries: IntersectionObserverEntry[], observer: IntersectionObserver) => void) | undefined} [options.onChange] The callback to execute when intersection is detected\n * @param {HookTarget} [options.root] The root element to observe\n * @returns {UseIntersectionObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { entry, inView } = useIntersectionObserver(ref);\n */\nexport const useIntersectionObserver = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseIntersectionObserverOptions | undefined;\n  const enabled = options?.enabled ?? true;\n\n  const [entry, setEntry] = useState<IntersectionObserverEntry>();\n\n  const internalRef = useRefState<Element>();\n  const internalOnChangeRef = useRef<UseIntersectionObserverOptions['onChange']>(options?.onChange);\n  internalOnChangeRef.current = options?.onChange;\n\n  useEffect(() => {\n    if (!enabled && !target && !internalRef.state) return;\n\n    const element = target ? getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const observer = new IntersectionObserver(\n      ([entry]) => {\n        setEntry(entry);\n        internalOnChangeRef.current?.(entry);\n      },\n      {\n        ...options,\n        root: options?.root ? (getElement(options.root) as Document | Element) : document\n      }\n    );\n\n    observer.observe(element as Element);\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [target, internalRef.state, options?.rootMargin, options?.threshold, options?.root, enabled]);\n\n  if (target) return { entry, inView: !!entry?.isIntersecting };\n  return {\n    ref: internalRef,\n    entry,\n    inView: !!entry?.isIntersecting\n  };\n}) as UseIntersectionObserver;\n"],"names":["useIntersectionObserver","params","target","isTarget","options","enabled","entry","setEntry","useState","internalRef","useRefState","internalOnChangeRef","useRef","useEffect","element","getElement","observer","_a"],"mappings":";;;;AAyDa,MAAAA,IAA2B,IAAIC,MAAkB;AACtD,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,KAAUD,KAAA,gBAAAA,EAAS,YAAW,IAE9B,CAACE,GAAOC,CAAQ,IAAIC,EAAoC,GAExDC,IAAcC,EAAqB,GACnCC,IAAsBC,EAAmDR,KAAA,gBAAAA,EAAS,QAAQ;AA2B5F,SA1BJO,EAAoB,UAAUP,KAAA,gBAAAA,EAAS,UAEvCS,EAAU,MAAM;AACd,QAAI,CAACR,KAAW,CAACH,KAAU,CAACO,EAAY,MAAO;AAE/C,UAAMK,IAAUZ,IAASa,EAAWb,CAAM,IAAIO,EAAY;AAC1D,QAAI,CAACK,EAAS;AAEd,UAAME,IAAW,IAAI;AAAA,MACnB,CAAC,CAACV,CAAK,MAAM;;AACX,QAAAC,EAASD,CAAK,IACdW,IAAAN,EAAoB,YAApB,QAAAM,EAAA,KAAAN,GAA8BL;AAAAA,MAChC;AAAA,MACA;AAAA,QACE,GAAGF;AAAA,QACH,MAAMA,KAAA,QAAAA,EAAS,OAAQW,EAAWX,EAAQ,IAAI,IAA2B;AAAA,MAAA;AAAA,IAE7E;AAEA,WAAAY,EAAS,QAAQF,CAAkB,GAE5B,MAAM;AACX,MAAAE,EAAS,WAAW;AAAA,IACtB;AAAA,EACC,GAAA,CAACd,GAAQO,EAAY,OAAOL,KAAA,gBAAAA,EAAS,YAAYA,KAAA,gBAAAA,EAAS,WAAWA,KAAA,gBAAAA,EAAS,MAAMC,CAAO,CAAC,GAE3FH,IAAe,EAAE,OAAAI,GAAO,QAAQ,CAAC,EAACA,KAAA,QAAAA,EAAO,gBAAe,IACrD;AAAA,IACL,KAAKG;AAAA,IACL,OAAAH;AAAA,IACA,QAAQ,CAAC,EAACA,KAAA,QAAAA,EAAO;AAAA,EACnB;AACF;"}

package/dist/esm/hooks/useInterval/useInterval.mjs

@@ -0,0 +1,21 @@
+import { useState as f, useRef as s, useEffect as v } from "react";
+const I = (...e) => {
+  const u = e[0], n = (typeof e[1] == "number" ? e[1] : e[1].interval) ?? 1e3, r = typeof e[1] == "object" ? e[1] : e[2], i = (r == null ? void 0 : r.immediately) ?? !0, [t, c] = f(i ?? !0), l = s(), o = s(u);
+  return o.current = u, v(() => {
+    if (t)
+      return l.current = setInterval(() => o.current(), n), () => {
+        clearInterval(l.current);
+      };
+  }, [t, n]), {
+    active: t,
+    pause: () => c(!1),
+    resume: () => {
+      n <= 0 || c(!0);
+    },
+    toggle: () => c(!t)
+  };
+};
+export {
+  I as useInterval
+};
+//# sourceMappingURL=useInterval.mjs.map

package/dist/esm/hooks/useInterval/useInterval.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.mjs","sources":["../../../../src/hooks/useInterval/useInterval.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** The use interval options */\nexport interface UseIntervalOptions {\n  /** Start the interval immediately */\n  immediately?: boolean;\n}\n\n/** The use interval return type */\nexport interface UseIntervalReturn {\n  /** Is the interval active */\n  active: boolean;\n  /** Pause the interval */\n  pause: () => void;\n  /** Resume the interval */\n  resume: () => void;\n  /** Toggle the interval */\n  toggle: () => void;\n}\n\ninterface UseInterval {\n  (callback: () => void, interval?: number, options?: UseIntervalOptions): UseIntervalReturn;\n\n  (callback: () => void, options?: UseIntervalOptions & { interval?: number }): UseIntervalReturn;\n}\n\n/**\n * @name useInterval\n * @description - Hook that makes and interval and returns controlling functions\n * @category Time\n *\n * @overload\n * @param {() => void} callback Any callback function\n * @param {number} [interval=1000] Time in milliseconds\n * @param {boolean} [options.immediately=true] Start the interval immediately\n * @returns {UseIntervalReturn}\n *\n * @example\n * const { active, pause, resume, toggle } = useInterval(() => console.log('inside interval'), 2500);\n *\n * @overload\n * @param {() => void} callback Any callback function\n * @param {number} [options.interval=1000] Time in milliseconds\n * @param {boolean} [options.immediately=true] Start the interval immediately\n *\n * @example\n * const { active, pause, resume, toggle } = useInterval(() => console.log('inside interval'), { interval: 2500 });\n */\nexport const useInterval = ((...params: any[]): UseIntervalReturn => {\n  const callback = params[0] as () => void;\n  const interval =\n    ((typeof params[1] === 'number'\n      ? params[1]\n      : (params[1] as UseIntervalOptions & { interval?: number }).interval) as number) ?? 1000;\n  const options =\n    typeof params[1] === 'object'\n      ? (params[1] as (UseIntervalOptions & { interval?: number }) | undefined)\n      : (params[2] as UseIntervalOptions | undefined);\n  const immediately = options?.immediately ?? true;\n\n  const [active, setActive] = useState<boolean>(immediately ?? true);\n\n  const intervalIdRef = useRef<ReturnType<typeof setInterval>>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(() => {\n    if (!active) return;\n\n    intervalIdRef.current = setInterval(() => internalCallbackRef.current(), interval);\n    return () => {\n      clearInterval(intervalIdRef.current);\n    };\n  }, [active, interval]);\n\n  const pause = () => setActive(false);\n\n  const resume = () => {\n    if (interval <= 0) return;\n    setActive(true);\n  };\n\n  const toggle = () => setActive(!active);\n\n  return {\n    active,\n    pause,\n    resume,\n    toggle\n  };\n}) as UseInterval;\n"],"names":["useInterval","params","callback","interval","options","immediately","active","setActive","useState","intervalIdRef","useRef","internalCallbackRef","useEffect"],"mappings":";AAgDa,MAAAA,IAAe,IAAIC,MAAqC;AAC7D,QAAAC,IAAWD,EAAO,CAAC,GACnBE,KACF,OAAOF,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACPA,EAAO,CAAC,EAAiD,aAAwB,KAClFG,IACJ,OAAOH,EAAO,CAAC,KAAM,WAChBA,EAAO,CAAC,IACRA,EAAO,CAAC,GACTI,KAAcD,KAAA,gBAAAA,EAAS,gBAAe,IAEtC,CAACE,GAAQC,CAAS,IAAIC,EAAkBH,KAAe,EAAI,GAE3DI,IAAgBC,EAAuC,GACvDC,IAAsBD,EAAOR,CAAQ;AAC3C,SAAAS,EAAoB,UAAUT,GAE9BU,EAAU,MAAM;AACd,QAAKN;AAEL,aAAAG,EAAc,UAAU,YAAY,MAAME,EAAoB,WAAWR,CAAQ,GAC1E,MAAM;AACX,sBAAcM,EAAc,OAAO;AAAA,MACrC;AAAA,EAAA,GACC,CAACH,GAAQH,CAAQ,CAAC,GAWd;AAAA,IACL,QAAAG;AAAA,IACA,OAXY,MAAMC,EAAU,EAAK;AAAA,IAYjC,QAVa,MAAM;AACnB,MAAIJ,KAAY,KAChBI,EAAU,EAAI;AAAA,IAChB;AAAA,IAQE,QANa,MAAMA,EAAU,CAACD,CAAM;AAAA,EAOtC;AACF;"}

package/dist/esm/hooks/useIsFirstRender/useIsFirstRender.mjs

@@ -0,0 +1,9 @@
+import { useRef as e } from "react";
+const u = () => {
+  const r = e(!0);
+  return r.current === !0 ? (r.current = !1, !0) : r.current;
+};
+export {
+  u as useIsFirstRender
+};
+//# sourceMappingURL=useIsFirstRender.mjs.map

package/dist/esm/hooks/useIsFirstRender/useIsFirstRender.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsFirstRender.mjs","sources":["../../../../src/hooks/useIsFirstRender/useIsFirstRender.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/**\n * @name useIsFirstRender\n * @description - Hook that returns true if the component is first render\n * @category Lifecycle\n *\n * @returns {boolean} True if the component is first render\n *\n * @example\n * const isFirstRender = useIsFirstRender();\n */\nexport const useIsFirstRender = () => {\n  const renderRef = useRef(true);\n\n  if (renderRef.current === true) {\n    renderRef.current = false;\n    return true;\n  }\n\n  return renderRef.current;\n};\n"],"names":["useIsFirstRender","renderRef","useRef"],"mappings":";AAYO,MAAMA,IAAmB,MAAM;AAC9B,QAAAC,IAAYC,EAAO,EAAI;AAEzB,SAAAD,EAAU,YAAY,MACxBA,EAAU,UAAU,IACb,MAGFA,EAAU;AACnB;"}

package/dist/esm/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs

@@ -0,0 +1,6 @@
+import { useLayoutEffect as e, useEffect as o } from "react";
+const t = typeof window < "u" ? e : o;
+export {
+  t as useIsomorphicLayoutEffect
+};
+//# sourceMappingURL=useIsomorphicLayoutEffect.mjs.map

package/dist/esm/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicLayoutEffect.mjs","sources":["../../../../src/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.ts"],"sourcesContent":["import { useEffect, useLayoutEffect } from 'react';\n\n/**\n * @name useIsomorphicLayoutEffect\n * @description - Hook conditionally selects either `useLayoutEffect` or `useEffect` based on the environment\n * @category Lifecycle\n *\n * @example\n * useIsomorphicLayoutEffect(() => console.log('effect'), [])\n */\nexport const useIsomorphicLayoutEffect =\n  typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n"],"names":["useIsomorphicLayoutEffect","useLayoutEffect","useEffect"],"mappings":";AAUO,MAAMA,IACX,OAAO,SAAW,MAAcC,IAAkBC;"}

package/dist/esm/hooks/useKeyPress/useKeyPress.mjs

@@ -0,0 +1,30 @@
+import { useState as w, useRef as m, useEffect as a } from "react";
+import { useRefState as l } from "../useRefState/useRefState.mjs";
+import { isTarget as p } from "../../utils/helpers/isTarget.mjs";
+import { getElement as A } from "../../utils/helpers/getElement.mjs";
+const S = (...s) => {
+  const e = p(s[0]) ? s[0] : void 0, y = e ? s[1] : s[0], f = e ? s[2] : s[1], [d, k] = w(!1), c = l(window), t = m(y);
+  t.current = y;
+  const r = m(f);
+  return r.current = f, a(() => {
+    if (!e && !c.state) return;
+    const o = e ? A(e) : c.current;
+    if (!o) return;
+    const v = (i) => {
+      var u;
+      const n = i;
+      (Array.isArray(t.current) ? t.current.includes(n.key) : n.key === t.current) && (k(!0), (u = r.current) == null || u.call(r, !0, n));
+    }, E = (i) => {
+      var u;
+      const n = i;
+      (Array.isArray(t.current) ? t.current.includes(n.key) : n.key === t.current) && (k(!1), (u = r.current) == null || u.call(r, !1, n));
+    };
+    return o.addEventListener("keydown", v), o.addEventListener("keyup", E), () => {
+      o.removeEventListener("keydown", v), o.removeEventListener("keyup", E);
+    };
+  }, [e, c.state]), e ? d : { pressed: d, ref: c };
+};
+export {
+  S as useKeyPress
+};
+//# sourceMappingURL=useKeyPress.mjs.map

package/dist/esm/hooks/useKeyPress/useKeyPress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyPress.mjs","sources":["../../../../src/hooks/useKeyPress/useKeyPress.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The key or keys to listen for */\nexport type UseKeyPressKey = string | string[];\n\n/** The callback function to be invoked when key is pressed */\nexport type UseKeyPressCallback = (pressed: boolean, event: KeyboardEvent) => void;\n\nexport interface UseKeyPress {\n  (target: HookTarget | Window, key: UseKeyPressKey, callback?: UseKeyPressCallback): boolean;\n\n  <Target extends Element>(\n    key: UseKeyPressKey,\n    callback?: UseKeyPressCallback,\n    target?: never\n  ): { pressed: boolean; ref: StateRef<Target> };\n}\n\n/**\n * @name useKeyPress\n * @description - Hook that listens for key press events\n * @category Sensors\n *\n * @overload\n * @param {HookTarget} [target=window] The target to attach the event listeners to\n * @param {UseKeyPressKey} key The key or keys to listen for\n * @param {(pressed: boolean, event: KeyboardEvent) => void} [callback] Callback function invoked when key is pressed\n * @returns {boolean} The pressed state of the key\n *\n * @example\n * const isKeyPressed = useKeyPress('a', window);\n *\n * @overload\n * @template Target The target element type\n * @param {UseKeyPressKey} key The key or keys to listen for\n * @param {(pressed: boolean, event: KeyboardEvent) => void} [callback] Callback function invoked when key is pressed\n * @returns {{ pressed: boolean; ref: StateRef<Target> }} An object containing the pressed state and ref\n *\n * @example\n * const { pressed, ref } = useKeyPress('a');\n */\nexport const useKeyPress = ((...params: any[]) => {\n  const target = isTarget(params[0]) ? params[0] : undefined;\n  const key = (target ? params[1] : params[0]) as UseKeyPressKey;\n  const callback = (target ? params[2] : params[1]) as UseKeyPressCallback | undefined;\n\n  const [pressed, setPressed] = useState(false);\n  const internalRef = useRefState(window);\n\n  const keyRef = useRef(key);\n  keyRef.current = key;\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    const onKeyDown = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      if (\n        Array.isArray(keyRef.current)\n          ? keyRef.current.includes(keyboardEvent.key)\n          : keyboardEvent.key === keyRef.current\n      ) {\n        setPressed(true);\n        callbackRef.current?.(true, keyboardEvent);\n      }\n    };\n\n    const onKeyUp = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      if (\n        Array.isArray(keyRef.current)\n          ? keyRef.current.includes(keyboardEvent.key)\n          : keyboardEvent.key === keyRef.current\n      ) {\n        setPressed(false);\n        callbackRef.current?.(false, keyboardEvent);\n      }\n    };\n\n    element.addEventListener('keydown', onKeyDown);\n    element.addEventListener('keyup', onKeyUp);\n\n    return () => {\n      element.removeEventListener('keydown', onKeyDown);\n      element.removeEventListener('keyup', onKeyUp);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return pressed;\n  return { pressed, ref: internalRef };\n}) as UseKeyPress;\n"],"names":["useKeyPress","params","target","isTarget","key","callback","pressed","setPressed","useState","internalRef","useRefState","keyRef","useRef","callbackRef","useEffect","element","getElement","onKeyDown","event","keyboardEvent","_a","onKeyUp"],"mappings":";;;;AAiDa,MAAAA,IAAe,IAAIC,MAAkB;AAC1C,QAAAC,IAASC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC3CG,IAAOF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACpCI,IAAYH,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAEzC,CAACK,GAASC,CAAU,IAAIC,EAAS,EAAK,GACtCC,IAAcC,EAAY,MAAM,GAEhCC,IAASC,EAAOR,CAAG;AACzB,EAAAO,EAAO,UAAUP;AACX,QAAAS,IAAcD,EAAOP,CAAQ;AA0CnC,SAzCAQ,EAAY,UAAUR,GAEtBS,EAAU,MAAM;AACd,QAAI,CAACZ,KAAU,CAACO,EAAY,MAAO;AAEnC,UAAMM,IAAWb,IAASc,EAAWd,CAAM,IAAIO,EAAY;AAC3D,QAAI,CAACM,EAAS;AAER,UAAAE,IAAY,CAACC,MAAiB;;AAClC,YAAMC,IAAgBD;AACtB,OACE,MAAM,QAAQP,EAAO,OAAO,IACxBA,EAAO,QAAQ,SAASQ,EAAc,GAAG,IACzCA,EAAc,QAAQR,EAAO,aAEjCJ,EAAW,EAAI,IACHa,IAAAP,EAAA,YAAA,QAAAO,EAAA,KAAAP,GAAU,IAAMM;AAAA,IAEhC,GAEME,IAAU,CAACH,MAAiB;;AAChC,YAAMC,IAAgBD;AACtB,OACE,MAAM,QAAQP,EAAO,OAAO,IACxBA,EAAO,QAAQ,SAASQ,EAAc,GAAG,IACzCA,EAAc,QAAQR,EAAO,aAEjCJ,EAAW,EAAK,IACJa,IAAAP,EAAA,YAAA,QAAAO,EAAA,KAAAP,GAAU,IAAOM;AAAA,IAEjC;AAEQ,WAAAJ,EAAA,iBAAiB,WAAWE,CAAS,GACrCF,EAAA,iBAAiB,SAASM,CAAO,GAElC,MAAM;AACH,MAAAN,EAAA,oBAAoB,WAAWE,CAAS,GACxCF,EAAA,oBAAoB,SAASM,CAAO;AAAA,IAC9C;AAAA,EACC,GAAA,CAACnB,GAAQO,EAAY,KAAK,CAAC,GAE1BP,IAAeI,IACZ,EAAE,SAAAA,GAAS,KAAKG,EAAY;AACrC;"}

package/dist/esm/hooks/useKeyPressEvent/useKeyPressEvent.mjs

@@ -0,0 +1,31 @@
+import { useRef as k, useEffect as l } from "react";
+import { useRefState as o } from "../useRefState/useRefState.mjs";
+import { isTarget as E } from "../../utils/helpers/isTarget.mjs";
+import { getElement as w } from "../../utils/helpers/getElement.mjs";
+const K = (...r) => {
+  const t = E(r[0]) ? r[0] : void 0, f = t ? r[1] : r[0], s = t ? r[2] : r[1], e = t ? r[3] : r[2], c = o(window), n = k(f);
+  n.current = f;
+  const y = k(s);
+  if (y.current = s, l(() => {
+    const u = t ? w(t) : c.current;
+    if (!u) return;
+    const v = (i) => {
+      const d = i;
+      (Array.isArray(n.current) ? n.current : [n.current]).includes(d.key) && y.current(d);
+    };
+    return u.addEventListener("keydown", v, {
+      capture: e == null ? void 0 : e.capture,
+      passive: e == null ? void 0 : e.passive,
+      once: e == null ? void 0 : e.once
+    }), () => {
+      u.removeEventListener("keydown", v, {
+        capture: e == null ? void 0 : e.capture
+      });
+    };
+  }, [t, c.state, e == null ? void 0 : e.capture, e == null ? void 0 : e.passive, e == null ? void 0 : e.once]), !t)
+    return c;
+};
+export {
+  K as useKeyPressEvent
+};
+//# sourceMappingURL=useKeyPressEvent.mjs.map

package/dist/esm/hooks/useKeyPressEvent/useKeyPressEvent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyPressEvent.mjs","sources":["../../../../src/hooks/useKeyPressEvent/useKeyPressEvent.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The key or keys to listen for */\nexport type UseKeyPressEventKey = string | string[];\n\n/** The use key press event options type */\nexport interface UseKeyPressEventOptions {\n  /** Whether the event should be captured */\n  capture?: boolean;\n  /** Whether the event listener should only be triggered once */\n  once?: boolean;\n  /** Whether the event listener should be passive */\n  passive?: boolean;\n}\n\nexport interface UseKeyPressEvent {\n  (\n    target: HookTarget | Window,\n    key: UseKeyPressEventKey,\n    listener: (event: KeyboardEvent) => void,\n    options?: UseKeyPressEventOptions\n  ): void;\n\n  <Target extends Element>(\n    key: UseKeyPressEventKey,\n    listener: (event: KeyboardEvent) => void,\n    options?: UseKeyPressEventOptions,\n    target?: never\n  ): { ref: StateRef<Target> };\n}\n\n/**\n * @name useKeyPressEvent\n * @description - Hook that listens for key press events on specified targets\n * @category Sensors\n *\n * @overload\n * @param {UseKeyPressEventKey} key The key or array of keys to listen for.\n * @param {HookTarget | Window} target The target to attach the event listener to.\n * @param {(event: KeyboardEvent) => void} listener The callback function to be executed when the specified key or keys are pressed.\n * @param {UseKeyPressEventOptions} [options] The options for the event listener.\n * @returns {void}\n *\n * @example\n * useKeyPressEvent(ref, 'Enter', () => console.log('pressed'));\n *\n * @overload\n * @template Target extends Element\n * @param {UseKeyPressEventKey} key The key or array of keys to listen for.\n * @param {(event: KeyboardEvent) => void} listener The callback function to be executed when the specified key or keys are pressed.\n * @param {UseKeyPressEventOptions} [options] The options for the event listener.\n * @returns {{ ref: StateRef<Target> }} An object containing the ref\n *\n * @example\n * const ref = useKeyPressEvent('Enter', (event) => console.log('pressed'));\n */\nexport const useKeyPressEvent = ((...params: any[]) => {\n  const target = isTarget(params[0]) ? params[0] : undefined;\n  const key = (target ? params[1] : params[0]) as UseKeyPressEventKey;\n  const listener = (target ? params[2] : params[1]) as (event: KeyboardEvent) => void;\n  const options = (target ? params[3] : params[2]) as UseKeyPressEventOptions | undefined;\n\n  const internalRef = useRefState(window);\n\n  const keyRef = useRef(key);\n  keyRef.current = key;\n  const listenerRef = useRef(listener);\n  listenerRef.current = listener;\n\n  useEffect(() => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    const onKeyDown = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      const keys = Array.isArray(keyRef.current) ? keyRef.current : [keyRef.current];\n      if (keys.includes(keyboardEvent.key)) {\n        listenerRef.current(keyboardEvent);\n      }\n    };\n\n    element.addEventListener('keydown', onKeyDown, {\n      capture: options?.capture,\n      passive: options?.passive,\n      once: options?.once\n    });\n\n    return () => {\n      element.removeEventListener('keydown', onKeyDown, {\n        capture: options?.capture\n      });\n    };\n  }, [target, internalRef.state, options?.capture, options?.passive, options?.once]);\n\n  if (target) return;\n  return internalRef;\n}) as UseKeyPressEvent;\n"],"names":["useKeyPressEvent","params","target","isTarget","key","listener","options","internalRef","useRefState","keyRef","useRef","listenerRef","useEffect","element","getElement","onKeyDown","event","keyboardEvent"],"mappings":";;;;AAgEa,MAAAA,IAAoB,IAAIC,MAAkB;AAC/C,QAAAC,IAASC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC3CG,IAAOF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACpCI,IAAYH,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACzCK,IAAWJ,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCM,IAAcC,EAAY,MAAM,GAEhCC,IAASC,EAAON,CAAG;AACzB,EAAAK,EAAO,UAAUL;AACX,QAAAO,IAAcD,EAAOL,CAAQ;AA4BnC,MA3BAM,EAAY,UAAUN,GAEtBO,EAAU,MAAM;AACd,UAAMC,IAAWX,IAASY,EAAWZ,CAAM,IAAIK,EAAY;AAC3D,QAAI,CAACM,EAAS;AAER,UAAAE,IAAY,CAACC,MAAiB;AAClC,YAAMC,IAAgBD;AAEtB,OADa,MAAM,QAAQP,EAAO,OAAO,IAAIA,EAAO,UAAU,CAACA,EAAO,OAAO,GACpE,SAASQ,EAAc,GAAG,KACjCN,EAAY,QAAQM,CAAa;AAAA,IAErC;AAEQ,WAAAJ,EAAA,iBAAiB,WAAWE,GAAW;AAAA,MAC7C,SAAST,KAAA,gBAAAA,EAAS;AAAA,MAClB,SAASA,KAAA,gBAAAA,EAAS;AAAA,MAClB,MAAMA,KAAA,gBAAAA,EAAS;AAAA,IAAA,CAChB,GAEM,MAAM;AACH,MAAAO,EAAA,oBAAoB,WAAWE,GAAW;AAAA,QAChD,SAAST,KAAA,gBAAAA,EAAS;AAAA,MAAA,CACnB;AAAA,IACH;AAAA,EACF,GAAG,CAACJ,GAAQK,EAAY,OAAOD,KAAA,gBAAAA,EAAS,SAASA,KAAA,gBAAAA,EAAS,SAASA,KAAA,gBAAAA,EAAS,IAAI,CAAC,GAE7E,CAAAJ;AACG,WAAAK;AACT;"}

package/dist/esm/hooks/useKeyboard/useKeyboard.mjs

@@ -0,0 +1,27 @@
+import { useEffect as m } from "react";
+import { useRefState as y } from "../useRefState/useRefState.mjs";
+import { isTarget as i } from "../../utils/helpers/isTarget.mjs";
+import { getElement as s } from "../../utils/helpers/getElement.mjs";
+const k = (...o) => {
+  const t = i(o[0]) ? o[0] : void 0, e = t ? o[1] : o[0], f = y(window);
+  if (m(() => {
+    if (!t && !f.state) return;
+    const r = t ? s(t) : f.current;
+    if (!r) return;
+    const c = (u) => {
+      var n;
+      return (n = e == null ? void 0 : e.onKeyDown) == null ? void 0 : n.call(e, u);
+    }, d = (u) => {
+      var n;
+      return (n = e == null ? void 0 : e.onKeyUp) == null ? void 0 : n.call(e, u);
+    };
+    return r.addEventListener("keydown", c), r.addEventListener("keyup", d), () => {
+      r.removeEventListener("keydown", c), r.removeEventListener("keyup", d);
+    };
+  }, [t, f.state]), !t)
+    return f;
+};
+export {
+  k as useKeyboard
+};
+//# sourceMappingURL=useKeyboard.mjs.map

package/dist/esm/hooks/useKeyboard/useKeyboard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboard.mjs","sources":["../../../../src/hooks/useKeyboard/useKeyboard.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The keyboard event handler type */\nexport type KeyboardEventHandler = (event: KeyboardEvent) => void;\n\n/** The use keyboard options type */\nexport interface UseKeyboardOptions {\n  /** The callback function to be invoked on key down */\n  onKeyDown?: KeyboardEventHandler;\n  /** The callback function to be invoked on key up */\n  onKeyUp?: KeyboardEventHandler;\n}\n\nexport interface UseKeyboard {\n  (target: HookTarget | Window, options: UseKeyboardOptions): void;\n\n  <Target extends Element>(options: UseKeyboardOptions, target?: never): { ref: StateRef<Target> };\n}\n\n/**\n * @name useKeyboard\n * @description - Hook that helps to listen for keyboard events\n * @category Sensors\n *\n * @overload\n * @param {HookTarget | Window} target The target to attach the event listeners to\n * @param {UseKeyboardOptions} [options] The keyboard event options\n * @returns {void}\n *\n * @example\n * useKeyboard(ref, { onKeyDown: (event) => console.log('key down'), onKeyUp: (event) => console.log('key up') });\n *\n * @overload\n * @template Target The target element type\n * @param {UseKeyboardOptions} [options] The keyboard event options\n * @returns {{ ref: StateRef<Target> }} An object containing the ref\n *\n * @example\n * const ref = useKeyboard({ onKeyDown: (event) => console.log('key down'), onKeyUp: (event) => console.log('key up') });\n */\nexport const useKeyboard = ((...params: any[]) => {\n  const target = isTarget(params[0]) ? params[0] : undefined;\n  const options = (target ? params[1] : params[0]) as UseKeyboardOptions;\n\n  const internalRef = useRefState(window);\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    const onKeyDown = (event: Event) => options?.onKeyDown?.(event as KeyboardEvent);\n    const onKeyUp = (event: Event) => options?.onKeyUp?.(event as KeyboardEvent);\n\n    element.addEventListener('keydown', onKeyDown);\n    element.addEventListener('keyup', onKeyUp);\n\n    return () => {\n      element.removeEventListener('keydown', onKeyDown);\n      element.removeEventListener('keyup', onKeyUp);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return;\n  return internalRef;\n}) as UseKeyboard;\n"],"names":["useKeyboard","params","target","isTarget","options","internalRef","useRefState","useEffect","element","getElement","onKeyDown","event","_a","onKeyUp"],"mappings":";;;;AAgDa,MAAAA,IAAe,IAAIC,MAAkB;AAC1C,QAAAC,IAASC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC3CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCI,IAAcC,EAAY,MAAM;AAoBtC,MAlBAC,EAAU,MAAM;AACd,QAAI,CAACL,KAAU,CAACG,EAAY,MAAO;AAEnC,UAAMG,IAAWN,IAASO,EAAWP,CAAM,IAAIG,EAAY;AAC3D,QAAI,CAACG,EAAS;AAEd,UAAME,IAAY,CAACC,MAAiB;;AAAA,cAAAC,IAAAR,KAAA,gBAAAA,EAAS,cAAT,gBAAAQ,EAAA,KAAAR,GAAqBO;AAAA,OACnDE,IAAU,CAACF,MAAiB;;AAAA,cAAAC,IAAAR,KAAA,gBAAAA,EAAS,YAAT,gBAAAQ,EAAA,KAAAR,GAAmBO;AAAA;AAE7C,WAAAH,EAAA,iBAAiB,WAAWE,CAAS,GACrCF,EAAA,iBAAiB,SAASK,CAAO,GAElC,MAAM;AACH,MAAAL,EAAA,oBAAoB,WAAWE,CAAS,GACxCF,EAAA,oBAAoB,SAASK,CAAO;AAAA,IAC9C;AAAA,EACC,GAAA,CAACX,GAAQG,EAAY,KAAK,CAAC,GAE1B,CAAAH;AACG,WAAAG;AACT;"}

package/dist/esm/hooks/useKeysPressed/useKeysPressed.mjs

@@ -0,0 +1,27 @@
+import { useState as v, useEffect as E } from "react";
+import { useRefState as a } from "../useRefState/useRefState.mjs";
+import { isTarget as l } from "../../utils/helpers/isTarget.mjs";
+import { getElement as w } from "../../utils/helpers/getElement.mjs";
+const p = (...o) => {
+  const e = l(o[0]) ? o[0] : void 0, s = e ? o[1] : o[0], f = (s == null ? void 0 : s.enabled) ?? !0, [y, c] = v([]), d = a(window);
+  return E(() => {
+    if (!f) return;
+    c([]);
+    const t = e ? w(e) : d.current;
+    if (!t) return;
+    const m = (i) => {
+      const n = i;
+      c((r) => r.some(({ code: u }) => u === n.code) ? r : [...r, { key: n.key, code: n.code }]);
+    }, k = (i) => {
+      const n = i;
+      c((r) => r.filter(({ code: u }) => u !== n.code));
+    };
+    return t.addEventListener("keydown", m), t.addEventListener("keyup", k), () => {
+      t.removeEventListener("keydown", m), t.removeEventListener("keyup", k);
+    };
+  }, [f, d.state, e]), e ? y : { value: y, ref: d };
+};
+export {
+  p as useKeysPressed
+};
+//# sourceMappingURL=useKeysPressed.mjs.map

package/dist/esm/hooks/useKeysPressed/useKeysPressed.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeysPressed.mjs","sources":["../../../../src/hooks/useKeysPressed/useKeysPressed.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use keys pressed options type */\nexport interface UseKeysPressedOptions {\n  /** Enable or disable the event listeners */\n  enabled?: boolean;\n}\n\nexport interface UseKeysPressed {\n  (\n    target: HookTarget | Window,\n    options?: UseKeysPressedOptions\n  ): Array<{ key: string; code: string }>;\n\n  <Target extends Element>(\n    options?: UseKeysPressedOptions\n  ): {\n    value: Array<{ key: string; code: string }>;\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * Hook that tracks which keyboard keys are currently pressed\n *\n * @name useKeysPressed\n * @description Tracks all currently pressed keyboard keys and their codes\n * @category Sensors\n *\n * @overload\n * @param {HookTarget | Window} target DOM element or ref to attach keyboard listeners to\n * @param {UseKeysPressedOptions} [options.enabled=true] Enable or disable the event listeners\n * @returns {Array<{ key: string; code: string }>} Array of currently pressed keys with their key and code values\n *\n * @example\n * const pressedKeys = useKeysPressed(ref);\n *\n * @overload\n * @template Target - Type of the target DOM element\n * @param {UseKeysPressedOptions} [options] - Optional configuration options\n * @returns {{ keys: Array<{ key: string; code: string }>; ref: StateRef<Target> }} Object containing pressed keys array and ref to attach to a DOM element\n *\n * @example\n * const { value, ref } = useKeysPressed();\n */\nexport const useKeysPressed = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseKeysPressedOptions | undefined;\n\n  const enabled = options?.enabled ?? true;\n  const [value, setValue] = useState<{ key: string; code: string }[]>([]);\n  const internalRef = useRefState(window);\n\n  useEffect(() => {\n    if (!enabled) return;\n    setValue([]);\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    const onKeyDown = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      setValue((prevValue) => {\n        if (prevValue.some(({ code }) => code === keyboardEvent.code)) return prevValue;\n        return [...prevValue, { key: keyboardEvent.key, code: keyboardEvent.code }];\n      });\n    };\n\n    const onKeyUp = (event: Event) => {\n      const keyboardEvent = event as KeyboardEvent;\n      setValue((prevValue) => prevValue.filter(({ code }) => code !== keyboardEvent.code));\n    };\n\n    element.addEventListener('keydown', onKeyDown);\n    element.addEventListener('keyup', onKeyUp);\n\n    return () => {\n      element.removeEventListener('keydown', onKeyDown);\n      element.removeEventListener('keyup', onKeyUp);\n    };\n  }, [enabled, internalRef.state, target]);\n\n  if (target) return value;\n  return { value, ref: internalRef };\n}) as UseKeysPressed;\n"],"names":["useKeysPressed","params","target","isTarget","options","enabled","value","setValue","useState","internalRef","useRefState","useEffect","element","getElement","onKeyDown","event","keyboardEvent","prevValue","code","onKeyUp"],"mappings":";;;;AAqDa,MAAAA,IAAkB,IAAIC,MAAkB;AAC7C,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCI,KAAUD,KAAA,gBAAAA,EAAS,YAAW,IAC9B,CAACE,GAAOC,CAAQ,IAAIC,EAA0C,CAAA,CAAE,GAChEC,IAAcC,EAAY,MAAM;AA+BtC,SA7BAC,EAAU,MAAM;AACd,QAAI,CAACN,EAAS;AACd,IAAAE,EAAS,CAAA,CAAE;AAEX,UAAMK,IAAWV,IAASW,EAAWX,CAAM,IAAIO,EAAY;AAC3D,QAAI,CAACG,EAAS;AAER,UAAAE,IAAY,CAACC,MAAiB;AAClC,YAAMC,IAAgBD;AACtB,MAAAR,EAAS,CAACU,MACJA,EAAU,KAAK,CAAC,EAAE,MAAAC,EAAA,MAAWA,MAASF,EAAc,IAAI,IAAUC,IAC/D,CAAC,GAAGA,GAAW,EAAE,KAAKD,EAAc,KAAK,MAAMA,EAAc,MAAM,CAC3E;AAAA,IACH,GAEMG,IAAU,CAACJ,MAAiB;AAChC,YAAMC,IAAgBD;AACb,MAAAR,EAAA,CAACU,MAAcA,EAAU,OAAO,CAAC,EAAE,MAAAC,EAAA,MAAWA,MAASF,EAAc,IAAI,CAAC;AAAA,IACrF;AAEQ,WAAAJ,EAAA,iBAAiB,WAAWE,CAAS,GACrCF,EAAA,iBAAiB,SAASO,CAAO,GAElC,MAAM;AACH,MAAAP,EAAA,oBAAoB,WAAWE,CAAS,GACxCF,EAAA,oBAAoB,SAASO,CAAO;AAAA,IAC9C;AAAA,KACC,CAACd,GAASI,EAAY,OAAOP,CAAM,CAAC,GAEnCA,IAAeI,IACZ,EAAE,OAAAA,GAAO,KAAKG,EAAY;AACnC;"}

package/dist/esm/hooks/useLastChanged/useLastChanged.mjs

@@ -0,0 +1,10 @@
+import { useState as u } from "react";
+import { useDidUpdate as d } from "../useDidUpdate/useDidUpdate.mjs";
+const s = (a, e) => {
+  const [t, r] = u((e == null ? void 0 : e.initialValue) ?? null);
+  return d(() => r(Date.now()), [a]), t;
+};
+export {
+  s as useLastChanged
+};
+//# sourceMappingURL=useLastChanged.mjs.map

package/dist/esm/hooks/useLastChanged/useLastChanged.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLastChanged.mjs","sources":["../../../../src/hooks/useLastChanged/useLastChanged.ts"],"sourcesContent":["import { useState } from 'react';\n\nimport { useDidUpdate } from '../useDidUpdate/useDidUpdate';\n\n/** The use last changed options type  */\nexport interface UseLastChangedOptions {\n  initialValue?: number;\n}\n\n/**\n * @name useLastChanged\n * @description - Hook for records the timestamp of the last change\n * @category Time\n *\n * @param {any} source  The source of the last change\n * @param {number | null} [options.initialValue=null] The initial value\n * @returns {number | null} Return timestamp of the last change\n *\n * @example\n * const lastChanged = useLastChanged(source);\n */\nexport const useLastChanged = (source: any, options?: UseLastChangedOptions): number | null => {\n  const [lastChanged, setLastChanged] = useState(options?.initialValue ?? null);\n\n  useDidUpdate(() => setLastChanged(Date.now()), [source]);\n\n  return lastChanged;\n};\n"],"names":["useLastChanged","source","options","lastChanged","setLastChanged","useState","useDidUpdate"],"mappings":";;AAqBa,MAAAA,IAAiB,CAACC,GAAaC,MAAmD;AAC7F,QAAM,CAACC,GAAaC,CAAc,IAAIC,GAASH,KAAA,gBAAAA,EAAS,iBAAgB,IAAI;AAE/D,SAAAI,EAAA,MAAMF,EAAe,KAAK,IAAA,CAAK,GAAG,CAACH,CAAM,CAAC,GAEhDE;AACT;"}

package/dist/esm/hooks/useLatest/useLatest.mjs

@@ -0,0 +1,9 @@
+import { useRef as t } from "react";
+const o = (e) => {
+  const r = t(e);
+  return r.current = e, r.current;
+};
+export {
+  o as useLatest
+};
+//# sourceMappingURL=useLatest.mjs.map

package/dist/esm/hooks/useLatest/useLatest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLatest.mjs","sources":["../../../../src/hooks/useLatest/useLatest.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/**\n * @name useLatest\n * @description - Hook that returns the stable reference of the value\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value} value The value to get the previous value\n * @returns {Value} The previous value\n *\n * @example\n * const latestValue = useLatest(value);\n */\nexport const useLatest = <Value>(value: Value) => {\n  const valueRef = useRef<Value>(value);\n  valueRef.current = value;\n  return valueRef.current;\n};\n"],"names":["useLatest","value","valueRef","useRef"],"mappings":";AAca,MAAAA,IAAY,CAAQC,MAAiB;AAC1C,QAAAC,IAAWC,EAAcF,CAAK;AACpC,SAAAC,EAAS,UAAUD,GACZC,EAAS;AAClB;"}

package/dist/esm/hooks/useLess/useLess.mjs

@@ -0,0 +1,8 @@
+import { useEffect as o } from "react";
+const t = (e) => (o(() => {
+  console.warn("Warning: You forgot to delete the 'useLess' hook.");
+}, []), e);
+export {
+  t as useLess
+};
+//# sourceMappingURL=useLess.mjs.map

package/dist/esm/hooks/useLess/useLess.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLess.mjs","sources":["../../../../src/hooks/useLess/useLess.ts"],"sourcesContent":["import { useEffect } from 'react';\n\n/**\n * @name useLess\n * @description - Hook that can be so useless\n * @category Humor\n *\n * @warning - This hook is a joke. Please do not use it in production code!\n *\n * @template Value The type of the value\n * @param {Value} [value] The value to be returned\n * @returns {Value} The value passed to the hook\n *\n * @example\n * const value = useLess(state);\n */\nexport const useLess = <Value>(value?: Value) => {\n  useEffect(() => {\n    console.warn(\"Warning: You forgot to delete the 'useLess' hook.\");\n  }, []);\n\n  return value;\n};\n"],"names":["useLess","value","useEffect"],"mappings":";AAgBa,MAAAA,IAAU,CAAQC,OAC7BC,EAAU,MAAM;AACd,UAAQ,KAAK,mDAAmD;AAClE,GAAG,EAAE,GAEED;"}

package/dist/esm/hooks/useList/useList.mjs

@@ -0,0 +1,14 @@
+import { useState as a } from "react";
+const v = (o = []) => {
+  const [r, e] = a(o);
+  return { value: r, set: e, push: (t) => e((s) => [...s, t]), removeAt: (t) => e((s) => [
+    ...s.slice(0, t),
+    ...s.slice(t + 1)
+  ]), insertAt: (t, s) => e((c) => [...c.slice(0, t), s, ...c.slice(t)]), updateAt: (t, s) => e(
+    (c) => c.map((u, n) => n === t ? s : u)
+  ), clear: () => e([]), reset: () => e(o) };
+};
+export {
+  v as useList
+};
+//# sourceMappingURL=useList.mjs.map

package/dist/esm/hooks/useList/useList.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useList.mjs","sources":["../../../../src/hooks/useList/useList.ts"],"sourcesContent":["import { useState } from 'react';\n\n/** The use list return type */\nexport interface UseListReturn<Item> {\n  /** The current list of items */\n  value: Item[];\n  /** Clears the list */\n  clear: () => void;\n  /** Inserts an item at the specified index */\n  insertAt: (insertAtIndex: number, item: Item) => void;\n  /** Adds an item to the list */\n  push: (item: Item) => void;\n  /** Removes an item from the list */\n  removeAt: (removeAtIndex: number) => void;\n  /** Sets the list of items */\n  set: (list: Item[]) => void;\n  /** Updates an item at the specified index */\n  updateAt: (updateAtIndex: number, item: Item) => void;\n}\n\n/**\n * @name useList\n * @description - Hook that provides state and helper methods to manage a list of items\n * @category Utilities\n *\n * @template Item The type of the item\n * @param {Item[] | (() => Item[])} initialList The initial list of items\n * @returns {UseListReturn} An object containing the current list and functions to interact with the list\n *\n * @example\n * const { value, set, push, removeAt, insertAt, updateAt, clear } = useList();\n */\nexport const useList = <Item>(initialList: Item[] = []) => {\n  const [list, setList] = useState(initialList);\n\n  const push = (item: Item) => setList((prevList) => [...prevList, item]);\n\n  const removeAt = (removeAtIndex: number) =>\n    setList((prevList) => [\n      ...prevList.slice(0, removeAtIndex),\n      ...prevList.slice(removeAtIndex + 1)\n    ]);\n\n  const insertAt = (insertAtIndex: number, item: Item) =>\n    setList((l) => [...l.slice(0, insertAtIndex), item, ...l.slice(insertAtIndex)]);\n\n  const updateAt = (updateAtIndex: number, item: Item) =>\n    setList((prevList) =>\n      prevList.map((element, index) => (index === updateAtIndex ? item : element))\n    );\n\n  const clear = () => setList([]);\n\n  const reset = () => setList(initialList);\n\n  return { value: list, set: setList, push, removeAt, insertAt, updateAt, clear, reset };\n};\n"],"names":["useList","initialList","list","setList","useState","item","prevList","removeAtIndex","insertAtIndex","l","updateAtIndex","element","index"],"mappings":";AAgCO,MAAMA,IAAU,CAAOC,IAAsB,OAAO;AACzD,QAAM,CAACC,GAAMC,CAAO,IAAIC,EAASH,CAAW;AAsBrC,SAAA,EAAE,OAAOC,GAAM,KAAKC,GAAS,MApBvB,CAACE,MAAeF,EAAQ,CAACG,MAAa,CAAC,GAAGA,GAAUD,CAAI,CAAC,GAoB5B,UAlBzB,CAACE,MAChBJ,EAAQ,CAACG,MAAa;AAAA,IACpB,GAAGA,EAAS,MAAM,GAAGC,CAAa;AAAA,IAClC,GAAGD,EAAS,MAAMC,IAAgB,CAAC;AAAA,EAAA,CACpC,GAciD,UAZnC,CAACC,GAAuBH,MACvCF,EAAQ,CAACM,MAAM,CAAC,GAAGA,EAAE,MAAM,GAAGD,CAAa,GAAGH,GAAM,GAAGI,EAAE,MAAMD,CAAa,CAAC,CAAC,GAWlB,UAT7C,CAACE,GAAuBL,MACvCF;AAAA,IAAQ,CAACG,MACPA,EAAS,IAAI,CAACK,GAASC,MAAWA,MAAUF,IAAgBL,IAAOM,CAAQ;AAAA,EAC7E,GAMsE,OAJ1D,MAAMR,EAAQ,EAAE,GAIiD,OAFjE,MAAMA,EAAQF,CAAW,EAE8C;AACvF;"}

package/dist/esm/hooks/useLocalStorage/useLocalStorage.mjs

@@ -0,0 +1,10 @@
+import { useStorage as r } from "../useStorage/useStorage.mjs";
+const d = (o, e, t) => r(o, {
+  ...t,
+  initialValue: e,
+  storage: typeof window < "u" ? window.localStorage : void 0
+});
+export {
+  d as useLocalStorage
+};
+//# sourceMappingURL=useLocalStorage.mjs.map

package/dist/esm/hooks/useLocalStorage/useLocalStorage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.mjs","sources":["../../../../src/hooks/useLocalStorage/useLocalStorage.ts"],"sourcesContent":["import type { UseStorageInitialValue, UseStorageOptions } from '../useStorage/useStorage';\n\nimport { useStorage } from '../useStorage/useStorage';\n\n/**\n * @name useLocalStorage\n * @description - Hook that manages local storage value\n * @category Browser\n *\n * @browserapi localStorage https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage\n *\n * @template Value The type of the value\n * @param {string} key The key of the storage\n * @param {UseStorageInitialValue<Value>} [initialValue] The initial value of the storage\n * @param {UseStorageOptions<Value>} [options] The options of the storage\n *\n * @example\n * const { value, set, remove } = useLocalStorage('key', 'value');\n */\nexport const useLocalStorage = <Value>(\n  key: string,\n  initialValue?: UseStorageInitialValue<Value>,\n  options?: Omit<UseStorageOptions<Value>, 'initialValue' | 'storage'>\n) =>\n  useStorage(key, {\n    ...options,\n    initialValue,\n    storage: typeof window !== 'undefined' ? window.localStorage : undefined\n  });\n"],"names":["useLocalStorage","key","initialValue","options","useStorage"],"mappings":";AAmBO,MAAMA,IAAkB,CAC7BC,GACAC,GACAC,MAEAC,EAAWH,GAAK;AAAA,EACd,GAAGE;AAAA,EACH,cAAAD;AAAA,EACA,SAAS,OAAO,SAAW,MAAc,OAAO,eAAe;AACjE,CAAC;"}

package/dist/esm/hooks/useLockCallback/useLockCallback.mjs

@@ -0,0 +1,18 @@
+import { useRef as n } from "react";
+const a = (e) => {
+  const r = n(!1), t = n(e);
+  return t.current = e, async (...c) => {
+    if (!r.current) {
+      r.current = !0;
+      try {
+        return await t.current(...c);
+      } finally {
+        r.current = !1;
+      }
+    }
+  };
+};
+export {
+  a as useLockCallback
+};
+//# sourceMappingURL=useLockCallback.mjs.map

package/dist/esm/hooks/useLockCallback/useLockCallback.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLockCallback.mjs","sources":["../../../../src/hooks/useLockCallback/useLockCallback.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/**\n * @name useLockCallback\n * @description - Hook that prevents a callback from being executed multiple times simultaneously\n * @category Utilities\n *\n * @param {Function} callback The callback to be locked\n * @returns {Function} The locked callback\n *\n * @example\n * const lockedCallback = useLockCallback(() => promise());\n */\nexport const useLockCallback = <Callback extends (...args: any[]) => any>(callback: Callback) => {\n  const lockRef = useRef(false);\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  return async (...args: Parameters<Callback>) => {\n    if (lockRef.current) return;\n    lockRef.current = true;\n\n    try {\n      return await callbackRef.current(...args);\n    } finally {\n      lockRef.current = false;\n    }\n  };\n};\n"],"names":["useLockCallback","callback","lockRef","useRef","callbackRef","args"],"mappings":";AAaa,MAAAA,IAAkB,CAA2CC,MAAuB;AACzF,QAAAC,IAAUC,EAAO,EAAK,GACtBC,IAAcD,EAAOF,CAAQ;AACnC,SAAAG,EAAY,UAAUH,GAEf,UAAUI,MAA+B;AAC9C,QAAI,CAAAH,EAAQ,SACZ;AAAA,MAAAA,EAAQ,UAAU;AAEd,UAAA;AACF,eAAO,MAAME,EAAY,QAAQ,GAAGC,CAAI;AAAA,MAAA,UACxC;AACA,QAAAH,EAAQ,UAAU;AAAA,MAAA;AAAA;AAAA,EAEtB;AACF;"}

package/dist/esm/hooks/useLogger/useLogger.mjs

@@ -0,0 +1,11 @@
+import { useEffect as t } from "react";
+import { useDidUpdate as u } from "../useDidUpdate/useDidUpdate.mjs";
+const n = (o, e) => {
+  t(() => (console.log(`${o} mounted`, ...e), () => console.log(`${o} unmounted`)), []), u(() => {
+    console.log(`${o} updated`, ...e);
+  }, e);
+};
+export {
+  n as useLogger
+};
+//# sourceMappingURL=useLogger.mjs.map

package/dist/esm/hooks/useLogger/useLogger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.mjs","sources":["../../../../src/hooks/useLogger/useLogger.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nimport { useDidUpdate } from '../useDidUpdate/useDidUpdate';\n\n/**\n * @name useLogger\n * @description - Hook for debugging lifecycle\n * @category Lifecycle\n *\n * @param {string} name The name or identifier for the logger\n * @param {unknown[]} params Additional arguments to be logged\n *\n * @example\n * useLogger('Component', [1, 2, 3]);\n */\nexport const useLogger = (name: string, params: unknown[]) => {\n  useEffect(() => {\n    console.log(`${name} mounted`, ...params);\n    return () => console.log(`${name} unmounted`);\n  }, []);\n\n  useDidUpdate(() => {\n    console.log(`${name} updated`, ...params);\n  }, params);\n};\n"],"names":["useLogger","name","params","useEffect","useDidUpdate"],"mappings":";;AAea,MAAAA,IAAY,CAACC,GAAcC,MAAsB;AAC5D,EAAAC,EAAU,OACR,QAAQ,IAAI,GAAGF,CAAI,YAAY,GAAGC,CAAM,GACjC,MAAM,QAAQ,IAAI,GAAGD,CAAI,YAAY,IAC3C,EAAE,GAELG,EAAa,MAAM;AACjB,YAAQ,IAAI,GAAGH,CAAI,YAAY,GAAGC,CAAM;AAAA,KACvCA,CAAM;AACX;"}

package/dist/esm/hooks/useLongPress/useLongPress.mjs

@@ -0,0 +1,22 @@
+import { useState as E, useRef as m } from "react";
+const P = 400, s = (L, e) => {
+  const [f, l] = E(!1), u = m(), a = m(!1), T = (r) => {
+    var c;
+    (c = e == null ? void 0 : e.onStart) == null || c.call(e, r), a.current = !0, u.current = setTimeout(() => {
+      L(r), l(!0);
+    }, (e == null ? void 0 : e.threshold) ?? P);
+  }, d = (r) => {
+    var c, h;
+    f ? (c = e == null ? void 0 : e.onFinish) == null || c.call(e, r) : a.current && ((h = e == null ? void 0 : e.onCancel) == null || h.call(e, r)), l(!1), a.current = !1, u.current && clearTimeout(u.current);
+  };
+  return [{
+    onMouseDown: T,
+    onTouchStart: T,
+    onMouseUp: d,
+    onTouchEnd: d
+  }, f];
+};
+export {
+  s as useLongPress
+};
+//# sourceMappingURL=useLongPress.mjs.map