@siberiacancode/reactuse 0.2.11 → 0.2.13

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

@@ -1 +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;"}
+{"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":";;;;;AA6DO,MAAMA,IAAqB,IAAIC,MAAkB;AACtD,QAAMC,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,IAAYD,GAAS,aAAa,UAClCE,IAAWF,GAAS,YAAY,IAEhC,CAACG,GAASC,CAAY,IAAIC,EAAS,EAAK,GAExCC,IAAcC,EAAA,GACdC,IAAsBC,EAAOV,CAAQ;AAC3C,EAAAS,EAAoB,UAAUT;AAE9B,QAAMW,IAAaC,EAAS,OAAOC,MAAiB;AAClD,QAAIT,EAAS;AACb,UAAM,EAAE,cAAAU,GAAc,cAAAC,GAAc,WAAAC,GAAW,aAAAC,GAAa,aAAAC,GAAa,YAAAC,MACvEN,EAAM,QACFO,IAAeL,KAAgBC,IAAYF,IAC3CO,IAAcH,KAAeC,IAAaF;AAShD,KAPkB;AAAA,MAChB,QAAQG;AAAA,MACR,KAAKJ;AAAA,MACL,OAAOK;AAAA,MACP,MAAMF;AAAA,IAAA,GAGMjB,CAAS,KAAKC,MAC1BE,EAAa,EAAI,GACjB,MAAMI,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;AAEL,aAAAA,EAAQ,iBAAiB,UAAUZ,CAAU,GAEtC,MAAM;AACX,QAAAY,EAAQ,oBAAoB,UAAUZ,CAAU;AAAA,MAAA;AAAA,EAClD,GACC,CAACb,GAAQS,EAAY,OAAOL,GAAWC,CAAQ,CAAC,GAE/CL,IAAeM,IACZ;AAAA,IACL,KAAKG;AAAA,IACL,SAAAH;AAAA,EAAA;AAEJ;"}

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

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

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

@@ -1 +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 * @browserapi IntersectionObserver https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver\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\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":";;;;AA2Da,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;"}
+{"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 * @browserapi IntersectionObserver https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver\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\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"],"mappings":";;;;AA2DO,MAAMA,IAA2B,IAAIC,MAAkB;AAC5D,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,IAAUD,GAAS,WAAW,IAE9B,CAACE,GAAOC,CAAQ,IAAIC,EAAA,GAEpBC,IAAcC,EAAA,GACdC,IAAsBC,EAAmDR,GAAS,QAAQ;AA2BhG,SA1BAO,EAAoB,UAAUP,GAAS,UAEvCS,EAAU,MAAM;AACd,QAAI,CAACR,KAAY,CAACH,KAAU,CAACO,EAAY,MAAQ;AAEjD,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,GACdK,EAAoB,UAAUL,CAAK;AAAA,MAAA;AAAA,MAErC;AAAA,QACE,GAAGF;AAAA,QACH,MAAMA,GAAS,OAAQW,EAAWX,EAAQ,IAAI,IAA2B;AAAA,MAAA;AAAA,IAC3E;AAGF,WAAAY,EAAS,QAAQF,CAAkB,GAE5B,MAAM;AACX,MAAAE,EAAS,WAAA;AAAA,IAAW;AAAA,EACtB,GACC,CAACd,GAAQO,EAAY,OAAOL,GAAS,YAAYA,GAAS,WAAWA,GAAS,MAAMC,CAAO,CAAC,GAE3FH,IAAe,EAAE,OAAAI,GAAO,QAAQ,CAAC,CAACA,GAAO,eAAA,IACtC;AAAA,IACL,KAAKG;AAAA,IACL,OAAAH;AAAA,IACA,QAAQ,CAAC,CAACA,GAAO;AAAA,EAAA;AAErB;"}

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

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

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

@@ -1 +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>>(undefined);\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,MAAS,GAChEC,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;"}
+{"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>>(undefined);\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","immediately","active","setActive","useState","intervalIdRef","useRef","internalCallbackRef","useEffect"],"mappings":";AAgDO,MAAMA,IAAe,IAAIC,MAAqC;AACnE,QAAMC,IAAWD,EAAO,CAAC,GACnBE,KACF,OAAOF,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACPA,EAAO,CAAC,EAAiD,aAAwB,KAKlFG,KAHJ,OAAOH,EAAO,CAAC,KAAM,WAChBA,EAAO,CAAC,IACRA,EAAO,CAAC,IACc,eAAe,IAEtC,CAACI,GAAQC,CAAS,IAAIC,EAAkBH,KAAe,EAAI,GAE3DI,IAAgBC,EAAuC,MAAS,GAChEC,IAAsBD,EAAOP,CAAQ;AAC3C,SAAAQ,EAAoB,UAAUR,GAE9BS,EAAU,MAAM;AACd,QAAKN;AAEL,aAAAG,EAAc,UAAU,YAAY,MAAME,EAAoB,QAAA,GAAWP,CAAQ,GAC1E,MAAM;AACX,sBAAcK,EAAc,OAAO;AAAA,MAAA;AAAA,EACrC,GACC,CAACH,GAAQF,CAAQ,CAAC,GAWd;AAAA,IACL,QAAAE;AAAA,IACA,OAXY,MAAMC,EAAU,EAAK;AAAA,IAYjC,QAVa,MAAM;AACnB,MAAIH,KAAY,KAChBG,EAAU,EAAI;AAAA,IAAA;AAAA,IASd,QANa,MAAMA,EAAU,CAACD,CAAM;AAAA,EAMpC;AAEJ;"}

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

@@ -1 +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;"}
+{"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;AACpC,QAAMC,IAAYC,EAAO,EAAI;AAE7B,SAAID,EAAU,YAAY,MACxBA,EAAU,UAAU,IACb,MAGFA,EAAU;AACnB;"}

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

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

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

@@ -1 +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;"}
+{"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","onKeyUp"],"mappings":";;;;AAiDO,MAAMA,IAAe,IAAIC,MAAkB;AAChD,QAAMC,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;AACjB,QAAMS,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;AAEd,UAAME,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,GACfM,EAAY,UAAU,IAAMM,CAAa;AAAA,IAC3C,GAGIC,IAAU,CAACF,MAAiB;AAChC,YAAMC,IAAgBD;AACtB,OACE,MAAM,QAAQP,EAAO,OAAO,IACxBA,EAAO,QAAQ,SAASQ,EAAc,GAAG,IACzCA,EAAc,QAAQR,EAAO,aAEjCJ,EAAW,EAAK,GAChBM,EAAY,UAAU,IAAOM,CAAa;AAAA,IAC5C;AAGF,WAAAJ,EAAQ,iBAAiB,WAAWE,CAAS,GAC7CF,EAAQ,iBAAiB,SAASK,CAAO,GAElC,MAAM;AACX,MAAAL,EAAQ,oBAAoB,WAAWE,CAAS,GAChDF,EAAQ,oBAAoB,SAASK,CAAO;AAAA,IAAA;AAAA,EAC9C,GACC,CAAClB,GAAQO,EAAY,KAAK,CAAC,GAE1BP,IAAeI,IACZ,EAAE,SAAAA,GAAS,KAAKG,EAAA;AACzB;"}

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

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

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

@@ -1 +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;"}
+{"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":";;;;AAgEO,MAAMA,IAAoB,IAAIC,MAAkB;AACrD,QAAMC,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;AACjB,QAAMO,IAAcD,EAAOL,CAAQ;AA4BnC,MA3BAM,EAAY,UAAUN,GAEtBO,EAAU,MAAM;AACd,UAAMC,IAAWX,IAASY,EAAWZ,CAAM,IAAIK,EAAY;AAC3D,QAAI,CAACM,EAAS;AAEd,UAAME,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,IACnC;AAGF,WAAAJ,EAAQ,iBAAiB,WAAWE,GAAW;AAAA,MAC7C,SAAST,GAAS;AAAA,MAClB,SAASA,GAAS;AAAA,MAClB,MAAMA,GAAS;AAAA,IAAA,CAChB,GAEM,MAAM;AACX,MAAAO,EAAQ,oBAAoB,WAAWE,GAAW;AAAA,QAChD,SAAST,GAAS;AAAA,MAAA,CACnB;AAAA,IAAA;AAAA,EACH,GACC,CAACJ,GAAQK,EAAY,OAAOD,GAAS,SAASA,GAAS,SAASA,GAAS,IAAI,CAAC,GAE7E,CAAAJ;AACJ,WAAOK;AACT;"}

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

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

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

@@ -1 +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;"}
+{"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","onKeyUp"],"mappings":";;;;AAgDO,MAAMA,IAAe,IAAIC,MAAkB;AAChD,QAAMC,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,MAAiBP,GAAS,YAAYO,CAAsB,GACzEC,IAAU,CAACD,MAAiBP,GAAS,UAAUO,CAAsB;AAE3E,WAAAH,EAAQ,iBAAiB,WAAWE,CAAS,GAC7CF,EAAQ,iBAAiB,SAASI,CAAO,GAElC,MAAM;AACX,MAAAJ,EAAQ,oBAAoB,WAAWE,CAAS,GAChDF,EAAQ,oBAAoB,SAASI,CAAO;AAAA,IAAA;AAAA,EAC9C,GACC,CAACV,GAAQG,EAAY,KAAK,CAAC,GAE1B,CAAAH;AACJ,WAAOG;AACT;"}

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

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

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

@@ -1 +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;"}
+{"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","enabled","value","setValue","useState","internalRef","useRefState","useEffect","element","getElement","onKeyDown","event","keyboardEvent","prevValue","code","onKeyUp"],"mappings":";;;;AAqDO,MAAMA,IAAkB,IAAIC,MAAkB;AACnD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAG5CG,KAFWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,IAErB,WAAW,IAC9B,CAACI,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,IAAWT,IAASU,EAAWV,CAAM,IAAIM,EAAY;AAC3D,QAAI,CAACG,EAAS;AAEd,UAAME,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,IAAA,GAGGG,IAAU,CAACJ,MAAiB;AAChC,YAAMC,IAAgBD;AACtB,MAAAR,EAAS,CAACU,MAAcA,EAAU,OAAO,CAAC,EAAE,MAAAC,EAAA,MAAWA,MAASF,EAAc,IAAI,CAAC;AAAA,IAAA;AAGrF,WAAAJ,EAAQ,iBAAiB,WAAWE,CAAS,GAC7CF,EAAQ,iBAAiB,SAASO,CAAO,GAElC,MAAM;AACX,MAAAP,EAAQ,oBAAoB,WAAWE,CAAS,GAChDF,EAAQ,oBAAoB,SAASO,CAAO;AAAA,IAAA;AAAA,EAC9C,GACC,CAACd,GAASI,EAAY,OAAON,CAAM,CAAC,GAEnCA,IAAeG,IACZ,EAAE,OAAAA,GAAO,KAAKG,EAAA;AACvB;"}

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

@@ -1,10 +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;
+import { useState as s } from "react";
+import { useDidUpdate as o } from "../useDidUpdate/useDidUpdate.mjs";
+const u = (t, e) => {
+  const [a, n] = s(e?.initialValue ?? null);
+  return o(() => n(Date.now()), [t]), a;
 };
 export {
-  s as useLastChanged
+  u as useLastChanged
 };
 //# sourceMappingURL=useLastChanged.mjs.map

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

@@ -1 +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;"}
+{"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":";;AAqBO,MAAMA,IAAiB,CAACC,GAAaC,MAAmD;AAC7F,QAAM,CAACC,GAAaC,CAAc,IAAIC,EAASH,GAAS,gBAAgB,IAAI;AAE5E,SAAAI,EAAa,MAAMF,EAAe,KAAK,IAAA,CAAK,GAAG,CAACH,CAAM,CAAC,GAEhDE;AACT;"}

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

@@ -1,7 +1,15 @@
-import { useRef as t } from "react";
-const o = (e) => {
-  const r = t(e);
-  return r.current = e, r.current;
+import { useRef as t, useMemo as u } from "react";
+const o = (r) => {
+  const e = t(r);
+  return e.current = r, u(
+    () => ({
+      get value() {
+        return e.current;
+      },
+      ref: e
+    }),
+    []
+  );
 };
 export {
   o as useLatest

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

@@ -1 +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;"}
+{"version":3,"file":"useLatest.mjs","sources":["../../../../src/hooks/useLatest/useLatest.ts"],"sourcesContent":["import type { RefObject } from 'react';\n\nimport { useMemo, useRef } from 'react';\n\nexport interface UseLatestReturn<Value> {\n  ref: RefObject<Value>;\n  value: Value;\n}\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 {UseLatestReturn<Value>} The previous value\n *\n * @example\n * const latestValue = useLatest(value);\n */\nexport const useLatest = <Value>(value: Value): UseLatestReturn<Value> => {\n  const valueRef = useRef<Value>(value);\n  valueRef.current = value;\n  return useMemo(\n    () => ({\n      get value() {\n        return valueRef.current;\n      },\n      ref: valueRef\n    }),\n    []\n  );\n};\n"],"names":["useLatest","value","valueRef","useRef","useMemo"],"mappings":";AAqBO,MAAMA,IAAY,CAAQC,MAAyC;AACxE,QAAMC,IAAWC,EAAcF,CAAK;AACpC,SAAAC,EAAS,UAAUD,GACZG;AAAA,IACL,OAAO;AAAA,MACL,IAAI,QAAQ;AACV,eAAOF,EAAS;AAAA,MAAA;AAAA,MAElB,KAAKA;AAAA,IAAA;AAAA,IAEP,CAAA;AAAA,EAAC;AAEL;"}

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

@@ -1 +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;"}
+{"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":";AAgBO,MAAMA,IAAU,CAAQC,OAC7BC,EAAU,MAAM;AACd,UAAQ,KAAK,mDAAmD;AAAA,GAC/D,EAAE,GAEED;"}

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

@@ -1 +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;"}
+{"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;AAsB5C,SAAO,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,EAAA,GAOP,OAJ1D,MAAMR,EAAQ,EAAE,GAIiD,OAFjE,MAAMA,EAAQF,CAAW,EAEwC;AACjF;"}

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

@@ -1 +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;"}
+{"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":";AAaO,MAAMA,IAAkB,CAA2CC,MAAuB;AAC/F,QAAMC,IAAUC,EAAO,EAAK,GACtBC,IAAcD,EAAOF,CAAQ;AACnC,SAAAG,EAAY,UAAUH,GAEf,UAAUI,MAA+B;AAC9C,QAAI,CAAAH,EAAQ,SACZ;AAAA,MAAAA,EAAQ,UAAU;AAElB,UAAI;AACF,eAAO,MAAME,EAAY,QAAQ,GAAGC,CAAI;AAAA,MAAA,UAC1C;AACE,QAAAH,EAAQ,UAAU;AAAA,MAAA;AAAA;AAAA,EACpB;AAEJ;"}