@siberiacancode/reactuse 0.3.14 → 0.3.17

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 * @usage high\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 = (value = !active) => setActive(value);\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","value"],"mappings":";AAiDO,MAAMA,KAAe,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,CAACM,IAAQ,CAACP,MAAWC,EAAUM,CAAK;AAAA,EAMjD;AAEJ;"}
+{"version":3,"file":"useInterval.mjs","names":[],"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 * @usage high\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 = (value = !active) => setActive(value);\n\n  return {\n    active,\n    pause,\n    resume,\n    toggle\n  };\n}) as UseInterval;\n"],"mappings":";;AAiDA,IAAa,MAAgB,GAAG,MAAqC;CACnE,IAAM,IAAW,EAAO,IAClB,KACF,OAAO,EAAO,MAAO,WACnB,EAAO,KACN,EAAO,GAAkD,aAAwB,KAOlF,CAAC,GAAQ,KAAa,GAL1B,OAAO,EAAO,MAAO,WAChB,EAAO,KACP,EAAO,KACe,eAAe,MAEiB,GAAK,EAE5D,IAAgB,EAAuC,KAAA,EAAU,EACjE,IAAsB,EAAO,EAAS;AAqB5C,QApBA,EAAoB,UAAU,GAE9B,QAAgB;AACT,QAGL,QADA,EAAc,UAAU,kBAAkB,EAAoB,SAAS,EAAE,EAAS,QACrE;AACX,iBAAc,EAAc,QAAQ;;IAErC,CAAC,GAAQ,EAAS,CAAC,EAWf;EACL;EACA,aAXkB,EAAU,GAAM;EAYlC,cAVmB;AACf,QAAY,KAChB,EAAU,GAAK;;EASf,SANc,IAAQ,CAAC,MAAW,EAAU,EAAM;EAOnD"}

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

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

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 * @usage low\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":";AAaO,MAAMA,IAAmB,MAAM;AACpC,QAAMC,IAAYC,EAAO,EAAI;AAE7B,SAAID,EAAU,YAAY,MACxBA,EAAU,UAAU,IACb,MAGFA,EAAU;AACnB;"}
+{"version":3,"file":"useIsFirstRender.mjs","names":[],"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 * @usage low\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"],"mappings":";;AAaA,IAAa,UAAyB;CACpC,IAAM,IAAY,EAAO,GAAK;AAO9B,QALI,EAAU,YAAY,MACxB,EAAU,UAAU,IACb,MAGF,EAAU"}

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

@@ -1,6 +1,7 @@
-import { useLayoutEffect as e, useEffect as o } from "react";
-const t = typeof window < "u" ? e : o;
-export {
-  t as useIsomorphicLayoutEffect
-};
-//# sourceMappingURL=useIsomorphicLayoutEffect.mjs.map
+import { useEffect as e, useLayoutEffect as t } from "react";
+//#region src/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.ts
+var n = typeof window < "u" ? t : e;
+//#endregion
+export { n as useIsomorphicLayoutEffect };
+
+//# sourceMappingURL=useIsomorphicLayoutEffect.mjs.map

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

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

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

@@ -1,27 +1,31 @@
-import { useState as E, useRef as v, useEffect as m } from "react";
-import { useRefState as w } from "../useRefState/useRefState.mjs";
-import { isTarget as i } from "../../utils/helpers/isTarget.mjs";
-const A = ((...n) => {
-  const e = i(n[0]) ? n[0] : void 0, f = e ? n[1] : n[0], y = e ? n[2] : n[1], [a, d] = E(!1), o = w(window), t = v(f);
-  t.current = f;
-  const c = v(y);
-  return c.current = y, m(() => {
-    if (!e && !o.state) return;
-    const s = e ? i.getElement(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));
-    }, l = (u) => {
-      const r = u;
-      (Array.isArray(t.current) ? t.current.includes(r.key) : r.key === t.current) && (d(!1), c.current?.(!1, r));
-    };
-    return s.addEventListener("keydown", k), s.addEventListener("keyup", l), () => {
-      s.removeEventListener("keydown", k), s.removeEventListener("keyup", l);
-    };
-  }, [e && i.getRawElement(e), o.state]), e ? { pressed: a } : { pressed: a, ref: o };
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useRef as r, useState as i } from "react";
+//#region src/hooks/useKeyPress/useKeyPress.ts
+var a = ((...a) => {
+	let o = e(a[0]) ? a[0] : void 0, s = o ? a[1] : a[0], c = o ? a[2] : a[1], [l, u] = i(!1), d = t(window), f = r(s);
+	f.current = s;
+	let p = r(c);
+	return p.current = c, n(() => {
+		if (!o && !d.state) return;
+		let t = o ? e.getElement(o) : d.current;
+		if (!t) return;
+		let n = (e) => {
+			let t = e;
+			(Array.isArray(f.current) ? f.current.includes(t.key) : t.key === f.current) && (u(!0), p.current?.(!0, t));
+		}, r = (e) => {
+			let t = e;
+			(Array.isArray(f.current) ? f.current.includes(t.key) : t.key === f.current) && (u(!1), p.current?.(!1, t));
+		};
+		return t.addEventListener("keydown", n), t.addEventListener("keyup", r), () => {
+			t.removeEventListener("keydown", n), t.removeEventListener("keyup", r);
+		};
+	}, [o && e.getRawElement(o), d.state]), o ? { pressed: l } : {
+		pressed: l,
+		ref: d
+	};
 });
-export {
-  A as useKeyPress
-};
-//# sourceMappingURL=useKeyPress.mjs.map
+//#endregion
+export { a 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 { 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\n/** The use key press return type */\nexport interface UseKeyPressReturn {\n  /** The pressed state of the key */\n  pressed: boolean;\n  /** The ref to attach to the element */\n  ref: StateRef<Element>;\n}\n\nexport interface UseKeyPress {\n  (\n    target: HookTarget | Window,\n    key: UseKeyPressKey,\n    callback?: UseKeyPressCallback\n  ): UseKeyPressReturn;\n\n  <Target extends Element>(\n    key: UseKeyPressKey,\n    callback?: UseKeyPressCallback,\n    target?: never\n  ): UseKeyPressReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useKeyPress\n * @description - Hook that listens for key press events\n * @category Sensors\n * @usage medium\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 {UseKeyPressReturn} An object containing the pressed state and ref\n *\n * @example\n * const isKeyPressed = useKeyPress(ref, 'a');\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 internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? isTarget.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        internalCallbackRef.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        internalCallbackRef.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 && isTarget.getRawElement(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","internalCallbackRef","useEffect","element","onKeyDown","event","keyboardEvent","onKeyUp"],"mappings":";;;AA8DO,MAAMA,KAAe,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,IAAsBD,EAAOP,CAAQ;AA0C3C,SAzCAQ,EAAoB,UAAUR,GAE9BS,EAAU,MAAM;AACd,QAAI,CAACZ,KAAU,CAACO,EAAY,MAAO;AAEnC,UAAMM,IAAWb,IAASC,EAAS,WAAWD,CAAM,IAAIO,EAAY;AACpE,QAAI,CAACM,EAAS;AAEd,UAAMC,IAAY,CAACC,MAAiB;AAClC,YAAMC,IAAgBD;AACtB,OACE,MAAM,QAAQN,EAAO,OAAO,IACxBA,EAAO,QAAQ,SAASO,EAAc,GAAG,IACzCA,EAAc,QAAQP,EAAO,aAEjCJ,EAAW,EAAI,GACfM,EAAoB,UAAU,IAAMK,CAAa;AAAA,IACnD,GAGIC,IAAU,CAACF,MAAiB;AAChC,YAAMC,IAAgBD;AACtB,OACE,MAAM,QAAQN,EAAO,OAAO,IACxBA,EAAO,QAAQ,SAASO,EAAc,GAAG,IACzCA,EAAc,QAAQP,EAAO,aAEjCJ,EAAW,EAAK,GAChBM,EAAoB,UAAU,IAAOK,CAAa;AAAA,IACpD;AAGF,WAAAH,EAAQ,iBAAiB,WAAWC,CAAS,GAC7CD,EAAQ,iBAAiB,SAASI,CAAO,GAElC,MAAM;AACX,MAAAJ,EAAQ,oBAAoB,WAAWC,CAAS,GAChDD,EAAQ,oBAAoB,SAASI,CAAO;AAAA,IAAA;AAAA,EAC9C,GACC,CAACjB,KAAUC,EAAS,cAAcD,CAAM,GAAGO,EAAY,KAAK,CAAC,GAE5DP,IAAe,EAAE,SAAAI,EAAA,IACd,EAAE,SAAAA,GAAS,KAAKG,EAAA;AACzB;"}
+{"version":3,"file":"useKeyPress.mjs","names":[],"sources":["../../../../src/hooks/useKeyPress/useKeyPress.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { 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\n/** The use key press return type */\nexport interface UseKeyPressReturn {\n  /** The pressed state of the key */\n  pressed: boolean;\n  /** The ref to attach to the element */\n  ref: StateRef<Element>;\n}\n\nexport interface UseKeyPress {\n  (\n    target: HookTarget | Window,\n    key: UseKeyPressKey,\n    callback?: UseKeyPressCallback\n  ): UseKeyPressReturn;\n\n  <Target extends Element>(\n    key: UseKeyPressKey,\n    callback?: UseKeyPressCallback,\n    target?: never\n  ): UseKeyPressReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useKeyPress\n * @description - Hook that listens for key press events\n * @category Sensors\n * @usage medium\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 {UseKeyPressReturn} An object containing the pressed state and ref\n *\n * @example\n * const isKeyPressed = useKeyPress(ref, 'a');\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 internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? isTarget.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        internalCallbackRef.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        internalCallbackRef.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 && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return { pressed };\n  return { pressed, ref: internalRef };\n}) as UseKeyPress;\n"],"mappings":";;;;AA8DA,IAAa,MAAgB,GAAG,MAAkB;CAChD,IAAM,IAAS,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAC3C,IAAO,IAAS,EAAO,KAAK,EAAO,IACnC,IAAY,IAAS,EAAO,KAAK,EAAO,IAExC,CAAC,GAAS,KAAc,EAAS,GAAM,EACvC,IAAc,EAAY,OAAO,EAEjC,IAAS,EAAO,EAAI;AAC1B,GAAO,UAAU;CACjB,IAAM,IAAsB,EAAO,EAAS;AA2C5C,QA1CA,EAAoB,UAAU,GAE9B,QAAgB;AACd,MAAI,CAAC,KAAU,CAAC,EAAY,MAAO;EAEnC,IAAM,IAAW,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACpE,MAAI,CAAC,EAAS;EAEd,IAAM,KAAa,MAAiB;GAClC,IAAM,IAAgB;AACtB,IACE,MAAM,QAAQ,EAAO,QAAQ,GACzB,EAAO,QAAQ,SAAS,EAAc,IAAI,GAC1C,EAAc,QAAQ,EAAO,aAEjC,EAAW,GAAK,EAChB,EAAoB,UAAU,IAAM,EAAc;KAIhD,KAAW,MAAiB;GAChC,IAAM,IAAgB;AACtB,IACE,MAAM,QAAQ,EAAO,QAAQ,GACzB,EAAO,QAAQ,SAAS,EAAc,IAAI,GAC1C,EAAc,QAAQ,EAAO,aAEjC,EAAW,GAAM,EACjB,EAAoB,UAAU,IAAO,EAAc;;AAOvD,SAHA,EAAQ,iBAAiB,WAAW,EAAU,EAC9C,EAAQ,iBAAiB,SAAS,EAAQ,QAE7B;AAEX,GADA,EAAQ,oBAAoB,WAAW,EAAU,EACjD,EAAQ,oBAAoB,SAAS,EAAQ;;IAE9C,CAAC,KAAU,EAAS,cAAc,EAAO,EAAE,EAAY,MAAM,CAAC,EAE7D,IAAe,EAAE,YAAS,GACvB;EAAE;EAAS,KAAK;EAAa"}

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

@@ -1,36 +1,34 @@
-import { useRef as d, useEffect as l } from "react";
-import { useRefState as E } from "../useRefState/useRefState.mjs";
-import { isTarget as s } from "../../utils/helpers/isTarget.mjs";
-const g = ((...e) => {
-  const t = s(e[0]) ? e[0] : void 0, u = t ? e[1] : e[0], i = t ? e[2] : e[1], n = t ? e[3] : e[2], o = E(window), r = d(u);
-  r.current = u;
-  const f = d(i);
-  if (f.current = i, l(() => {
-    const c = t ? s.getElement(t) : o.current;
-    if (!c) return;
-    const y = (k) => {
-      const v = k;
-      (Array.isArray(r.current) ? r.current : [r.current]).includes(v.key) && f.current(v);
-    };
-    return c.addEventListener("keydown", y, {
-      capture: n?.capture,
-      passive: n?.passive,
-      once: n?.once
-    }), () => {
-      c.removeEventListener("keydown", y, {
-        capture: n?.capture
-      });
-    };
-  }, [
-    t && s.getRawElement(t),
-    o.state,
-    n?.capture,
-    n?.passive,
-    n?.once
-  ]), !t)
-    return o;
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useRef as r } from "react";
+//#region src/hooks/useKeyPressEvent/useKeyPressEvent.ts
+var i = ((...i) => {
+	let a = e(i[0]) ? i[0] : void 0, o = a ? i[1] : i[0], s = a ? i[2] : i[1], c = a ? i[3] : i[2], l = t(window), u = r(o);
+	u.current = o;
+	let d = r(s);
+	if (d.current = s, n(() => {
+		let t = a ? e.getElement(a) : l.current;
+		if (!t) return;
+		let n = (e) => {
+			let t = e;
+			(Array.isArray(u.current) ? u.current : [u.current]).includes(t.key) && d.current(t);
+		};
+		return t.addEventListener("keydown", n, {
+			capture: c?.capture,
+			passive: c?.passive,
+			once: c?.once
+		}), () => {
+			t.removeEventListener("keydown", n, { capture: c?.capture });
+		};
+	}, [
+		a && e.getRawElement(a),
+		l.state,
+		c?.capture,
+		c?.passive,
+		c?.once
+	]), !a) return l;
 });
-export {
-  g as useKeyPressEvent
-};
-//# sourceMappingURL=useKeyPressEvent.mjs.map
+//#endregion
+export { i 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 { 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 * @usage low\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 ? isTarget.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  }, [\n    target && isTarget.getRawElement(target),\n    internalRef.state,\n    options?.capture,\n    options?.passive,\n    options?.once\n  ]);\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","onKeyDown","event","keyboardEvent"],"mappings":";;;AAiEO,MAAMA,KAAoB,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;AAkCnC,MAjCAM,EAAY,UAAUN,GAEtBO,EAAU,MAAM;AACd,UAAMC,IAAWX,IAASC,EAAS,WAAWD,CAAM,IAAIK,EAAY;AACpE,QAAI,CAACM,EAAS;AAEd,UAAMC,IAAY,CAACC,MAAiB;AAClC,YAAMC,IAAgBD;AAEtB,OADa,MAAM,QAAQN,EAAO,OAAO,IAAIA,EAAO,UAAU,CAACA,EAAO,OAAO,GACpE,SAASO,EAAc,GAAG,KACjCL,EAAY,QAAQK,CAAa;AAAA,IACnC;AAGF,WAAAH,EAAQ,iBAAiB,WAAWC,GAAW;AAAA,MAC7C,SAASR,GAAS;AAAA,MAClB,SAASA,GAAS;AAAA,MAClB,MAAMA,GAAS;AAAA,IAAA,CAChB,GAEM,MAAM;AACX,MAAAO,EAAQ,oBAAoB,WAAWC,GAAW;AAAA,QAChD,SAASR,GAAS;AAAA,MAAA,CACnB;AAAA,IAAA;AAAA,EACH,GACC;AAAA,IACDJ,KAAUC,EAAS,cAAcD,CAAM;AAAA,IACvCK,EAAY;AAAA,IACZD,GAAS;AAAA,IACTA,GAAS;AAAA,IACTA,GAAS;AAAA,EAAA,CACV,GAEG,CAAAJ;AACJ,WAAOK;AACT;"}
+{"version":3,"file":"useKeyPressEvent.mjs","names":[],"sources":["../../../../src/hooks/useKeyPressEvent/useKeyPressEvent.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { 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 * @usage low\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 ? isTarget.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  }, [\n    target && isTarget.getRawElement(target),\n    internalRef.state,\n    options?.capture,\n    options?.passive,\n    options?.once\n  ]);\n\n  if (target) return;\n  return internalRef;\n}) as UseKeyPressEvent;\n"],"mappings":";;;;AAiEA,IAAa,MAAqB,GAAG,MAAkB;CACrD,IAAM,IAAS,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAC3C,IAAO,IAAS,EAAO,KAAK,EAAO,IACnC,IAAY,IAAS,EAAO,KAAK,EAAO,IACxC,IAAW,IAAS,EAAO,KAAK,EAAO,IAEvC,IAAc,EAAY,OAAO,EAEjC,IAAS,EAAO,EAAI;AAC1B,GAAO,UAAU;CACjB,IAAM,IAAc,EAAO,EAAS;AACpC,OAAY,UAAU,GAEtB,QAAgB;EACd,IAAM,IAAW,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACpE,MAAI,CAAC,EAAS;EAEd,IAAM,KAAa,MAAiB;GAClC,IAAM,IAAgB;AAEtB,IADa,MAAM,QAAQ,EAAO,QAAQ,GAAG,EAAO,UAAU,CAAC,EAAO,QAAQ,EACrE,SAAS,EAAc,IAAI,IAClC,EAAY,QAAQ,EAAc;;AAUtC,SANA,EAAQ,iBAAiB,WAAW,GAAW;GAC7C,SAAS,GAAS;GAClB,SAAS,GAAS;GAClB,MAAM,GAAS;GAChB,CAAC,QAEW;AACX,KAAQ,oBAAoB,WAAW,GAAW,EAChD,SAAS,GAAS,SACnB,CAAC;;IAEH;EACD,KAAU,EAAS,cAAc,EAAO;EACxC,EAAY;EACZ,GAAS;EACT,GAAS;EACT,GAAS;EACV,CAAC,EAEE,GACJ,QAAO"}

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

@@ -1,20 +1,17 @@
-import { useRef as y, useEffect as d } from "react";
-import { useRefState as w } from "../useRefState/useRefState.mjs";
-import { isTarget as c } from "../../utils/helpers/isTarget.mjs";
-const l = ((...e) => {
-  const t = c(e[0]) ? e[0] : void 0, u = t ? typeof e[1] == "object" ? e[1] : { onKeyDown: e[1] } : typeof e[0] == "object" ? e[0] : { onKeyDown: e[0] }, o = w(window), r = y(u);
-  if (r.current = u, d(() => {
-    if (!t && !o.state) return;
-    const n = t ? c.getElement(t) : o.current;
-    if (!n) return;
-    const f = (i) => r.current?.onKeyDown?.(i), s = (i) => r.current?.onKeyUp?.(i);
-    return n.addEventListener("keydown", f), n.addEventListener("keyup", s), () => {
-      n.removeEventListener("keydown", f), n.removeEventListener("keyup", s);
-    };
-  }, [t && c.getRawElement(t), o.state]), !t)
-    return o;
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useRef as r } from "react";
+//#region src/hooks/useKeyboard/useKeyboard.ts
+var i = ((...i) => {
+	let a = e(i[0]) ? i[0] : void 0, o = a ? typeof i[1] == "object" ? i[1] : { onKeyDown: i[1] } : typeof i[0] == "object" ? i[0] : { onKeyDown: i[0] }, s = t(), c = r(o);
+	if (c.current = o, n(() => {
+		let t = (a ? e.getElement(a) : s.current) ?? window, n = (e) => c.current?.onKeyDown?.(e), r = (e) => c.current?.onKeyUp?.(e);
+		return t.addEventListener("keydown", n), t.addEventListener("keyup", r), () => {
+			t.removeEventListener("keydown", n), t.removeEventListener("keyup", r);
+		};
+	}, [a && e.getRawElement(a), s.state]), !a) return { ref: s };
 });
-export {
-  l as useKeyboard
-};
-//# sourceMappingURL=useKeyboard.mjs.map
+//#endregion
+export { i 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, useRef } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use keyboard event handler type */\nexport type KeyboardEventHandler = (event: KeyboardEvent) => void;\n\n/** The use keyboard event options type */\nexport interface UseKeyboardEventOptions {\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, callback: KeyboardEventHandler): void;\n\n  (target: HookTarget, options: UseKeyboardEventOptions): void;\n\n  <Target extends HTMLElement>(\n    callback: KeyboardEventHandler,\n    target?: never\n  ): { ref: StateRef<Target> };\n\n  <Target extends HTMLElement>(\n    options: UseKeyboardEventOptions,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useKeyboard\n * @description - Hook that helps to listen for keyboard events\n * @category Sensors\n * @usage medium\n *\n * @overload\n * @param {HookTarget} target The target to attach the event listeners to\n * @param {KeyboardEventHandler} callback The callback function to be invoked on key down\n * @returns {void}\n *\n * @example\n * useKeyboard(ref, (event) => console.log('key down'));\n *\n * @overload\n * @param {HookTarget} target The target to attach the event listeners to\n * @param {UseKeyboardEventOptions} [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 {KeyboardEventHandler} callback The callback function to be invoked on key down\n * @returns {{ ref: StateRef<Target> }} An object containing the ref\n *\n * @example\n * const ref = useKeyboard((event) => console.log('key down'));\n *\n * @overload\n * @template Target The target element type\n * @param {UseKeyboardEventOptions} [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 = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onKeyDown: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onKeyDown: params[0] }\n  ) as UseKeyboardEventOptions;\n\n  const internalRef = useRefState(window);\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? isTarget.getElement(target) : internalRef.current) as HTMLElement;\n    if (!element) return;\n\n    const onKeyDown = (event: Event) =>\n      internalOptionsRef.current?.onKeyDown?.(event as KeyboardEvent);\n    const onKeyUp = (event: Event) => internalOptionsRef.current?.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 && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return;\n  return internalRef;\n}) as UseKeyboard;\n"],"names":["useKeyboard","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","useEffect","element","onKeyDown","event","onKeyUp"],"mappings":";;;AA6EO,MAAMA,KAAe,IAAIC,MAAkB;AAChD,QAAMC,IAASC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC3CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,WAAWA,EAAO,CAAC,EAAA,IACvB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,WAAWA,EAAO,CAAC,EAAA,GAGvBI,IAAcC,EAAY,MAAM,GAChCC,IAAqBC,EAAOJ,CAAO;AAsBzC,MArBAG,EAAmB,UAAUH,GAE7BK,EAAU,MAAM;AACd,QAAI,CAACP,KAAU,CAACG,EAAY,MAAO;AAEnC,UAAMK,IAAWR,IAASC,EAAS,WAAWD,CAAM,IAAIG,EAAY;AACpE,QAAI,CAACK,EAAS;AAEd,UAAMC,IAAY,CAACC,MACjBL,EAAmB,SAAS,YAAYK,CAAsB,GAC1DC,IAAU,CAACD,MAAiBL,EAAmB,SAAS,UAAUK,CAAsB;AAE9F,WAAAF,EAAQ,iBAAiB,WAAWC,CAAS,GAC7CD,EAAQ,iBAAiB,SAASG,CAAO,GAElC,MAAM;AACX,MAAAH,EAAQ,oBAAoB,WAAWC,CAAS,GAChDD,EAAQ,oBAAoB,SAASG,CAAO;AAAA,IAAA;AAAA,EAC9C,GACC,CAACX,KAAUC,EAAS,cAAcD,CAAM,GAAGG,EAAY,KAAK,CAAC,GAE5D,CAAAH;AACJ,WAAOG;AACT;"}
+{"version":3,"file":"useKeyboard.mjs","names":[],"sources":["../../../../src/hooks/useKeyboard/useKeyboard.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use keyboard return type */\nexport type UseKeyboardReturn<Target extends HTMLElement> = StateRef<Target>;\n\n/** The use keyboard event handler type */\nexport type KeyboardEventHandler = (event: KeyboardEvent) => void;\n\n/** The use keyboard event options type */\nexport interface UseKeyboardEventOptions {\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, callback: KeyboardEventHandler): void;\n\n  (target: HookTarget, options: UseKeyboardEventOptions): void;\n\n  <Target extends HTMLElement>(\n    callback: KeyboardEventHandler,\n    target?: never\n  ): { ref: StateRef<Target> };\n\n  <Target extends HTMLElement>(\n    options: UseKeyboardEventOptions,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useKeyboard\n * @description - Hook that helps to listen for keyboard events\n * @category Sensors\n * @usage medium\n *\n * @overload\n * @param {HookTarget} target The target to attach the event listeners to\n * @param {KeyboardEventHandler} callback The callback function to be invoked on key down\n * @returns {void}\n *\n * @example\n * useKeyboard(ref, (event) => console.log('key down'));\n *\n * @overload\n * @param {HookTarget} target The target to attach the event listeners to\n * @param {UseKeyboardEventOptions} [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 {KeyboardEventHandler} callback The callback function to be invoked on key down\n * @returns {{ ref: StateRef<Target> }} An object containing the ref\n *\n * @example\n * const keyboard = useKeyboard((event) => console.log('key down'));\n *\n * @overload\n * @template Target The target element type\n * @param {UseKeyboardEventOptions} [options] The keyboard event options\n * @returns {{ ref: StateRef<Target> }} An object containing the ref\n *\n * @example\n * const keyboard = 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 = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onKeyDown: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onKeyDown: params[0] }\n  ) as UseKeyboardEventOptions;\n\n  const internalRef = useRefState<HTMLElement | Window>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    const element =\n      ((target ? isTarget.getElement(target) : internalRef.current) as HTMLElement) ?? window;\n\n    const onKeyDown = (event: Event) =>\n      internalOptionsRef.current?.onKeyDown?.(event as KeyboardEvent);\n    const onKeyUp = (event: Event) => internalOptionsRef.current?.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 && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return;\n  return { ref: internalRef };\n}) as UseKeyboard;\n"],"mappings":";;;;AAgFA,IAAa,MAAgB,GAAG,MAAkB;CAChD,IAAM,IAAS,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAC3C,IACJ,IACI,OAAO,EAAO,MAAO,WACnB,EAAO,KACP,EAAE,WAAW,EAAO,IAAI,GAC1B,OAAO,EAAO,MAAO,WACnB,EAAO,KACP,EAAE,WAAW,EAAO,IAAI,EAG1B,IAAc,GAAmC,EACjD,IAAqB,EAAO,EAAQ;AAC1C,OAAmB,UAAU,GAE7B,QAAgB;EACd,IAAM,KACF,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY,YAA4B,QAE7E,KAAa,MACjB,EAAmB,SAAS,YAAY,EAAuB,EAC3D,KAAW,MAAiB,EAAmB,SAAS,UAAU,EAAuB;AAK/F,SAHA,EAAQ,iBAAiB,WAAW,EAAU,EAC9C,EAAQ,iBAAiB,SAAS,EAAQ,QAE7B;AAEX,GADA,EAAQ,oBAAoB,WAAW,EAAU,EACjD,EAAQ,oBAAoB,SAAS,EAAQ;;IAE9C,CAAC,KAAU,EAAS,cAAc,EAAO,EAAE,EAAY,MAAM,CAAC,EAE7D,GACJ,QAAO,EAAE,KAAK,GAAa"}

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

@@ -1,26 +1,37 @@
-import { useState as k, useEffect as v } from "react";
-import { useRefState as a } from "../useRefState/useRefState.mjs";
-import { isTarget as u } from "../../utils/helpers/isTarget.mjs";
-const p = ((...r) => {
-  const e = u(r[0]) ? r[0] : void 0, f = (e ? r[1] : r[0])?.enabled ?? !0, [y, s] = k([]), i = a(window);
-  return v(() => {
-    if (!f) return;
-    s([]);
-    const t = e ? u.getElement(e) : i.current;
-    if (!t) return;
-    const m = (c) => {
-      const n = c;
-      s((o) => o.some(({ code: d }) => d === n.code) ? o : [...o, { key: n.key, code: n.code }]);
-    }, E = (c) => {
-      const n = c;
-      s((o) => o.filter(({ code: d }) => d !== n.code));
-    };
-    return t.addEventListener("keydown", m), t.addEventListener("keyup", E), () => {
-      t.removeEventListener("keydown", m), t.removeEventListener("keyup", E);
-    };
-  }, [f, i.state, e && u.getRawElement(e)]), e ? { value: y } : { value: y, ref: i };
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useState as r } from "react";
+//#region src/hooks/useKeysPressed/useKeysPressed.ts
+var i = ((...i) => {
+	let a = e(i[0]) ? i[0] : void 0, o = (a ? i[1] : i[0])?.enabled ?? !0, [s, c] = r([]), l = t(window);
+	return n(() => {
+		if (!o) return;
+		c([]);
+		let t = a ? e.getElement(a) : l.current;
+		if (!t) return;
+		let n = (e) => {
+			let t = e;
+			c((e) => e.some(({ code: e }) => e === t.code) ? e : [...e, {
+				key: t.key,
+				code: t.code
+			}]);
+		}, r = (e) => {
+			let t = e;
+			c((e) => e.filter(({ code: e }) => e !== t.code));
+		};
+		return t.addEventListener("keydown", n), t.addEventListener("keyup", r), () => {
+			t.removeEventListener("keydown", n), t.removeEventListener("keyup", r);
+		};
+	}, [
+		o,
+		l.state,
+		a && e.getRawElement(a)
+	]), a ? { value: s } : {
+		value: s,
+		ref: l
+	};
 });
-export {
-  p as useKeysPressed
-};
-//# sourceMappingURL=useKeysPressed.mjs.map
+//#endregion
+export { i 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 { 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 UseKeysPressedReturn {\n  /** The array of currently pressed keys */\n  value: Array<{ key: string; code: string }>;\n}\n\nexport interface UseKeysPressed {\n  (target: HookTarget | Window, options?: UseKeysPressedOptions): UseKeysPressedReturn;\n\n  <Target extends Element>(\n    options?: UseKeysPressedOptions\n  ): UseKeysPressedReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useKeysPressed\n * @description Tracks all currently pressed keyboard keys and their codes\n * @category Sensors\n * @usage low\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 {UseKeysPressedReturn} Object containing the array of currently pressed keys\n *\n * @example\n * const { value } = useKeysPressed(ref);\n *\n * @overload\n * @template Target - Type of the target DOM element\n * @param {UseKeysPressedOptions} [options] - Optional configuration options\n * @returns {UseKeysPressedReturn & { ref: StateRef<Target> }} Object containing the array of currently pressed keys and ref to attach to the 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 ? isTarget.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 && isTarget.getRawElement(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","onKeyDown","event","keyboardEvent","prevValue","code","onKeyUp"],"mappings":";;;AAmDO,MAAMA,KAAkB,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,IAASC,EAAS,WAAWD,CAAM,IAAIM,EAAY;AACpE,QAAI,CAACG,EAAS;AAEd,UAAMC,IAAY,CAACC,MAAiB;AAClC,YAAMC,IAAgBD;AACtB,MAAAP,EAAS,CAACS,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,MAAAP,EAAS,CAACS,MAAcA,EAAU,OAAO,CAAC,EAAE,MAAAC,EAAA,MAAWA,MAASF,EAAc,IAAI,CAAC;AAAA,IAAA;AAGrF,WAAAH,EAAQ,iBAAiB,WAAWC,CAAS,GAC7CD,EAAQ,iBAAiB,SAASM,CAAO,GAElC,MAAM;AACX,MAAAN,EAAQ,oBAAoB,WAAWC,CAAS,GAChDD,EAAQ,oBAAoB,SAASM,CAAO;AAAA,IAAA;AAAA,EAC9C,GACC,CAACb,GAASI,EAAY,OAAON,KAAUC,EAAS,cAAcD,CAAM,CAAC,CAAC,GAErEA,IAAe,EAAE,OAAAG,EAAA,IACd,EAAE,OAAAA,GAAO,KAAKG,EAAA;AACvB;"}
+{"version":3,"file":"useKeysPressed.mjs","names":[],"sources":["../../../../src/hooks/useKeysPressed/useKeysPressed.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { 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 UseKeysPressedReturn {\n  /** The array of currently pressed keys */\n  value: Array<{ key: string; code: string }>;\n}\n\nexport interface UseKeysPressed {\n  (target: HookTarget | Window, options?: UseKeysPressedOptions): UseKeysPressedReturn;\n\n  <Target extends Element>(\n    options?: UseKeysPressedOptions\n  ): UseKeysPressedReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useKeysPressed\n * @description Tracks all currently pressed keyboard keys and their codes\n * @category Sensors\n * @usage low\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 {UseKeysPressedReturn} Object containing the array of currently pressed keys\n *\n * @example\n * const { value } = useKeysPressed(ref);\n *\n * @overload\n * @template Target - Type of the target DOM element\n * @param {UseKeysPressedOptions} [options] - Optional configuration options\n * @returns {UseKeysPressedReturn & { ref: StateRef<Target> }} Object containing the array of currently pressed keys and ref to attach to the 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 ? isTarget.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 && isTarget.getRawElement(target)]);\n\n  if (target) return { value };\n  return { value, ref: internalRef };\n}) as UseKeysPressed;\n"],"mappings":";;;;AAmDA,IAAa,MAAmB,GAAG,MAAkB;CACnD,IAAM,IAAU,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAG5C,KAFW,IAAS,EAAO,KAAK,EAAO,KAEpB,WAAW,IAC9B,CAAC,GAAO,KAAY,EAA0C,EAAE,CAAC,EACjE,IAAc,EAAY,OAAO;AAgCvC,QA9BA,QAAgB;AACd,MAAI,CAAC,EAAS;AACd,IAAS,EAAE,CAAC;EAEZ,IAAM,IAAW,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACpE,MAAI,CAAC,EAAS;EAEd,IAAM,KAAa,MAAiB;GAClC,IAAM,IAAgB;AACtB,MAAU,MACJ,EAAU,MAAM,EAAE,cAAW,MAAS,EAAc,KAAK,GAAS,IAC/D,CAAC,GAAG,GAAW;IAAE,KAAK,EAAc;IAAK,MAAM,EAAc;IAAM,CAAC,CAC3E;KAGE,KAAW,MAAiB;GAChC,IAAM,IAAgB;AACtB,MAAU,MAAc,EAAU,QAAQ,EAAE,cAAW,MAAS,EAAc,KAAK,CAAC;;AAMtF,SAHA,EAAQ,iBAAiB,WAAW,EAAU,EAC9C,EAAQ,iBAAiB,SAAS,EAAQ,QAE7B;AAEX,GADA,EAAQ,oBAAoB,WAAW,EAAU,EACjD,EAAQ,oBAAoB,SAAS,EAAQ;;IAE9C;EAAC;EAAS,EAAY;EAAO,KAAU,EAAS,cAAc,EAAO;EAAC,CAAC,EAEtE,IAAe,EAAE,UAAO,GACrB;EAAE;EAAO,KAAK;EAAa"}

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

@@ -1,10 +1,11 @@
-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;
+import { useDidUpdate as e } from "../useDidUpdate/useDidUpdate.mjs";
+import { useState as t } from "react";
+//#region src/hooks/useLastChanged/useLastChanged.ts
+var n = (n, r) => {
+	let [i, a] = t(r?.initialValue ?? null);
+	return e(() => a(Date.now()), [n]), i;
 };
-export {
-  u as useLastChanged
-};
-//# sourceMappingURL=useLastChanged.mjs.map
+//#endregion
+export { n 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 Utilities\n * @usage low\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":";;AAsBO,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;"}
+{"version":3,"file":"useLastChanged.mjs","names":[],"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 Utilities\n * @usage low\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"],"mappings":";;;AAsBA,IAAa,KAAkB,GAAa,MAAmD;CAC7F,IAAM,CAAC,GAAa,KAAkB,EAAS,GAAS,gBAAgB,KAAK;AAI7E,QAFA,QAAmB,EAAe,KAAK,KAAK,CAAC,EAAE,CAAC,EAAO,CAAC,EAEjD"}

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

@@ -1,17 +1,15 @@
-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
-    }),
-    []
-  );
+import { useMemo as e, useRef as t } from "react";
+//#region src/hooks/useLatest/useLatest.ts
+var n = (n) => {
+	let r = t(n);
+	return r.current = n, e(() => ({
+		get value() {
+			return r.current;
+		},
+		ref: r
+	}), []);
 };
-export {
-  o as useLatest
-};
-//# sourceMappingURL=useLatest.mjs.map
+//#endregion
+export { n as useLatest };
+
+//# sourceMappingURL=useLatest.mjs.map

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

@@ -1 +1 @@
-{"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 * @usage medium\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 { value, ref } = 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":";AAsBO,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;"}
+{"version":3,"file":"useLatest.mjs","names":[],"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 * @usage medium\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 { value, ref } = 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"],"mappings":";;AAsBA,IAAa,KAAoB,MAAyC;CACxE,IAAM,IAAW,EAAc,EAAM;AAErC,QADA,EAAS,UAAU,GACZ,SACE;EACL,IAAI,QAAQ;AACV,UAAO,EAAS;;EAElB,KAAK;EACN,GACD,EAAE,CACH"}

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

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

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 * @usage low\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":";AAiBO,MAAMA,IAAU,CAAQC,OAC7BC,EAAU,MAAM;AACd,UAAQ,KAAK,mDAAmD;AAAA,GAC/D,EAAE,GAEED;"}
+{"version":3,"file":"useLess.mjs","names":[],"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 * @usage low\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"],"mappings":";;AAiBA,IAAa,KAAkB,OAC7B,QAAgB;AACd,SAAQ,KAAK,oDAAoD;GAChE,EAAE,CAAC,EAEC"}

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

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