@siberiacancode/reactuse 0.0.111 → 0.0.113

package/dist/esm/hooks/useEventListener/useEventListener.mjs

@@ -0,0 +1,21 @@
+import { useEffect as E } from "react";
+import { useEvent as l } from "../useEvent/useEvent.mjs";
+import { useRefState as m } from "../useRefState/useRefState.mjs";
+import { isTarget as d } from "../../utils/helpers/isTarget.mjs";
+import { getElement as L } from "../../utils/helpers/getElement.mjs";
+const R = (...t) => {
+  const e = d(t[0]) ? t[0] : void 0, r = e ? t[1] : t[0], c = Array.isArray(r) ? r : [r], u = e ? t[2] : t[1], o = e ? t[3] : t[2], i = m(window), v = l(u);
+  if (E(() => {
+    const s = e ? L(e) : i.current;
+    if (!s) return;
+    const f = (n) => v(n);
+    return c.forEach((n) => s.addEventListener(n, f, o)), () => {
+      c.forEach((n) => s.removeEventListener(n, f, o));
+    };
+  }, [e, i.state, r, o]), !e)
+    return i;
+};
+export {
+  R as useEventListener
+};
+//# sourceMappingURL=useEventListener.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEventListener.mjs","sources":["../../../../src/hooks/useEventListener/useEventListener.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 { useEvent } from '../useEvent/useEvent';\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use event listener options */\nexport type UseEventListenerOptions = boolean | AddEventListenerOptions;\n\n/** The use event listener return type */\nexport type UseEventListenerReturn<Target extends Element> = StateRef<Target>;\n\nexport interface UseEventListener {\n  <Event extends keyof WindowEventMap = keyof WindowEventMap>(\n    target: Window,\n    event: Event | Event[],\n    listener: (this: Window, event: WindowEventMap[Event]) => void,\n    options?: UseEventListenerOptions\n  ): void;\n\n  <Event extends keyof DocumentEventMap = keyof DocumentEventMap>(\n    target: Document,\n    event: Event | Event[],\n    listener: (this: Document, event: DocumentEventMap[Event]) => void,\n    options?: UseEventListenerOptions\n  ): void;\n\n  <Event extends keyof HTMLElementEventMap = keyof HTMLElementEventMap>(\n    target: HookTarget,\n    event: Event | Event[],\n    listener: (this: Element, event: HTMLElementEventMap[Event]) => void,\n    options?: UseEventListenerOptions\n  ): void;\n\n  <Target extends Element, Event extends keyof HTMLElementEventMap = keyof HTMLElementEventMap>(\n    event: Event | Event[],\n    listener: (this: Target, event: HTMLElementEventMap[Event]) => void,\n    options?: UseEventListenerOptions,\n    target?: never\n  ): UseEventListenerReturn<Target>;\n\n  <\n    Target extends Element,\n    Event extends keyof MediaQueryListEventMap = keyof MediaQueryListEventMap\n  >(\n    event: Event | Event[],\n    listener: (this: Target, event: MediaQueryListEventMap[Event]) => void,\n    options?: UseEventListenerOptions,\n    target?: never\n  ): UseEventListenerReturn<Target>;\n}\n\n/**\n * @name useEventListener\n * @description - Hook that attaches an event listener to the specified target\n * @category Browser\n *\n * @overload\n * @template Event Key of window event map\n * @param {Window} target The window object to attach the event listener to\n * @param {Event | Event[]} event An array of event types to listen for\n * @param {(this: Window, event: WindowEventMap[Event]) => void} handler The event handler function\n * @param {UseEventListenerOptions} [options] Options for the event listener\n * @returns {void}\n *\n * @example\n * useEventListener(window, 'click', () => console.log('click'));\n *\n * @overload\n * @template Event Key of window event map\n * @param {Document} target The window object to attach the event listener to\n * @param {Event | Event[]} event An array of event types to listen for\n * @param {(this: Document, event: DocumentEventMap[Event]) => void} handler The event handler function\n * @param {UseEventListenerOptions} [options] Options for the event listener\n * @returns {void}\n *\n * @example\n * useEventListener(document, 'click', () => console.log('click'));\n *\n * @overload\n * @template Event Key of window event map\n * @template Target The target element\n * @param {HookTarget} target The target element to attach the event listener to\n * @param {Event | Event[]} event An array of event types to listen for\n * @param {(this: Target, event: HTMLElementEventMap[Event]) => void} handler The event handler function\n * @param {UseEventListenerOptions} [options] Options for the event listener\n * @returns {void}\n *\n * @example\n * useEventListener(ref, 'click', () => console.log('click'));\n *\n * @overload\n * @template Event Key of window event map\n * @template Target The target element\n * @param {Event | Event[]} event An array of event types to listen for\n * @param {(this: Target, event: HTMLElementEventMap[Event] | MediaQueryListEventMap[Event]) => void} handler The event handler function\n * @param {UseEventListenerOptions} [options] Options for the event listener\n * @returns {UseEventListenerReturn<Target>} A reference to the target element\n *\n * @example\n * const ref = useEventListener('click', () => console.log('click'));\n */\nexport const useEventListener = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const event = (target ? params[1] : params[0]) as string | string[];\n  const events = Array.isArray(event) ? event : [event];\n  const listener = (target ? params[2] : params[1]) as (...arg: any[]) => undefined | void;\n  const options = (target ? params[3] : params[2]) as UseEventListenerOptions | undefined;\n\n  const internalRef = useRefState(window);\n  const internalListener = useEvent(listener);\n\n  useEffect(() => {\n    const element = target ? getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const callback = (event: Event) => internalListener(event);\n\n    events.forEach((event) => element.addEventListener(event, callback, options));\n    return () => {\n      events.forEach((event) => element.removeEventListener(event, callback, options));\n    };\n  }, [target, internalRef.state, event, options]);\n\n  if (target) return;\n  return internalRef;\n}) as UseEventListener;\n"],"names":["useEventListener","params","target","isTarget","event","events","listener","options","internalRef","useRefState","internalListener","useEvent","useEffect","element","getElement","callback"],"mappings":";;;;;AA2Ga,MAAAA,IAAoB,IAAIC,MAAkB;AAC/C,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAASF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACtCI,IAAS,MAAM,QAAQD,CAAK,IAAIA,IAAQ,CAACA,CAAK,GAC9CE,IAAYJ,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACzCM,IAAWL,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCO,IAAcC,EAAY,MAAM,GAChCC,IAAmBC,EAASL,CAAQ;AAc1C,MAZAM,EAAU,MAAM;AACd,UAAMC,IAAUX,IAASY,EAAWZ,CAAM,IAAIM,EAAY;AAC1D,QAAI,CAACK,EAAS;AAEd,UAAME,IAAW,CAACX,MAAiBM,EAAiBN,CAAK;AAElD,WAAAC,EAAA,QAAQ,CAACD,MAAUS,EAAQ,iBAAiBT,GAAOW,GAAUR,CAAO,CAAC,GACrE,MAAM;AACJ,MAAAF,EAAA,QAAQ,CAACD,MAAUS,EAAQ,oBAAoBT,GAAOW,GAAUR,CAAO,CAAC;AAAA,IACjF;AAAA,EAAA,GACC,CAACL,GAAQM,EAAY,OAAOJ,GAAOG,CAAO,CAAC,GAE1C,CAAAL;AACG,WAAAM;AACT;"}

package/dist/esm/hooks/useEyeDropper/useEyeDropper.mjs

@@ -0,0 +1,17 @@
+import { useState as s } from "react";
+const d = (o = void 0) => {
+  const r = typeof window < "u" && "EyeDropper" in window, [p, n] = s(o);
+  return {
+    supported: r,
+    value: p,
+    open: async (t) => {
+      if (!window.EyeDropper) throw new Error("EyeDropper is not supported");
+      const e = await new window.EyeDropper().open(t);
+      return n(e.sRGBHex), e;
+    }
+  };
+};
+export {
+  d as useEyeDropper
+};
+//# sourceMappingURL=useEyeDropper.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEyeDropper.mjs","sources":["../../../../src/hooks/useEyeDropper/useEyeDropper.ts"],"sourcesContent":["import { useState } from 'react';\n\nexport interface ColorSelectionOptions {\n  signal?: AbortSignal;\n}\n\nexport interface ColorSelectionResult {\n  sRGBHex: string;\n}\n\nexport interface EyeDropper {\n  open: (options?: ColorSelectionOptions) => Promise<ColorSelectionResult>;\n}\n\nexport interface EyeDropperConstructor {\n  new (): EyeDropper;\n}\n\ndeclare global {\n  interface Window {\n    readonly EyeDropper?: EyeDropperConstructor | undefined;\n  }\n}\n\n/** The color selection return type */\nexport interface UseEyeDropperReturn {\n  /** The eye dropper supported status */\n  supported: boolean;\n  /** The eye dropper value */\n  value?: string;\n  /** The eye dropper open method */\n  open: (colorSelectionOptions?: ColorSelectionOptions) => Promise<ColorSelectionResult>;\n}\n\n/**\n * @name useEyeDropper\n * @description - Hook that gives you access to the eye dropper\n * @category Browser\n *\n * @browserapi EyeDropper https://developer.mozilla.org/en-US/docs/Web/API/EyeDropper\n *\n * @param {string} [initialValue=undefined] The initial value for the eye dropper\n * @returns {UseEyeDropperReturn} An object containing the supported status, the value and the open method\n *\n * @example\n * const { supported, value, open } = useEyeDropper();\n */\nexport const useEyeDropper = (\n  initialValue: string | undefined = undefined\n): UseEyeDropperReturn => {\n  const supported = typeof window !== 'undefined' && 'EyeDropper' in window;\n  const [value, setValue] = useState(initialValue);\n\n  const open = async (colorSelectionOptions?: ColorSelectionOptions) => {\n    if (!window.EyeDropper) throw new Error('EyeDropper is not supported');\n    const eyeDropper = new window.EyeDropper();\n    const result = await eyeDropper.open(colorSelectionOptions);\n    setValue(result.sRGBHex);\n    return result;\n  };\n\n  return {\n    supported,\n    value,\n    open\n  };\n};\n"],"names":["useEyeDropper","initialValue","supported","value","setValue","useState","colorSelectionOptions","result"],"mappings":";AA+Ca,MAAAA,IAAgB,CAC3BC,IAAmC,WACX;AACxB,QAAMC,IAAY,OAAO,SAAW,OAAe,gBAAgB,QAC7D,CAACC,GAAOC,CAAQ,IAAIC,EAASJ,CAAY;AAUxC,SAAA;AAAA,IACL,WAAAC;AAAA,IACA,OAAAC;AAAA,IACA,MAXW,OAAOG,MAAkD;AACpE,UAAI,CAAC,OAAO,WAAkB,OAAA,IAAI,MAAM,6BAA6B;AAErE,YAAMC,IAAS,MADI,IAAI,OAAO,WAAW,EACT,KAAKD,CAAqB;AAC1D,aAAAF,EAASG,EAAO,OAAO,GAChBA;AAAA,IACT;AAAA,EAMA;AACF;"}

package/dist/esm/hooks/useFavicon/useFavicon.mjs

@@ -0,0 +1,23 @@
+import { useState as s } from "react";
+import { useDidUpdate as p } from "../useDidUpdate/useDidUpdate.mjs";
+import { useMount as d } from "../useMount/useMount.mjs";
+const y = (e) => {
+  var c;
+  const [u, n] = s(
+    e ?? ((c = document.querySelector('link[rel*="icon"]')) == null ? void 0 : c.href)
+  ), r = (o) => {
+    const t = document.querySelector('link[rel*="icon"]') || document.createElement("link");
+    t.rel = "icon", t.href = o, t.type = `image/${o.split(".").pop()}`, document.head.append(t);
+  }, m = (o) => {
+    n(o), r(o);
+  };
+  return d(() => {
+    e && r(e);
+  }), p(() => {
+    e && (n(e), r(e));
+  }, [e]), { href: u, set: m };
+};
+export {
+  y as useFavicon
+};
+//# sourceMappingURL=useFavicon.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFavicon.mjs","sources":["../../../../src/hooks/useFavicon/useFavicon.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from 'react';\n\nimport { useState } from 'react';\n\nimport { useDidUpdate } from '../useDidUpdate/useDidUpdate';\nimport { useMount } from '../useMount/useMount';\n\n/** The use favicon return type */\nexport type UseFaviconReturn = [string, Dispatch<SetStateAction<string>>];\n\n/**\n * @name useFavicon\n * @description - Hook that manages the favicon\n * @category Browser\n *\n * @param {string} [initialFavicon] The initial favicon. If not provided, the current favicon will be used\n * @returns {UseFaviconReturn} An array containing the current favicon and a function to update the favicon\n *\n * @example\n * const { href, set } = useFavicon('https://www.google.com/favicon.ico');\n */\nexport const useFavicon = (initialHref?: string) => {\n  const [href, setHref] = useState(\n    initialHref ?? document.querySelector<HTMLLinkElement>(`link[rel*=\"icon\"]`)?.href\n  );\n\n  const injectFavicon = (favicon: string) => {\n    const link =\n      document.querySelector<HTMLLinkElement>(`link[rel*=\"icon\"]`) ||\n      document.createElement('link');\n    link.rel = 'icon';\n    link.href = favicon;\n    link.type = `image/${favicon.split('.').pop()}`;\n    document.head.append(link);\n  };\n\n  const set = (favicon: string) => {\n    setHref(favicon);\n    injectFavicon(favicon);\n  };\n\n  useMount(() => {\n    if (!initialHref) return;\n    injectFavicon(initialHref);\n  });\n\n  useDidUpdate(() => {\n    if (!initialHref) return;\n    setHref(initialHref);\n    injectFavicon(initialHref);\n  }, [initialHref]);\n\n  return { href, set } as const;\n};\n"],"names":["useFavicon","initialHref","href","setHref","useState","_a","injectFavicon","favicon","link","set","useMount","useDidUpdate"],"mappings":";;;AAqBa,MAAAA,IAAa,CAACC,MAAyB;;AAC5C,QAAA,CAACC,GAAMC,CAAO,IAAIC;AAAA,IACtBH,OAAeI,IAAA,SAAS,cAA+B,mBAAmB,MAA3D,gBAAAA,EAA8D;AAAA,EAC/E,GAEMC,IAAgB,CAACC,MAAoB;AACzC,UAAMC,IACJ,SAAS,cAA+B,mBAAmB,KAC3D,SAAS,cAAc,MAAM;AAC/B,IAAAA,EAAK,MAAM,QACXA,EAAK,OAAOD,GACZC,EAAK,OAAO,SAASD,EAAQ,MAAM,GAAG,EAAE,KAAK,IACpC,SAAA,KAAK,OAAOC,CAAI;AAAA,EAC3B,GAEMC,IAAM,CAACF,MAAoB;AAC/B,IAAAJ,EAAQI,CAAO,GACfD,EAAcC,CAAO;AAAA,EACvB;AAEA,SAAAG,EAAS,MAAM;AACb,IAAKT,KACLK,EAAcL,CAAW;AAAA,EAAA,CAC1B,GAEDU,EAAa,MAAM;AACjB,IAAKV,MACLE,EAAQF,CAAW,GACnBK,EAAcL,CAAW;AAAA,EAAA,GACxB,CAACA,CAAW,CAAC,GAET,EAAE,MAAAC,GAAM,KAAAO,EAAI;AACrB;"}

package/dist/esm/hooks/useField/useField.mjs

@@ -0,0 +1,73 @@
+import { useRef as k, useState as v } from "react";
+import { useRerender as C } from "../useRerender/useRerender.mjs";
+const F = (t) => {
+  const i = (t == null ? void 0 : t.initialValue) ?? "", n = k(null), l = k(!1), o = C(), [h, f] = v(!1), [V, g] = v((t == null ? void 0 : t.initialTouched) ?? !1), [L, c] = v(void 0), y = () => {
+    var e, u, r;
+    return ((e = n.current) == null ? void 0 : e.type) === "radio" || ((u = n.current) == null ? void 0 : u.type) === "checkbox" ? n.current.checked : ((r = n.current) == null ? void 0 : r.value) ?? i;
+  }, x = (e) => {
+    var u, r;
+    if (((u = n.current) == null ? void 0 : u.type) === "radio" || ((r = n.current) == null ? void 0 : r.type) === "checkbox")
+      return n.current.checked = e, l.current ? o() : void 0;
+    if (n.current.value = e, l.current) return o();
+  }, b = () => {
+    x(i), f(!1), g(!1), c(void 0);
+  }, w = () => {
+    n.current.focus();
+  }, d = (e) => {
+    if (e.required && !n.current.value)
+      return c(e.required);
+    if (e.minLength && n.current.value.length < e.minLength.value)
+      return c(e.minLength.message);
+    if (e.maxLength && n.current.value.length > e.maxLength.value)
+      return c(e.maxLength.message);
+    if (e.min && Number(n.current.value) < e.min.value)
+      return c(e.min.message);
+    if (e.max && Number(n.current.value) > e.max.value)
+      return c(e.max.message);
+    if (e.pattern && !e.pattern.value.test(n.current.value))
+      return c(e.pattern.message);
+    if (e.validate) {
+      const u = e.validate(n.current.value);
+      if (typeof u == "string") return c(u);
+    }
+    c(void 0);
+  };
+  return {
+    register: (e) => ({
+      ref: (u) => {
+        if (!n.current && u) {
+          if (t != null && t.autoFocus && u.focus(), n.current = u, n.current.type === "radio") {
+            n.current.defaultChecked = (t == null ? void 0 : t.initialValue) === u.value;
+            return;
+          }
+          if (n.current.type === "checkbox") {
+            n.current.defaultChecked = !!(t != null && t.initialValue);
+            return;
+          }
+          n.current.defaultValue = String(i), e && (t != null && t.validateOnMount) && d(e);
+        }
+      },
+      onChange: async () => {
+        if (l.current) return o();
+        n.current.value !== i && f(!0), h && n.current.value === i && f(!1), e && (t != null && t.validateOnChange) && await d(e), e && (t != null && t.validateOnBlur) && c(void 0);
+      },
+      onBlur: async () => {
+        e && (t != null && t.validateOnBlur) && await d(e), g(!0);
+      }
+    }),
+    dirty: h,
+    touched: V,
+    error: L,
+    setError: c,
+    clearError: () => c(void 0),
+    getValue: y,
+    setValue: x,
+    reset: b,
+    watch: () => (l.current = !0, y()),
+    focus: w
+  };
+};
+export {
+  F as useField
+};
+//# sourceMappingURL=useField.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useField.mjs","sources":["../../../../src/hooks/useField/useField.ts"],"sourcesContent":["import { useRef, useState } from 'react';\n\nimport { useRerender } from '../useRerender/useRerender';\n\n/** The use field params type */\nexport interface UseFieldParams<Value> {\n  /** The auto focus */\n  autoFocus?: boolean;\n  /** The initial touched */\n  initialTouched?: boolean;\n  /** The initial value */\n  initialValue?: Value;\n  /** The validate on blur */\n  validateOnBlur?: boolean;\n  /** The validate on mount */\n  validateOnChange?: boolean;\n  /** The validate on mount */\n  validateOnMount?: boolean;\n}\n\n/** The use field register params type */\nexport interface UseFieldRegisterParams {\n  /** The required validation */\n  required?: string;\n  /** The custom validation */\n  validate?: (value: string) => Promise<string | true>;\n  /** The min value validation */\n  max?: {\n    value: number;\n    message: string;\n  };\n  /** The max length validation */\n  maxLength?: {\n    value: number;\n    message: string;\n  };\n  /** The max value validation */\n  min?: {\n    value: number;\n    message: string;\n  };\n  /** The min length validation */\n  minLength?: {\n    value: number;\n    message: string;\n  };\n  /** The pattern validation */\n  pattern?: {\n    value: RegExp;\n    message: string;\n  };\n}\n\n/** The use field return type */\nexport interface UseFieldReturn<Value> {\n  /** The dirty state */\n  dirty: boolean;\n  /** The error state */\n  error?: string;\n  /** The set error function */\n  touched: boolean;\n  /** The set error function */\n  clearError: () => void;\n  /** The focus function */\n  focus: () => void;\n  /** The get value function */\n  getValue: () => Value;\n  /** The register function */\n  register: (params?: UseFieldRegisterParams) => {\n    onBlur: () => void;\n    onChange: () => void;\n    ref: (\n      node: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | undefined\n    ) => void;\n  };\n  /** The reset function */\n  reset: () => void;\n  /** The set error function */\n  setError: (error: string) => void;\n  /** The  set value function */\n  setValue: (value: Value) => void;\n  /** The watch function */\n  watch: () => Value;\n}\n\n/**\n * @name useField\n * @description - Hook to manage a form field\n * @category Utilities\n *\n * @template Value The input value\n * @template Type The input value type\n * @param {Value} [params.initialValue] Initial value\n * @param {boolean} [params.initialTouched=false] Initial touched state\n * @param {boolean} [params.autoFocus=false] Auto focus\n * @param {boolean} [params.validateOnChange=false] Validate on change\n * @param {boolean} [params.validateOnBlur=false] Validate on blur\n * @param {boolean} [params.validateOnMount=false] Validate on mount\n * @returns {UseFieldReturn<Value>} An object containing input information\n *\n * @example\n * const { register, getValue, setValue, reset, dirty, error, setError, clearError, touched, focus, watch } = useField();\n */\nexport const useField = <\n  Value extends boolean | number | string = string,\n  Type = Value extends string ? string : Value extends boolean ? boolean : number\n>(\n  params?: UseFieldParams<Value>\n): UseFieldReturn<Type> => {\n  const initialValue = (params?.initialValue ?? '') as Value;\n\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const watchingRef = useRef(false);\n  const rerender = useRerender();\n\n  const [dirty, setDirty] = useState(false);\n  const [touched, setTouched] = useState(params?.initialTouched ?? false);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  const getValue = () => {\n    if (inputRef.current?.type === 'radio' || inputRef.current?.type === 'checkbox')\n      return inputRef.current.checked as Type;\n    return (inputRef.current?.value ?? initialValue) as Type;\n  };\n\n  const setValue = (value: Type) => {\n    if (inputRef.current?.type === 'radio' || inputRef.current?.type === 'checkbox') {\n      inputRef.current.checked = value as boolean;\n      if (watchingRef.current) return rerender();\n      return;\n    }\n\n    inputRef.current!.value = value as string;\n    if (watchingRef.current) return rerender();\n  };\n\n  const reset = () => {\n    setValue(initialValue as unknown as Type);\n    setDirty(false);\n    setTouched(false);\n    setError(undefined);\n  };\n\n  const focus = () => {\n    inputRef.current!.focus();\n  };\n\n  const validate = (params: UseFieldRegisterParams) => {\n    if (params.required && !inputRef.current!.value) {\n      return setError(params.required);\n    }\n\n    if (params.minLength && inputRef.current!.value.length < params.minLength.value) {\n      return setError(params.minLength.message);\n    }\n\n    if (params.maxLength && inputRef.current!.value.length > params.maxLength.value) {\n      return setError(params.maxLength.message);\n    }\n\n    if (params.min && Number(inputRef.current!.value) < params.min.value) {\n      return setError(params.min.message);\n    }\n\n    if (params.max && Number(inputRef.current!.value) > params.max.value) {\n      return setError(params.max.message);\n    }\n\n    if (params.pattern && !params.pattern.value.test(inputRef.current!.value)) {\n      return setError(params.pattern.message);\n    }\n\n    if (params.validate) {\n      const error = params.validate(inputRef.current!.value);\n      if (typeof error === 'string') return setError(error);\n    }\n\n    setError(undefined);\n  };\n\n  const register = (registerParams?: UseFieldRegisterParams) => ({\n    ref: (node: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | null | undefined) => {\n      if (!inputRef.current && node) {\n        if (params?.autoFocus) node.focus();\n        inputRef.current = node as HTMLInputElement;\n        if (inputRef.current.type === 'radio') {\n          inputRef.current.defaultChecked = params?.initialValue === node.value;\n          return;\n        }\n        if (inputRef.current.type === 'checkbox') {\n          inputRef.current.defaultChecked = !!params?.initialValue;\n          return;\n        }\n        inputRef.current.defaultValue = String(initialValue);\n\n        if (registerParams && params?.validateOnMount) validate(registerParams);\n      }\n    },\n    onChange: async () => {\n      if (watchingRef.current) return rerender();\n      if (inputRef.current!.value !== initialValue) setDirty(true);\n      if (dirty && inputRef.current!.value === initialValue) setDirty(false);\n      if (registerParams && params?.validateOnChange) await validate(registerParams);\n      if (registerParams && params?.validateOnBlur) setError(undefined);\n    },\n    onBlur: async () => {\n      if (registerParams && params?.validateOnBlur) await validate(registerParams);\n      setTouched(true);\n    }\n  });\n\n  const watch = () => {\n    watchingRef.current = true;\n    return getValue();\n  };\n\n  const clearError = () => setError(undefined);\n\n  return {\n    register,\n    dirty,\n    touched,\n    error,\n    setError,\n    clearError,\n    getValue,\n    setValue,\n    reset,\n    watch,\n    focus\n  };\n};\n"],"names":["useField","params","initialValue","inputRef","useRef","watchingRef","rerender","useRerender","dirty","setDirty","useState","touched","setTouched","error","setError","getValue","_a","_b","_c","setValue","value","reset","focus","validate","registerParams","node"],"mappings":"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"}

package/dist/esm/hooks/useFileDialog/useFileDialog.mjs

@@ -0,0 +1,36 @@
+import { useState as O, useRef as d, useEffect as S } from "react";
+const i = {
+  multiple: !0,
+  accept: "*",
+  reset: !1
+}, h = (...l) => {
+  const f = typeof l[0] == "function" ? l[0] : void 0, t = f ? l[0] : l[1], [y, n] = O(null), c = d(null), r = d(f);
+  r.current = f;
+  const v = () => {
+    var e;
+    n(null), (e = r.current) == null || e.call(r, null), c.current && (c.current.value = "");
+  }, D = (e) => {
+    if (!c.current) return;
+    c.current.multiple = (e == null ? void 0 : e.multiple) ?? (t == null ? void 0 : t.multiple) ?? i.multiple, c.current.accept = (e == null ? void 0 : e.accept) ?? (t == null ? void 0 : t.accept) ?? i.accept;
+    const u = (e == null ? void 0 : e.capture) ?? (t == null ? void 0 : t.capture);
+    u && (c.current.capture = u), ((e == null ? void 0 : e.reset) ?? (t == null ? void 0 : t.reset) ?? i.reset) && v(), c.current.click();
+  };
+  return S(() => {
+    const e = () => {
+      const u = document.createElement("input");
+      return u.type = "file", u.onchange = (F) => {
+        var E;
+        const { files: g } = F.target;
+        n(g), (E = r.current) == null || E.call(r, g);
+      }, u;
+    };
+    return c.current = e(), () => {
+      var u;
+      (u = c.current) == null || u.remove();
+    };
+  }, [t == null ? void 0 : t.multiple, t == null ? void 0 : t.accept, t == null ? void 0 : t.capture, t == null ? void 0 : t.reset]), { value: y, open: D, reset: v };
+};
+export {
+  h as useFileDialog
+};
+//# sourceMappingURL=useFileDialog.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFileDialog.mjs","sources":["../../../../src/hooks/useFileDialog/useFileDialog.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useRef, useState } from 'react';\n\n/* The use file dialog options */\nexport interface UseFileDialogOptions extends Pick<ComponentProps<'input'>, 'accept' | 'multiple'> {\n  /** The capture value */\n  capture?: string;\n  /** The reset value */\n  reset?: boolean;\n}\n\nconst DEFAULT_OPTIONS = {\n  multiple: true,\n  accept: '*',\n  reset: false\n} satisfies UseFileDialogOptions;\n\n/* The use file dialog return type */\nexport interface UseFileDialogReturn {\n  /** The selected files */\n  value: FileList | null;\n  /** The open function */\n  open: (openParams?: UseFileDialogOptions) => void;\n  /** The reset function */\n  reset: () => void;\n}\n\nexport interface UseFileDialog {\n  (\n    callback?: (value: FileList | null) => void,\n    options?: UseFileDialogOptions\n  ): UseFileDialogReturn;\n\n  (options?: UseFileDialogOptions, callback?: never): UseFileDialogReturn;\n}\n\n/**\n * @name useFileDialog\n * @description - Hook to handle file input\n * @category Browser\n *\n * @overload\n * @param {(value: FileList | null) => void} callback The callback to execute when a file is selected\n * @param {boolean} [options.multiple=true] Whether multiple files can be selected\n * @param {string} [options.accept='*'] The accepted file types\n * @param {boolean} [options.reset=false] Whether the input should be reset when the callback is called\n * @param {string} [options.capture] The capture value\n * @returns {UseFileDialogReturn} An object containing the selected files\n *\n * @example\n * const { values, open, reset } = useFileDialog((value) => console.log(value));\n *\n * @overload\n * @param {boolean} [options.multiple=true] Whether multiple files can be selected\n * @param {string} [options.accept='*'] The accepted file types\n * @param {boolean} [options.reset=false] Whether the input should be reset when the callback is called\n * @param {string} [options.capture] The capture value\n * @returns {UseFileDialogReturn} An object containing the selected files\n *\n * @example\n * const { values, open, reset } = useFileDialog({ accept: 'image/*' });\n */\nexport const useFileDialog = ((...params: any[]) => {\n  const callback = (typeof params[0] === 'function' ? params[0] : undefined) as\n    | ((value: FileList | null) => void)\n    | undefined;\n  const options = (callback ? params[0] : params[1]) as UseFileDialogOptions | undefined;\n\n  const [value, setValue] = useState<FileList | null>(null);\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  const reset = () => {\n    setValue(null);\n    internalCallbackRef.current?.(null);\n    if (inputRef.current) inputRef.current.value = '';\n  };\n\n  const open = (openParams?: UseFileDialogOptions) => {\n    if (!inputRef.current) return;\n\n    inputRef.current.multiple =\n      openParams?.multiple ?? options?.multiple ?? DEFAULT_OPTIONS.multiple;\n    inputRef.current.accept = openParams?.accept ?? options?.accept ?? DEFAULT_OPTIONS.accept;\n\n    const capture = openParams?.capture ?? options?.capture;\n    if (capture) inputRef.current.capture = capture;\n\n    if (openParams?.reset ?? options?.reset ?? DEFAULT_OPTIONS.reset) reset();\n\n    inputRef.current.click();\n  };\n\n  useEffect(() => {\n    const init = () => {\n      const input = document.createElement('input');\n      input.type = 'file';\n\n      input.onchange = (event: Event) => {\n        const { files } = event.target as HTMLInputElement;\n        setValue(files);\n        internalCallbackRef.current?.(files);\n      };\n      return input;\n    };\n\n    inputRef.current = init();\n    return () => {\n      inputRef.current?.remove();\n    };\n  }, [options?.multiple, options?.accept, options?.capture, options?.reset]);\n\n  return { value, open, reset };\n}) as UseFileDialog;\n"],"names":["DEFAULT_OPTIONS","useFileDialog","params","callback","options","value","setValue","useState","inputRef","useRef","internalCallbackRef","reset","_a","open","openParams","capture","useEffect","init","input","event","files"],"mappings":";AAYA,MAAMA,IAAkB;AAAA,EACtB,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AACT,GA+CaC,IAAiB,IAAIC,MAAkB;AAC5C,QAAAC,IAAY,OAAOD,EAAO,CAAC,KAAM,aAAaA,EAAO,CAAC,IAAI,QAG1DE,IAAWD,IAAWD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAE1C,CAACG,GAAOC,CAAQ,IAAIC,EAA0B,IAAI,GAClDC,IAAWC,EAAgC,IAAI,GAC/CC,IAAsBD,EAAON,CAAQ;AAC3C,EAAAO,EAAoB,UAAUP;AAE9B,QAAMQ,IAAQ,MAAM;;AAClB,IAAAL,EAAS,IAAI,IACbM,IAAAF,EAAoB,YAApB,QAAAE,EAAA,KAAAF,GAA8B,OAC1BF,EAAS,YAAkBA,EAAA,QAAQ,QAAQ;AAAA,EACjD,GAEMK,IAAO,CAACC,MAAsC;AAC9C,QAAA,CAACN,EAAS,QAAS;AAEvB,IAAAA,EAAS,QAAQ,YACfM,KAAA,gBAAAA,EAAY,cAAYV,KAAA,gBAAAA,EAAS,aAAYJ,EAAgB,UAC/DQ,EAAS,QAAQ,UAASM,KAAA,gBAAAA,EAAY,YAAUV,KAAA,gBAAAA,EAAS,WAAUJ,EAAgB;AAE7E,UAAAe,KAAUD,KAAA,gBAAAA,EAAY,aAAWV,KAAA,gBAAAA,EAAS;AAC5C,IAAAW,MAAkBP,EAAA,QAAQ,UAAUO,MAEpCD,KAAA,gBAAAA,EAAY,WAASV,KAAA,gBAAAA,EAAS,UAASJ,EAAgB,UAAaW,EAAA,GAExEH,EAAS,QAAQ,MAAM;AAAA,EACzB;AAEA,SAAAQ,EAAU,MAAM;AACd,UAAMC,IAAO,MAAM;AACX,YAAAC,IAAQ,SAAS,cAAc,OAAO;AAC5C,aAAAA,EAAM,OAAO,QAEPA,EAAA,WAAW,CAACC,MAAiB;;AAC3B,cAAA,EAAE,OAAAC,MAAUD,EAAM;AACxB,QAAAb,EAASc,CAAK,IACdR,IAAAF,EAAoB,YAApB,QAAAE,EAAA,KAAAF,GAA8BU;AAAA,MAChC,GACOF;AAAA,IACT;AAEA,WAAAV,EAAS,UAAUS,EAAK,GACjB,MAAM;;AACX,OAAAL,IAAAJ,EAAS,YAAT,QAAAI,EAAkB;AAAA,IACpB;AAAA,EAAA,GACC,CAACR,KAAA,gBAAAA,EAAS,UAAUA,KAAA,gBAAAA,EAAS,QAAQA,KAAA,gBAAAA,EAAS,SAASA,KAAA,gBAAAA,EAAS,KAAK,CAAC,GAElE,EAAE,OAAAC,GAAO,MAAAQ,GAAM,OAAAF,EAAM;AAC9B;"}

package/dist/esm/hooks/useFocus/useFocus.mjs

@@ -0,0 +1,40 @@
+import { useState as F, useRef as p, useEffect as L } from "react";
+import { useRefState as B } from "../useRefState/useRefState.mjs";
+import { isTarget as S } from "../../utils/helpers/isTarget.mjs";
+import { getElement as V } from "../../utils/helpers/getElement.mjs";
+const j = (...o) => {
+  const r = S(o[0]) ? o[0] : void 0, c = (r ? o[1] : o[0]) ?? {}, a = c.initialValue ?? !1, [m, d] = F(a), s = B(), i = p(c);
+  i.current = c;
+  const f = p(null), l = () => {
+    var e;
+    return (e = f.current) == null ? void 0 : e.focus();
+  }, v = () => {
+    var e;
+    return (e = f.current) == null ? void 0 : e.blur();
+  };
+  return L(() => {
+    if (!r && !s.state) return;
+    const e = r ? V(r) : s.current;
+    if (!e) return;
+    f.current = e;
+    const E = (u) => {
+      var t, n, R, g;
+      (n = (t = i.current) == null ? void 0 : t.onFocus) == null || n.call(t, u), (!l || (g = (R = u.target).matches) != null && g.call(R, ":focus-visible")) && d(!0);
+    }, b = (u) => {
+      var t, n;
+      (n = (t = i.current) == null ? void 0 : t.onBlur) == null || n.call(t, u), d(!1);
+    };
+    return a && e.focus(), e.addEventListener("focus", E), e.addEventListener("blur", b), () => {
+      e.removeEventListener("focus", E), e.removeEventListener("blur", b);
+    };
+  }, [r, s.state]), r ? { focus: l, blur: v, focused: m } : {
+    ref: s,
+    focus: l,
+    blur: v,
+    focused: m
+  };
+};
+export {
+  j as useFocus
+};
+//# sourceMappingURL=useFocus.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFocus.mjs","sources":["../../../../src/hooks/useFocus/useFocus.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use focus options type */\nexport interface UseFocusOptions {\n  /** The initial focus state of the target */\n  initialValue?: boolean;\n  /** The on blur callback */\n  onBlur?: (event: FocusEvent) => void;\n  /** The on focus callback */\n  onFocus?: (event: FocusEvent) => void;\n}\n\n/** The use focus return type */\nexport interface UseFocusReturn {\n  /** The boolean state value of the target */\n  focused: boolean;\n  /** Blur the target */\n  blur: () => void;\n  /** Focus the target */\n  focus: () => void;\n}\n\nexport interface UseFocus {\n  (target: HookTarget, options?: UseFocusOptions): UseFocusReturn;\n\n  <Target extends Element>(\n    options?: UseFocusOptions,\n    target?: never\n  ): UseFocusReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useFocus\n * @description - Hook that allows you to focus on a specific element\n * @category Browser\n *\n * @overload\n * @param {HookTarget} target The target element to focus\n * @param {boolean} [options.initialValue=false] The initial focus state of the target\n * @param {(event: FocusEvent) => void} [options.onFocus] The callback function to be invoked on focus\n * @param {(event: FocusEvent) => void} [options.onBlur] The callback function to be invoked on blur\n * @returns {UseFocusReturn} An object with focus state and methods\n *\n * @example\n * const { focus, blur, focused } = useFocus(ref);\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.initialValue=false] The initial focus state of the target\n * @param {(event: FocusEvent) => void} [options.onFocus] The callback function to be invoked on focus\n * @param {(event: FocusEvent) => void} [options.onBlur] The callback function to be invoked on blur\n * @returns {UseFocusReturn & { ref: StateRef<Target> }} An object with focus state, methods and ref\n *\n * @example\n * const { ref, focus, blur, focused } = useFocus();\n */\nexport const useFocus = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = ((target ? params[1] : params[0]) as UseFocusOptions) ?? {};\n  const initialValue = options.initialValue ?? false;\n\n  const [focused, setFocused] = useState(initialValue);\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  const elementRef = useRef<HTMLElement | null>(null);\n\n  const focus = () => elementRef.current?.focus();\n  const blur = () => elementRef.current?.blur();\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = (target ? getElement(target) : internalRef.current) as HTMLElement;\n    if (!element) return;\n\n    elementRef.current = element;\n\n    const onFocus = (event: FocusEvent) => {\n      internalOptionsRef.current?.onFocus?.(event);\n      if (!focus || (event.target as HTMLElement).matches?.(':focus-visible')) setFocused(true);\n    };\n\n    const onBlur = (event: FocusEvent) => {\n      internalOptionsRef.current?.onBlur?.(event);\n      setFocused(false);\n    };\n\n    if (initialValue) element.focus();\n\n    element.addEventListener('focus', onFocus);\n    element.addEventListener('blur', onBlur);\n\n    return () => {\n      element.removeEventListener('focus', onFocus);\n      element.removeEventListener('blur', onBlur);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return { focus, blur, focused };\n  return {\n    ref: internalRef,\n    focus,\n    blur,\n    focused\n  };\n}) as UseFocus;\n"],"names":["useFocus","params","target","isTarget","options","initialValue","focused","setFocused","useState","internalRef","useRefState","internalOptionsRef","useRef","elementRef","focus","_a","blur","useEffect","element","getElement","onFocus","event","_b","_d","_c","onBlur"],"mappings":";;;;AAgEa,MAAAA,IAAY,IAAIC,MAAkB;AACvC,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,KAAYF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,MAA0B,CAAC,GACpEI,IAAeD,EAAQ,gBAAgB,IAEvC,CAACE,GAASC,CAAU,IAAIC,EAASH,CAAY,GAC7CI,IAAcC,EAAqB,GACnCC,IAAqBC,EAAOR,CAAO;AACzC,EAAAO,EAAmB,UAAUP;AAEvB,QAAAS,IAAaD,EAA2B,IAAI,GAE5CE,IAAQ,MAAA;;AAAM,YAAAC,IAAAF,EAAW,YAAX,gBAAAE,EAAoB;AAAA,KAClCC,IAAO,MAAA;;AAAM,YAAAD,IAAAF,EAAW,YAAX,gBAAAE,EAAoB;AAAA;AA8BvC,SA5BAE,EAAU,MAAM;AACd,QAAI,CAACf,KAAU,CAACO,EAAY,MAAO;AACnC,UAAMS,IAAWhB,IAASiB,EAAWjB,CAAM,IAAIO,EAAY;AAC3D,QAAI,CAACS,EAAS;AAEd,IAAAL,EAAW,UAAUK;AAEf,UAAAE,IAAU,CAACC,MAAsB;;AAClB,OAAAC,KAAAP,IAAAJ,EAAA,YAAA,gBAAAI,EAAS,YAAT,QAAAO,EAAA,KAAAP,GAAmBM,KAClC,CAACP,MAAUS,KAAAC,IAAAH,EAAM,QAAuB,YAA7B,QAAAE,EAAA,KAAAC,GAAuC,wBAA8B,EAAI;AAAA,IAC1F,GAEMC,IAAS,CAACJ,MAAsB;;AACjB,OAAAC,KAAAP,IAAAJ,EAAA,YAAA,gBAAAI,EAAS,WAAT,QAAAO,EAAA,KAAAP,GAAkBM,IACrCd,EAAW,EAAK;AAAA,IAClB;AAEI,WAAAF,OAAsB,MAAM,GAExBa,EAAA,iBAAiB,SAASE,CAAO,GACjCF,EAAA,iBAAiB,QAAQO,CAAM,GAEhC,MAAM;AACH,MAAAP,EAAA,oBAAoB,SAASE,CAAO,GACpCF,EAAA,oBAAoB,QAAQO,CAAM;AAAA,IAC5C;AAAA,EACC,GAAA,CAACvB,GAAQO,EAAY,KAAK,CAAC,GAE1BP,IAAe,EAAE,OAAAY,GAAO,MAAAE,GAAM,SAAAV,EAAQ,IACnC;AAAA,IACL,KAAKG;AAAA,IACL,OAAAK;AAAA,IACA,MAAAE;AAAA,IACA,SAAAV;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useFps/useFps.mjs

@@ -0,0 +1,23 @@
+import { useState as i, useEffect as u } from "react";
+const p = () => {
+  const [s, m] = i(0);
+  return u(() => {
+    let e = 0, n = performance.now(), t;
+    const r = () => {
+      e += 1;
+      const o = performance.now(), a = o - n;
+      if (a >= 1e3) {
+        const c = Math.round(e * 1e3 / a);
+        m(c), e = 0, n = o;
+      }
+      t = requestAnimationFrame(r);
+    };
+    return t = requestAnimationFrame(r), () => {
+      cancelAnimationFrame(t);
+    };
+  }, []), s;
+};
+export {
+  p as useFps
+};
+//# sourceMappingURL=useFps.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFps.mjs","sources":["../../../../src/hooks/useFps/useFps.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * @name useFps\n * @description - Hook that measures frames per second\n * @category Sensors\n *\n * @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\n *\n * @returns {number} A number which determines frames per second\n *\n * @example\n * const fps = useFps();\n */\nexport const useFps = () => {\n  const [fps, setFps] = useState(0);\n\n  useEffect(() => {\n    let frameCount = 0;\n    let startTime = performance.now();\n    let rafId: number;\n\n    const onRequestAnimationFrame = () => {\n      frameCount += 1;\n      const currentTime = performance.now();\n      const elapsedTime = currentTime - startTime;\n\n      if (elapsedTime >= 1000) {\n        const calculatedFps = Math.round((frameCount * 1000) / elapsedTime);\n        setFps(calculatedFps);\n        frameCount = 0;\n        startTime = currentTime;\n      }\n\n      rafId = requestAnimationFrame(onRequestAnimationFrame);\n    };\n\n    rafId = requestAnimationFrame(onRequestAnimationFrame);\n\n    return () => {\n      cancelAnimationFrame(rafId);\n    };\n  }, []);\n\n  return fps;\n};\n"],"names":["useFps","fps","setFps","useState","useEffect","frameCount","startTime","rafId","onRequestAnimationFrame","currentTime","elapsedTime","calculatedFps"],"mappings":";AAcO,MAAMA,IAAS,MAAM;AAC1B,QAAM,CAACC,GAAKC,CAAM,IAAIC,EAAS,CAAC;AAEhC,SAAAC,EAAU,MAAM;AACd,QAAIC,IAAa,GACbC,IAAY,YAAY,IAAI,GAC5BC;AAEJ,UAAMC,IAA0B,MAAM;AACtB,MAAAH,KAAA;AACR,YAAAI,IAAc,YAAY,IAAI,GAC9BC,IAAcD,IAAcH;AAElC,UAAII,KAAe,KAAM;AACvB,cAAMC,IAAgB,KAAK,MAAON,IAAa,MAAQK,CAAW;AAClE,QAAAR,EAAOS,CAAa,GACPN,IAAA,GACDC,IAAAG;AAAA,MAAA;AAGd,MAAAF,IAAQ,sBAAsBC,CAAuB;AAAA,IACvD;AAEA,WAAAD,IAAQ,sBAAsBC,CAAuB,GAE9C,MAAM;AACX,2BAAqBD,CAAK;AAAA,IAC5B;AAAA,EACF,GAAG,EAAE,GAEEN;AACT;"}

package/dist/esm/hooks/useFullscreen/useFullscreen.mjs

@@ -0,0 +1,45 @@
+import { useState as m, useEffect as E } from "react";
+import r from "screenfull";
+import { useRefState as d } from "../useRefState/useRefState.mjs";
+import { isTarget as h } from "../../utils/helpers/isTarget.mjs";
+import { getElement as b } from "../../utils/helpers/getElement.mjs";
+const V = (...n) => {
+  const f = h(n[0]) ? n[0] : void 0, e = f ? n[1] : n[0], [c, g] = m((e == null ? void 0 : e.initialValue) ?? !1), o = d(), i = () => {
+    var t, l;
+    r.isEnabled && (r.isFullscreen ? (t = e == null ? void 0 : e.onEnter) == null || t.call(e) : (r.off("change", i), (l = e == null ? void 0 : e.onExit) == null || l.call(e)), g(r.isFullscreen));
+  }, s = () => {
+    const t = f ? b(f) : o.current;
+    if (t && r.isEnabled)
+      try {
+        r.request(t), r.on("change", i);
+      } catch (l) {
+        console.error(l);
+      }
+  }, u = () => {
+    r.isEnabled && r.exit();
+  }, a = () => {
+    if (c) return u();
+    s();
+  };
+  return E(
+    () => () => {
+      r.isEnabled && r.off("change", i);
+    },
+    []
+  ), f ? {
+    enter: s,
+    exit: u,
+    toggle: a,
+    value: c
+  } : {
+    ref: o,
+    enter: s,
+    exit: u,
+    toggle: a,
+    value: c
+  };
+};
+export {
+  V as useFullscreen
+};
+//# sourceMappingURL=useFullscreen.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFullscreen.mjs","sources":["../../../../src/hooks/useFullscreen/useFullscreen.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\nimport screenfull from 'screenfull';\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 fullscreen options type */\nexport interface UseFullScreenOptions {\n  /** initial value */\n  initialValue?: boolean;\n  /** on enter fullscreen */\n  onEnter?: () => void;\n  /** on exit fullscreen */\n  onExit?: () => void;\n}\n\n/** The use click outside return type */\nexport interface UseFullScreenReturn {\n  /** The fullscreen state */\n  value: boolean;\n  /** The fullscreen enter method */\n  enter: () => void;\n  /** The fullscreen exit method */\n  exit: () => void;\n  /** The fullscreen toggle method */\n  toggle: () => void;\n}\n\nexport interface UseFullScreen {\n  (target: HookTarget, options?: UseFullScreenOptions): UseFullScreenReturn;\n\n  <Target extends Element>(\n    options?: UseFullScreenOptions,\n    target?: never\n  ): UseFullScreenReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useFullscreen\n * @description - Hook to handle fullscreen events\n * @category Browser\n *\n * @overload\n * @param {HookTarget} target The target element for fullscreen\n * @param {boolean} [options.initialValue=false] initial value of fullscreen\n * @param {() => void} [options.onEnter] on enter fullscreen\n * @param {() => void} [options.onExit] on exit fullscreen\n * @returns {UseFullScreenReturn} An object with the fullscreen state and methods\n *\n * @example\n * const { enter, exit, toggle, value } = useFullscreen(ref);\n *\n * @overload\n * @template Target The target element for fullscreen\n * @param {boolean} [options.initialValue=false] initial value of fullscreen\n * @param {() => void} [options.onEnter] on enter fullscreen\n * @param {() => void} [options.onExit] on exit fullscreen\n * @returns {UseFullScreenReturn & { ref: RefObject<Target> }} An object with the fullscreen state and methods\n *\n * @example\n * const { ref, enter, exit, toggle, value } = useFullscreen();\n */\nexport const useFullscreen = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseFullScreenOptions | undefined;\n\n  const [value, setValue] = useState(options?.initialValue ?? false);\n  const internalRef = useRefState<Element>();\n\n  const onChange = () => {\n    if (!screenfull.isEnabled) return;\n\n    if (screenfull.isFullscreen) {\n      options?.onEnter?.();\n    } else {\n      screenfull.off('change', onChange);\n      options?.onExit?.();\n    }\n\n    setValue(screenfull.isFullscreen);\n  };\n\n  const enter = () => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    if (screenfull.isEnabled) {\n      try {\n        screenfull.request(element);\n        screenfull.on('change', onChange);\n      } catch (error) {\n        console.error(error);\n      }\n    }\n  };\n\n  const exit = () => {\n    if (screenfull.isEnabled) screenfull.exit();\n  };\n\n  const toggle = () => {\n    if (value) return exit();\n    enter();\n  };\n\n  useEffect(\n    () => () => {\n      if (screenfull.isEnabled) screenfull.off('change', onChange);\n    },\n    []\n  );\n\n  if (target)\n    return {\n      enter,\n      exit,\n      toggle,\n      value\n    };\n  return {\n    ref: internalRef,\n    enter,\n    exit,\n    toggle,\n    value\n  };\n}) as UseFullScreen;\n"],"names":["useFullscreen","params","target","isTarget","options","value","setValue","useState","internalRef","useRefState","onChange","screenfull","_a","_b","enter","element","getElement","error","exit","toggle","useEffect"],"mappings":";;;;;AAmEa,MAAAA,IAAiB,IAAIC,MAAkB;AAC5C,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExC,CAACI,GAAOC,CAAQ,IAAIC,GAASH,KAAA,gBAAAA,EAAS,iBAAgB,EAAK,GAC3DI,IAAcC,EAAqB,GAEnCC,IAAW,MAAM;;AACjB,IAACC,EAAW,cAEZA,EAAW,gBACbC,IAAAR,KAAA,gBAAAA,EAAS,YAAT,QAAAQ,EAAA,KAAAR,MAEWO,EAAA,IAAI,UAAUD,CAAQ,IACjCG,IAAAT,KAAA,gBAAAA,EAAS,WAAT,QAAAS,EAAA,KAAAT,KAGFE,EAASK,EAAW,YAAY;AAAA,EAClC,GAEMG,IAAQ,MAAM;AAClB,UAAMC,IAAWb,IAASc,EAAWd,CAAM,IAAIM,EAAY;AAC3D,QAAKO,KAEDJ,EAAW;AACT,UAAA;AACF,QAAAA,EAAW,QAAQI,CAAO,GACfJ,EAAA,GAAG,UAAUD,CAAQ;AAAA,eACzBO,GAAO;AACd,gBAAQ,MAAMA,CAAK;AAAA,MAAA;AAAA,EAGzB,GAEMC,IAAO,MAAM;AACb,IAAAP,EAAW,aAAWA,EAAW,KAAK;AAAA,EAC5C,GAEMQ,IAAS,MAAM;AACf,QAAAd,UAAca,EAAK;AACjB,IAAAJ,EAAA;AAAA,EACR;AASI,SAPJM;AAAA,IACE,MAAM,MAAM;AACV,MAAIT,EAAW,aAAsBA,EAAA,IAAI,UAAUD,CAAQ;AAAA,IAC7D;AAAA,IACA,CAAA;AAAA,EACF,GAEIR,IACK;AAAA,IACL,OAAAY;AAAA,IACA,MAAAI;AAAA,IACA,QAAAC;AAAA,IACA,OAAAd;AAAA,EACF,IACK;AAAA,IACL,KAAKG;AAAA,IACL,OAAAM;AAAA,IACA,MAAAI;AAAA,IACA,QAAAC;AAAA,IACA,OAAAd;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useGamepad/useGamepad.mjs

@@ -0,0 +1,79 @@
+import { useState as f, useEffect as a } from "react";
+import { useRaf as v } from "../useRaf/useRaf.mjs";
+const x = () => {
+  const t = typeof navigator < "u" && "getGamepads" in navigator, [s, r] = f({}), u = (n) => {
+    const o = [], e = "vibrationActuator" in n ? n.vibrationActuator : null;
+    return e && o.push(e), n.hapticActuators && o.push(...n.hapticActuators), {
+      ...n,
+      hapticActuators: o
+    };
+  }, b = () => {
+    for (const n of navigator.getGamepads() ?? [])
+      n && s[n.index] && (s[n.index] = u(n));
+  }, { active: d } = v(b, { enabled: !!Object.keys(s).length });
+  return a(() => {
+    if (!t) return;
+    const n = navigator.getGamepads();
+    r(
+      n.reduce(
+        (o, e) => ({ ...o, ...e && { [e.index]: u(e) } }),
+        {}
+      )
+    );
+  }, []), a(() => {
+    const n = (e) => {
+      const { gamepad: c } = e;
+      r({ ...s, [c.index]: u(c) });
+    }, o = (e) => {
+      const { gamepad: c } = e, i = { ...s };
+      delete i[c.index], r(i);
+    };
+    return document.addEventListener("gamepadconnected", n), document.addEventListener("gamepaddisconnected", o), () => {
+      document.removeEventListener("gamepadconnected", n), document.removeEventListener("gamepaddisconnected", o);
+    };
+  }, []), {
+    active: d,
+    supported: t,
+    gamepads: Object.values(s)
+  };
+}, p = (t) => ({
+  buttons: {
+    a: t.buttons[0],
+    b: t.buttons[1],
+    x: t.buttons[2],
+    y: t.buttons[3]
+  },
+  bumper: {
+    left: t.buttons[4],
+    right: t.buttons[5]
+  },
+  triggers: {
+    left: t.buttons[6],
+    right: t.buttons[7]
+  },
+  stick: {
+    left: {
+      horizontal: t.axes[0],
+      vertical: t.axes[1],
+      button: t.buttons[10]
+    },
+    right: {
+      horizontal: t.axes[2],
+      vertical: t.axes[3],
+      button: t.buttons[11]
+    }
+  },
+  dpad: {
+    up: t.buttons[12],
+    down: t.buttons[13],
+    left: t.buttons[14],
+    right: t.buttons[15]
+  },
+  back: t.buttons[8],
+  start: t.buttons[9]
+});
+export {
+  p as mapGamepadToXbox360Controller,
+  x as useGamepad
+};
+//# sourceMappingURL=useGamepad.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGamepad.mjs","sources":["../../../../src/hooks/useGamepad/useGamepad.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { useRaf } from '../useRaf/useRaf';\n\ndeclare global {\n  interface Gamepad {\n    hapticActuators?: GamepadHapticActuator[];\n  }\n}\n\n/** The use gamepad return type  */\nexport interface UseGamepadStateReturn {\n  /** The gamepad active status */\n  active: boolean;\n  /** The gamepad state */\n  gamepads: Gamepad[];\n  /** The gamepad supported status */\n  supported: boolean;\n}\n\n/**\n * @name useGamepad\n * @description - Hook for getting information about gamepad\n * @category Browser\n *\n * @browserapi navigator.getGamepads https://developer.mozilla.org/en-US/docs/Web/API/Navigator/getGamepads\n *\n * @returns {UseGamepadStateReturn} An object containing the gamepad information\n *\n * @example\n * const { supported, gamepads, active } = useGamepad();\n */\nexport const useGamepad = () => {\n  const supported = typeof navigator !== 'undefined' && 'getGamepads' in navigator;\n  const [gamepads, setGamepads] = useState<Record<number, Gamepad>>({});\n\n  const createGamepad = (gamepad: Gamepad) => {\n    const hapticActuators = [];\n    const vibrationActuator = 'vibrationActuator' in gamepad ? gamepad.vibrationActuator : null;\n\n    if (vibrationActuator) hapticActuators.push(vibrationActuator);\n    if (gamepad.hapticActuators) hapticActuators.push(...gamepad.hapticActuators);\n\n    return {\n      ...gamepad,\n      hapticActuators\n    } as Gamepad;\n  };\n\n  const updateGamepadState = () => {\n    for (const gamepad of navigator.getGamepads() ?? []) {\n      if (gamepad && gamepads[gamepad.index]) gamepads[gamepad.index] = createGamepad(gamepad);\n    }\n  };\n\n  const { active } = useRaf(updateGamepadState, { enabled: !!Object.keys(gamepads).length });\n\n  useEffect(() => {\n    if (!supported) return;\n    const gamepads = navigator.getGamepads();\n    setGamepads(\n      gamepads.reduce(\n        (acc, gamepad) => ({ ...acc, ...(gamepad && { [gamepad.index]: createGamepad(gamepad) }) }),\n        {}\n      )\n    );\n  }, []);\n\n  useEffect(() => {\n    const onConnected = (event: Event) => {\n      const { gamepad } = event as GamepadEvent;\n      setGamepads({ ...gamepads, [gamepad.index]: createGamepad(gamepad) });\n    };\n\n    const onDisconnected = (event: Event) => {\n      const { gamepad } = event as GamepadEvent;\n      const updatedGamepads = { ...gamepads };\n      delete updatedGamepads[gamepad.index];\n      setGamepads(updatedGamepads);\n    };\n\n    document.addEventListener('gamepadconnected', onConnected);\n    document.addEventListener('gamepaddisconnected', onDisconnected);\n\n    return () => {\n      document.removeEventListener('gamepadconnected', onConnected);\n      document.removeEventListener('gamepaddisconnected', onDisconnected);\n    };\n  }, []);\n\n  return {\n    active,\n    supported,\n    gamepads: Object.values(gamepads)\n  };\n};\n\nexport const mapGamepadToXbox360Controller = (gamepad: Gamepad) => ({\n  buttons: {\n    a: gamepad.buttons[0],\n    b: gamepad.buttons[1],\n    x: gamepad.buttons[2],\n    y: gamepad.buttons[3]\n  },\n  bumper: {\n    left: gamepad.buttons[4],\n    right: gamepad.buttons[5]\n  },\n  triggers: {\n    left: gamepad.buttons[6],\n    right: gamepad.buttons[7]\n  },\n  stick: {\n    left: {\n      horizontal: gamepad.axes[0],\n      vertical: gamepad.axes[1],\n      button: gamepad.buttons[10]\n    },\n    right: {\n      horizontal: gamepad.axes[2],\n      vertical: gamepad.axes[3],\n      button: gamepad.buttons[11]\n    }\n  },\n  dpad: {\n    up: gamepad.buttons[12],\n    down: gamepad.buttons[13],\n    left: gamepad.buttons[14],\n    right: gamepad.buttons[15]\n  },\n  back: gamepad.buttons[8],\n  start: gamepad.buttons[9]\n});\n"],"names":["useGamepad","supported","gamepads","setGamepads","useState","createGamepad","gamepad","hapticActuators","vibrationActuator","updateGamepadState","active","useRaf","useEffect","acc","onConnected","event","onDisconnected","updatedGamepads","mapGamepadToXbox360Controller"],"mappings":"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"}

package/dist/esm/hooks/useGeolocation/useGeolocation.mjs

@@ -0,0 +1,46 @@
+import { useState as g, useEffect as a } from "react";
+const I = (t) => {
+  const [n, u] = g({
+    loading: !0,
+    error: null,
+    timestamp: Date.now(),
+    accuracy: 0,
+    latitude: Number.POSITIVE_INFINITY,
+    longitude: Number.POSITIVE_INFINITY,
+    altitude: null,
+    altitudeAccuracy: null,
+    heading: null,
+    speed: null
+  });
+  return a(() => {
+    const l = ({ coords: e, timestamp: o }) => {
+      u({
+        ...n,
+        loading: !1,
+        timestamp: o,
+        latitude: e.latitude,
+        longitude: e.longitude,
+        altitude: e.altitude,
+        accuracy: e.accuracy,
+        altitudeAccuracy: e.altitudeAccuracy,
+        heading: e.heading,
+        speed: e.speed
+      });
+    }, i = (e) => {
+      u({
+        ...n,
+        loading: !1,
+        error: e
+      });
+    };
+    navigator.geolocation.getCurrentPosition(l, i, t);
+    const c = navigator.geolocation.watchPosition(l, i, t);
+    return () => {
+      navigator.geolocation.clearWatch(c);
+    };
+  }, [t == null ? void 0 : t.enableHighAccuracy, t == null ? void 0 : t.maximumAge, t == null ? void 0 : t.timeout]), n;
+};
+export {
+  I as useGeolocation
+};
+//# sourceMappingURL=useGeolocation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGeolocation.mjs","sources":["../../../../src/hooks/useGeolocation/useGeolocation.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use geolocation return type */\nexport interface UseGeolocationReturn {\n  /** The accuracy of the last position update */\n  accuracy: number | null;\n  /** The altitude of the last position update */\n  altitude: number | null;\n  /** The altitude accuracy of the last position update */\n  altitudeAccuracy: number | null;\n  /** The error of the last position update */\n  error: GeolocationPositionError | null;\n  /** The heading of the last position update */\n  heading: number | null;\n  /** The latitude of the last position update */\n  latitude: number | null;\n  /** The loading state */\n  loading: boolean;\n  /** The longitude of the last position update */\n  longitude: number | null;\n  /** The speed of the last position update */\n  speed: number | null;\n  /** The timestamp of the last position update */\n  timestamp: number | null;\n}\n\n/** The use geolocation params type */\nexport type UseGeolocationParams = PositionOptions;\n\n/**\n * @name useGeolocation\n * @description - Hook that returns the current geolocation\n * @category Browser\n *\n * @browserapi navigator.geolocation https://developer.mozilla.org/en-US/docs/Web/API/Navigator/geolocation\n *\n * @param {boolean} [params.enableHighAccuracy] Enable high accuracy\n * @param {number} [params.maximumAge] Maximum age\n * @param {number} [params.timeout] Timeout\n * @returns {UseGeolocationReturn}\n *\n * @example\n * const { loading, error, timestamp, accuracy, latitude, longitude, altitude, altitudeAccuracy, heading, speed } = useGeolocation();\n */\nexport const useGeolocation = (params?: UseGeolocationParams): UseGeolocationReturn => {\n  const [value, setValue] = useState<UseGeolocationReturn>({\n    loading: true,\n    error: null,\n    timestamp: Date.now(),\n    accuracy: 0,\n    latitude: Number.POSITIVE_INFINITY,\n    longitude: Number.POSITIVE_INFINITY,\n    altitude: null,\n    altitudeAccuracy: null,\n    heading: null,\n    speed: null\n  });\n\n  useEffect(() => {\n    const onEvent = ({ coords, timestamp }: GeolocationPosition) => {\n      setValue({\n        ...value,\n        loading: false,\n        timestamp,\n        latitude: coords.latitude,\n        longitude: coords.longitude,\n        altitude: coords.altitude,\n        accuracy: coords.accuracy,\n        altitudeAccuracy: coords.altitudeAccuracy,\n        heading: coords.heading,\n        speed: coords.speed\n      });\n    };\n\n    const onEventError = (error: GeolocationPositionError) => {\n      setValue({\n        ...value,\n        loading: false,\n        error\n      });\n    };\n\n    navigator.geolocation.getCurrentPosition(onEvent, onEventError, params);\n    const watchId = navigator.geolocation.watchPosition(onEvent, onEventError, params);\n\n    return () => {\n      navigator.geolocation.clearWatch(watchId);\n    };\n  }, [params?.enableHighAccuracy, params?.maximumAge, params?.timeout]);\n\n  return value;\n};\n"],"names":["useGeolocation","params","value","setValue","useState","useEffect","onEvent","coords","timestamp","onEventError","error","watchId"],"mappings":";AA4Ca,MAAAA,IAAiB,CAACC,MAAwD;AACrF,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAA+B;AAAA,IACvD,SAAS;AAAA,IACT,OAAO;AAAA,IACP,WAAW,KAAK,IAAI;AAAA,IACpB,UAAU;AAAA,IACV,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,UAAU;AAAA,IACV,kBAAkB;AAAA,IAClB,SAAS;AAAA,IACT,OAAO;AAAA,EAAA,CACR;AAED,SAAAC,EAAU,MAAM;AACd,UAAMC,IAAU,CAAC,EAAE,QAAAC,GAAQ,WAAAC,QAAqC;AACrD,MAAAL,EAAA;AAAA,QACP,GAAGD;AAAA,QACH,SAAS;AAAA,QACT,WAAAM;AAAA,QACA,UAAUD,EAAO;AAAA,QACjB,WAAWA,EAAO;AAAA,QAClB,UAAUA,EAAO;AAAA,QACjB,UAAUA,EAAO;AAAA,QACjB,kBAAkBA,EAAO;AAAA,QACzB,SAASA,EAAO;AAAA,QAChB,OAAOA,EAAO;AAAA,MAAA,CACf;AAAA,IACH,GAEME,IAAe,CAACC,MAAoC;AAC/C,MAAAP,EAAA;AAAA,QACP,GAAGD;AAAA,QACH,SAAS;AAAA,QACT,OAAAQ;AAAA,MAAA,CACD;AAAA,IACH;AAEA,cAAU,YAAY,mBAAmBJ,GAASG,GAAcR,CAAM;AACtE,UAAMU,IAAU,UAAU,YAAY,cAAcL,GAASG,GAAcR,CAAM;AAEjF,WAAO,MAAM;AACD,gBAAA,YAAY,WAAWU,CAAO;AAAA,IAC1C;AAAA,EAAA,GACC,CAACV,KAAA,gBAAAA,EAAQ,oBAAoBA,KAAA,gBAAAA,EAAQ,YAAYA,KAAA,gBAAAA,EAAQ,OAAO,CAAC,GAE7DC;AACT;"}

package/dist/esm/hooks/useHash/useHash.mjs

@@ -0,0 +1,16 @@
+import { useState as h, useEffect as a } from "react";
+const o = () => decodeURIComponent(window.location.hash.replace("#", "")), r = () => {
+  const [t, n] = h(window ? o() : ""), s = (e) => {
+    window.location.hash = e, n(e);
+  };
+  return a(() => {
+    const e = () => n(o());
+    return window.addEventListener("hashchange", e), () => {
+      window.removeEventListener("hashchange", e);
+    };
+  }), [t, s];
+};
+export {
+  r as useHash
+};
+//# sourceMappingURL=useHash.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHash.mjs","sources":["../../../../src/hooks/useHash/useHash.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nconst getHash = () => decodeURIComponent(window.location.hash.replace('#', ''));\n\n/** The use hash return type */\ntype UseHashReturn = [string, (value: string) => void];\n\n/**\n * @name useHash\n * @description - Hook that manages the hash value\n * @category Browser\n *\n * @returns {UseHashReturn} An array containing the hash value and a function to set the hash value\n *\n * @example\n * const [hash, setHash] = useHash();\n */\nexport const useHash = (): UseHashReturn => {\n  const [hash, setHash] = useState(window ? getHash() : '');\n\n  const set = (value: string) => {\n    window.location.hash = value;\n    setHash(value);\n  };\n\n  useEffect(() => {\n    const onHashChange = () => setHash(getHash());\n    window.addEventListener('hashchange', onHashChange);\n    return () => {\n      window.removeEventListener('hashchange', onHashChange);\n    };\n  });\n\n  return [hash, set] as const;\n};\n"],"names":["getHash","useHash","hash","setHash","useState","set","value","useEffect","onHashChange"],"mappings":";AAEA,MAAMA,IAAU,MAAM,mBAAmB,OAAO,SAAS,KAAK,QAAQ,KAAK,EAAE,CAAC,GAejEC,IAAU,MAAqB;AACpC,QAAA,CAACC,GAAMC,CAAO,IAAIC,EAAS,SAASJ,MAAY,EAAE,GAElDK,IAAM,CAACC,MAAkB;AAC7B,WAAO,SAAS,OAAOA,GACvBH,EAAQG,CAAK;AAAA,EACf;AAEA,SAAAC,EAAU,MAAM;AACd,UAAMC,IAAe,MAAML,EAAQH,GAAS;AACrC,kBAAA,iBAAiB,cAAcQ,CAAY,GAC3C,MAAM;AACJ,aAAA,oBAAoB,cAAcA,CAAY;AAAA,IACvD;AAAA,EAAA,CACD,GAEM,CAACN,GAAMG,CAAG;AACnB;"}

package/dist/esm/hooks/useHotkeys/useHotkeys.mjs

@@ -0,0 +1,33 @@
+import { useRef as L, useEffect as w } from "react";
+import { useEvent as m } from "../useEvent/useEvent.mjs";
+import { useRefState as E } from "../useRefState/useRefState.mjs";
+import { isTarget as h } from "../../utils/helpers/isTarget.mjs";
+import { getElement as g } from "../../utils/helpers/getElement.mjs";
+const v = (t, r) => t.toLowerCase().split(/[+_,\-]/g).map((o) => o.trim()).every(
+  (o) => r.find(
+    (c) => o === c.code.toLocaleLowerCase() || o === c.key.toLocaleLowerCase() || o === c.alias.toLocaleLowerCase()
+  )
+), x = (...t) => {
+  const r = h(t[0]) ? t[0] : void 0, o = r ? t[1] : t[0], c = r ? t[2] : t[1], n = r ? t[3] : t[2], u = E(window), s = L([]), f = (n == null ? void 0 : n.enabled) ?? !0, l = m((e) => {
+    var k;
+    if (!f || s.current.some(({ code: i }) => i === e.code)) return;
+    const d = ((k = n == null ? void 0 : n.alias) == null ? void 0 : k[e.key]) ?? e.code, y = [...s.current, { key: e.key, code: e.code, alias: d }];
+    s.current = y, o.split(",").map((i) => i.trim()).some((i) => v(i, y)) && (e.preventDefault(), c(e));
+  }), a = m((e) => {
+    f && (s.current = s.current.filter(({ code: d }) => d !== e.code));
+  });
+  if (w(() => {
+    if (s.current = [], !r && !u.state && !f) return;
+    const e = r ? g(r) : u.current;
+    if (e)
+      return e.addEventListener("keydown", l), e.addEventListener("keyup", a), () => {
+        e.removeEventListener("keydown", l), e.removeEventListener("keyup", a);
+      };
+  }, [r, u.state, f, o, l, a]), !r)
+    return u;
+};
+export {
+  v as isHotkeyMatch,
+  x as useHotkeys
+};
+//# sourceMappingURL=useHotkeys.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHotkeys.mjs","sources":["../../../../src/hooks/useHotkeys/useHotkeys.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 { useEvent } from '../useEvent/useEvent';\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use hotkeys params type */\nexport interface UseHotkeysOptions {\n  /** Alias map for hotkeys */\n  alias?: Record<string, string>;\n  /** Enable or disable the event listeners */\n  enabled?: boolean;\n}\n\nexport const isHotkeyMatch = (hotkey: string, keys: UseHotkeysKey[]) =>\n  hotkey\n    .toLowerCase()\n    .split(/[+_,\\-]/g)\n    .map((key) => key.trim())\n    .every((key) =>\n      keys.find(\n        (updatedKey) =>\n          key === updatedKey.code.toLocaleLowerCase() ||\n          key === updatedKey.key.toLocaleLowerCase() ||\n          key === updatedKey.alias.toLocaleLowerCase()\n      )\n    );\n\n/** The hotkeys string type */\nexport type UseHotkeysHotkeys = string;\n\n/** The hotkey key information */\nexport interface UseHotkeysKey {\n  /** The alias for the key */\n  alias: string;\n  /** The key code */\n  code: string;\n  /** The key value */\n  key: string;\n}\n\n/** The use hotkeys target type */\nexport type UseHotkeysTarget = Element | React.RefObject<Element | null | undefined>;\n\nexport interface UseHotkeys {\n  (\n    target: UseHotkeysTarget,\n    hotkeys: UseHotkeysHotkeys,\n    callback: (event: KeyboardEvent) => void,\n    options?: UseHotkeysOptions\n  ): void;\n\n  <Target extends Element>(\n    hotkeys: UseHotkeysHotkeys,\n    callback: (event: KeyboardEvent) => void,\n    options?: UseHotkeysOptions,\n    target?: never\n  ): StateRef<Target>;\n}\n\n/**\n * @name useHotkeys\n * @description - Hook that listens for hotkeys\n * @category Sensors\n *\n * @overload\n * @param {HookTarget} [target=window] The target element to attach the event listener to\n * @param {string} hotkeys The hotkey to listen for\n * @param {(event: KeyboardEvent) => void} callback The callback function to execute when hotkey is pressed\n * @param {Record<string, string>} [options.alias] Alias map for hotkeys\n * @param {boolean} [options.enabled=true] Enable or disable the event listeners\n * @returns {void}\n *\n * @example\n * useHotkeys(ref, 'ctrl+a', () => console.log('hotkey pressed'));\n * @example\n * useHotkeys(ref, 'ctrl+a, ctrl+b', () => console.log('hotkey pressed'));\n *\n * @overload\n * @template Target The target element\n * @param {string} hotkeys The hotkey to listen for\n * @param {(event: KeyboardEvent) => void} callback The callback function to execute when hotkey is pressed\n * @param {Record<string, string>} [options.alias] Alias map for hotkeys\n * @param {boolean} [options.enabled=true] Enable or disable the event listeners\n * @returns {StateRef<Target>} A reference to the target element\n *\n * @example\n * const ref = useHotkeys('ctrl+a', () => console.log('hotkey pressed'));\n * @example\n * const ref = useHotkeys('ctrl+a, ctrl+b', () => console.log('hotkey pressed'));\n */\nexport const useHotkeys = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const hotkeys = (target ? params[1] : params[0]) as UseHotkeysHotkeys;\n  const callback = (target ? params[2] : params[1]) as (event: KeyboardEvent) => void;\n  const options = (target ? params[3] : params[2]) as UseHotkeysOptions | undefined;\n\n  const internalRef = useRefState(window);\n  const keysRef = useRef<UseHotkeysKey[]>([]);\n  const enabled = options?.enabled ?? true;\n\n  const onKeyDown = useEvent((event: KeyboardEvent) => {\n    if (!enabled) return;\n\n    if (keysRef.current.some(({ code }) => code === event.code)) return;\n\n    const alias = options?.alias?.[event.key] ?? event.code;\n    const updatedKeys = [...keysRef.current, { key: event.key, code: event.code, alias }];\n    keysRef.current = updatedKeys;\n\n    const hotkeysList = hotkeys.split(',').map((h) => h.trim());\n    const isMatch = hotkeysList.some((hotkey) => isHotkeyMatch(hotkey, updatedKeys));\n    if (!isMatch) return;\n    event.preventDefault();\n    callback(event);\n  });\n\n  const onKeyUp = useEvent((event: KeyboardEvent) => {\n    if (!enabled) return;\n    keysRef.current = keysRef.current.filter(({ code }) => code !== event.code);\n  });\n\n  useEffect(() => {\n    keysRef.current = [];\n    if (!target && !internalRef.state && !enabled) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    element.addEventListener('keydown', onKeyDown as EventListener);\n    element.addEventListener('keyup', onKeyUp as EventListener);\n\n    return () => {\n      element.removeEventListener('keydown', onKeyDown as EventListener);\n      element.removeEventListener('keyup', onKeyUp as EventListener);\n    };\n  }, [target, internalRef.state, enabled, hotkeys, onKeyDown, onKeyUp]);\n\n  if (target) return;\n  return internalRef;\n}) as UseHotkeys;\n"],"names":["isHotkeyMatch","hotkey","keys","key","updatedKey","useHotkeys","params","target","isTarget","hotkeys","callback","options","internalRef","useRefState","keysRef","useRef","enabled","onKeyDown","useEvent","event","code","alias","_a","updatedKeys","h","onKeyUp","useEffect","element","getElement"],"mappings":";;;;;AAmBO,MAAMA,IAAgB,CAACC,GAAgBC,MAC5CD,EACG,YACA,EAAA,MAAM,UAAU,EAChB,IAAI,CAACE,MAAQA,EAAI,KAAA,CAAM,EACvB;AAAA,EAAM,CAACA,MACND,EAAK;AAAA,IACH,CAACE,MACCD,MAAQC,EAAW,KAAK,kBAAkB,KAC1CD,MAAQC,EAAW,IAAI,kBAAkB,KACzCD,MAAQC,EAAW,MAAM,kBAAkB;AAAA,EAAA;AAEjD,GAiESC,IAAc,IAAIC,MAAkB;AACzC,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,IAAYH,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACzCK,IAAWJ,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCM,IAAcC,EAAY,MAAM,GAChCC,IAAUC,EAAwB,EAAE,GACpCC,KAAUL,KAAA,gBAAAA,EAAS,YAAW,IAE9BM,IAAYC,EAAS,CAACC,MAAyB;;AAG/C,QAFA,CAACH,KAEDF,EAAQ,QAAQ,KAAK,CAAC,EAAE,MAAAM,QAAWA,MAASD,EAAM,IAAI,EAAG;AAE7D,UAAME,MAAQC,IAAAX,KAAA,gBAAAA,EAAS,UAAT,gBAAAW,EAAiBH,EAAM,SAAQA,EAAM,MAC7CI,IAAc,CAAC,GAAGT,EAAQ,SAAS,EAAE,KAAKK,EAAM,KAAK,MAAMA,EAAM,MAAM,OAAAE,GAAO;AAKpF,IAJAP,EAAQ,UAAUS,GAEEd,EAAQ,MAAM,GAAG,EAAE,IAAI,CAACe,MAAMA,EAAE,MAAM,EAC9B,KAAK,CAACvB,MAAWD,EAAcC,GAAQsB,CAAW,CAAC,MAE/EJ,EAAM,eAAe,GACrBT,EAASS,CAAK;AAAA,EAAA,CACf,GAEKM,IAAUP,EAAS,CAACC,MAAyB;AACjD,IAAKH,MACGF,EAAA,UAAUA,EAAQ,QAAQ,OAAO,CAAC,EAAE,MAAAM,QAAWA,MAASD,EAAM,IAAI;AAAA,EAAA,CAC3E;AAkBD,MAhBAO,EAAU,MAAM;AAEd,QADAZ,EAAQ,UAAU,CAAC,GACf,CAACP,KAAU,CAACK,EAAY,SAAS,CAACI,EAAS;AAE/C,UAAMW,IAAWpB,IAASqB,EAAWrB,CAAM,IAAIK,EAAY;AAC3D,QAAKe;AAEG,aAAAA,EAAA,iBAAiB,WAAWV,CAA0B,GACtDU,EAAA,iBAAiB,SAASF,CAAwB,GAEnD,MAAM;AACH,QAAAE,EAAA,oBAAoB,WAAWV,CAA0B,GACzDU,EAAA,oBAAoB,SAASF,CAAwB;AAAA,MAC/D;AAAA,EAAA,GACC,CAAClB,GAAQK,EAAY,OAAOI,GAASP,GAASQ,GAAWQ,CAAO,CAAC,GAEhE,CAAAlB;AACG,WAAAK;AACT;"}