@siberiacancode/reactuse 0.0.112 → 0.0.113

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQuery.mjs","sources":["../../../../src/hooks/useQuery/useQuery.ts"],"sourcesContent":["import type { DependencyList } from 'react';\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport { getRetry } from '@/utils/helpers';\n\nimport { useDidUpdate } from '../useDidUpdate/useDidUpdate';\nimport { useMount } from '../useMount/useMount';\n\n/* The use query return type */\nexport interface UseQueryOptions<QueryData, Data> {\n  /* The enabled state of the query */\n  enabled?: boolean;\n  /* The initial data for the hook */\n  initialData?: (() => Data) | Data;\n  /* The depends for the hook */\n  keys?: DependencyList;\n  /* The placeholder data for the hook */\n  placeholderData?: (() => Data) | Data;\n  /* The refetch interval */\n  refetchInterval?: number;\n  /* The retry count of requests */\n  retry?: boolean | number;\n  /* The retry delay of requests */\n  retryDelay?: ((retry: number, error: Error) => number) | number;\n  /* The callback function to be invoked on error */\n  onError?: (error: Error) => void;\n  /* The callback function to be invoked on success */\n  onSuccess?: (data: Data) => void;\n  /* The select function to be invoked */\n  select?: (data: QueryData) => Data;\n}\n\ninterface UseQueryCallbackParams {\n  /* The depends for the hook */\n  keys: DependencyList;\n  /* The abort signal */\n  signal: AbortSignal;\n}\n\n/* The use query return type */\nexport interface UseQueryReturn<Data> {\n  /* The abort function */\n  abort: AbortController['abort'];\n  /* The state of the query */\n  data?: Data;\n  /* The success state of the query */\n  error?: Error;\n  /* The error state of the query */\n  isError: boolean;\n  /* The fetching state of the query */\n  isFetching: boolean;\n  /* The loading state of the query */\n  isLoading: boolean;\n  /* The refetching state of the query */\n  isRefetching: boolean;\n  /* The success state of the query */\n  isSuccess: boolean;\n  /* The refetch function */\n  refetch: () => void;\n}\n\n/**\n * @name useQuery\n * @description - Hook that defines the logic when query data\n * @category Utilities\n *\n * @template Data The type of the data\n * @param {() => Promise<Data>} callback The callback function to be invoked\n * @param {DependencyList} [options.keys] The dependencies for the hook\n * @param {(data: Data) => void} [options.onSuccess] The callback function to be invoked on success\n * @param {(error: Error) => void} [options.onError] The callback function to be invoked on error\n * @param {UseQueryOptionsSelect<Data>} [options.select] The select function to be invoked\n * @param {Data | (() => Data)} [options.initialData] The initial data for the hook\n * @param {Data | (() => Data)} [options.placeholderData] The placeholder data for the hook\n * @param {number} [options.refetchInterval] The refetch interval\n * @param {boolean | number} [options.retry] The retry count of requests\n * @returns {UseQueryReturn<Data>} An object with the state of the query\n *\n * @example\n * const { data, isFetching, isLoading, isError, isSuccess, error, refetch, isRefetching, abort, aborted } = useQuery(() => fetch('url'));\n */\nexport const useQuery = <QueryData, Data = QueryData>(\n  callback: (params: UseQueryCallbackParams) => Promise<QueryData>,\n  options?: UseQueryOptions<QueryData, Data>\n): UseQueryReturn<Data> => {\n  const enabled = options?.enabled ?? true;\n  const retryCountRef = useRef(options?.retry ? getRetry(options.retry) : 0);\n  const alreadyRequested = useRef(false);\n\n  const [isFetching, setIsFetching] = useState(false);\n  const [isLoading, setIsLoading] = useState(false);\n  const [isError, setIsError] = useState(false);\n  const [isRefetching, setIsRefetching] = useState(false);\n  const [isSuccess, setIsSuccess] = useState(!!options?.initialData);\n\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [data, setData] = useState<Data | undefined>(options?.initialData);\n\n  const abortControllerRef = useRef<AbortController>(new AbortController());\n  const intervalIdRef = useRef<ReturnType<typeof setInterval>>();\n\n  const keys = options?.keys ?? [];\n\n  const abort = () => {\n    abortControllerRef.current.abort();\n    abortControllerRef.current = new AbortController();\n  };\n\n  const request = (action: 'init' | 'refetch') => {\n    abort();\n\n    setIsFetching(true);\n    if (action === 'init') {\n      alreadyRequested.current = true;\n      setIsLoading(true);\n    }\n    if (action === 'refetch') setIsRefetching(true);\n    callback({ signal: abortControllerRef.current.signal, keys })\n      .then((response) => {\n        const data = options?.select ? options?.select(response) : response;\n        options?.onSuccess?.(data as Data);\n        setData(data as Data);\n        setIsSuccess(true);\n        setError(undefined);\n        setIsError(false);\n        setIsFetching(false);\n        if (action === 'init') setIsLoading(false);\n        if (action === 'refetch') setIsRefetching(false);\n      })\n      .catch((error: Error) => {\n        if (retryCountRef.current > 0) {\n          retryCountRef.current -= 1;\n          const retryDelay =\n            typeof options?.retryDelay === 'function'\n              ? options?.retryDelay(retryCountRef.current, error)\n              : options?.retryDelay;\n\n          if (retryDelay) {\n            setTimeout(() => request(action), retryDelay);\n            return;\n          }\n\n          return request(action);\n        }\n        options?.onError?.(error);\n        setData(undefined);\n        setIsSuccess(false);\n        setError(error);\n        setIsError(true);\n        setIsFetching(false);\n        if (action === 'init') setIsLoading(false);\n        if (action === 'refetch') setIsRefetching(false);\n        retryCountRef.current = options?.retry ? getRetry(options.retry) : 0;\n      })\n      .finally(() => {\n        if (options?.refetchInterval) {\n          const interval = setInterval(() => {\n            clearInterval(interval);\n            request('refetch');\n          }, options?.refetchInterval);\n          intervalIdRef.current = interval;\n        }\n      });\n  };\n\n  useMount(() => {\n    if (!enabled) return;\n    request('init');\n  });\n\n  useDidUpdate(() => {\n    if (!enabled) return;\n    request(alreadyRequested.current ? 'refetch' : 'init');\n  }, [enabled, ...keys]);\n\n  useEffect(() => {\n    return () => {\n      clearInterval(intervalIdRef.current);\n    };\n  }, [enabled, options?.refetchInterval, options?.retry, ...keys]);\n\n  const refetch = () => request('refetch');\n\n  const placeholderData =\n    typeof options?.placeholderData === 'function'\n      ? (options?.placeholderData as () => Data)()\n      : options?.placeholderData;\n\n  return {\n    abort,\n    data: data ?? placeholderData,\n    error,\n    refetch,\n    isFetching,\n    isLoading,\n    isError,\n    isSuccess,\n    isRefetching\n  };\n};\n"],"names":["useQuery","callback","options","enabled","retryCountRef","useRef","getRetry","alreadyRequested","isFetching","setIsFetching","useState","isLoading","setIsLoading","isError","setIsError","isRefetching","setIsRefetching","isSuccess","setIsSuccess","error","setError","data","setData","abortControllerRef","intervalIdRef","keys","abort","request","action","response","_a","retryDelay","interval","useMount","useDidUpdate","useEffect","refetch","placeholderData"],"mappings":"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"}

package/dist/esm/hooks/useQueue/useQueue.mjs

@@ -0,0 +1,23 @@
+import { useState as n } from "react";
+import { flushSync as c } from "react-dom";
+const i = (s = []) => {
+  const [e, r] = n(s);
+  return {
+    add: (t) => r((o) => [...o, t]),
+    remove: () => {
+      let t;
+      return c(() => {
+        r(([o, ...u]) => (t = o, u));
+      }), t;
+    },
+    clear: () => r([]),
+    first: e[0],
+    last: e[e.length - 1],
+    size: e.length,
+    queue: e
+  };
+};
+export {
+  i as useQueue
+};
+//# sourceMappingURL=useQueue.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQueue.mjs","sources":["../../../../src/hooks/useQueue/useQueue.ts"],"sourcesContent":["import { useState } from 'react';\nimport { flushSync } from 'react-dom';\n\n/** The use queue return type */\nexport interface UseQueueReturn<Value> {\n  /** Get the first element of the queue */\n  first: Value;\n  /** Get the last element of the queue */\n  last: Value;\n  /** The current queue */\n  queue: Value[];\n  /** Get the size of the queue */\n  size: number;\n  /** Add an element to the queue */\n  add: (element: Value) => void;\n  /** Clear the queue */\n  clear: () => void;\n  /** Remove an element from the queue */\n  remove: () => Value;\n}\n\n/**\n * @name useQueue\n * @description - Hook that manages a queue\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value[]} [initialValue=[]] The initial value of the queue\n * @returns {UseQueueReturn} An object containing the current queue and functions to interact with the queue\n *\n * @example\n * const { queue, add, remove, clear, first, last, size } = useQueue([1, 2, 3]);\n */\nexport const useQueue = <Value>(initialValue: Value[] = []): UseQueueReturn<Value> => {\n  const [queue, setQueue] = useState(initialValue);\n\n  const add = (element: Value) => setQueue((queue) => [...queue, element]);\n  const clear = () => setQueue([]);\n  const remove = () => {\n    let removed;\n    flushSync(() => {\n      setQueue(([first, ...rest]) => {\n        removed = first;\n        return rest;\n      });\n    });\n\n    return removed as Value;\n  };\n\n  return {\n    add,\n    remove,\n    clear,\n    first: queue[0],\n    last: queue[queue.length - 1],\n    size: queue.length,\n    queue\n  };\n};\n"],"names":["useQueue","initialValue","queue","setQueue","useState","element","removed","flushSync","first","rest"],"mappings":";;AAiCO,MAAMA,IAAW,CAAQC,IAAwB,OAA8B;AACpF,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAASH,CAAY;AAgBxC,SAAA;AAAA,IACL,KAfU,CAACI,MAAmBF,EAAS,CAACD,MAAU,CAAC,GAAGA,GAAOG,CAAO,CAAC;AAAA,IAgBrE,QAda,MAAM;AACf,UAAAC;AACJ,aAAAC,EAAU,MAAM;AACd,QAAAJ,EAAS,CAAC,CAACK,GAAU,GAAAC,CAAI,OACbH,IAAAE,GACHC,EACR;AAAA,MAAA,CACF,GAEMH;AAAA,IACT;AAAA,IAKE,OAhBY,MAAMH,EAAS,EAAE;AAAA,IAiB7B,OAAOD,EAAM,CAAC;AAAA,IACd,MAAMA,EAAMA,EAAM,SAAS,CAAC;AAAA,IAC5B,MAAMA,EAAM;AAAA,IACZ,OAAAA;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useRaf/useRaf.mjs

@@ -0,0 +1,30 @@
+import { useRef as t, useState as R, useEffect as q } from "react";
+const y = (a, e) => {
+  const r = t(null), u = t(0), [f, l] = R(!1), d = (e == null ? void 0 : e.enabled) ?? !0, m = t(a);
+  m.current = a;
+  const n = (c) => {
+    const F = c - u.current;
+    if (e != null && e.delay && F < (e == null ? void 0 : e.delay)) {
+      r.current = window.requestAnimationFrame(n);
+      return;
+    }
+    u.current = c, m.current({ delta: F, timestamp: c }), r.current = window.requestAnimationFrame(n);
+  }, w = () => {
+    f || (l(!0), u.current = 0, r.current = window.requestAnimationFrame(n));
+  };
+  function A() {
+    r.current && (l(!1), window.cancelAnimationFrame(r.current), r.current = null);
+  }
+  return q(() => {
+    if (d)
+      return w(), A;
+  }, [d, e == null ? void 0 : e.delay]), {
+    active: f,
+    pause: A,
+    resume: w
+  };
+};
+export {
+  y as useRaf
+};
+//# sourceMappingURL=useRaf.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRaf.mjs","sources":["../../../../src/hooks/useRaf/useRaf.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/* The use raf params type */\nexport interface UseRafParams {\n  /** The delta between each frame in milliseconds */\n  delta: number;\n  /** The timestamp of the current frame in milliseconds */\n  timestamp: DOMHighResTimeStamp;\n}\n\n/* The use raf type */\nexport type UseRafCallback = (params: UseRafParams) => void;\n\n/* The use raf options type */\nexport interface UseRafOptions {\n  /** The delay between each frame in milliseconds */\n  delay?: number;\n  /** Whether the callback should be enabled */\n  enabled?: boolean;\n}\n\n/* The use raf return type */\nexport interface UseRafReturn {\n  /** Whether the callback is active */\n  active: boolean;\n  /** Function to pause the callback */\n  pause: () => void;\n  /** Function to resume the callback */\n  resume: () => void;\n}\n\n/**\n * @name useRaf\n * @description - Hook that defines the logic for raf callback\n * @category Utilities\n *\n * @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\n *\n * @param {UseRafCallback} callback The callback to execute\n * @param {number} [options.delay] The delay between each frame in milliseconds\n * @param {boolean} [options.enabled=true] Whether the callback should be enabled\n * @returns {UseRafCallbackReturn} An object of raf callback functions\n *\n * @example\n * useRaf(() => console.log('callback'));\n */\nexport const useRaf = (callback: UseRafCallback, options?: UseRafOptions): UseRafReturn => {\n  const rafIdRef = useRef<number | null>(null);\n  const previousFrameTimestampRef = useRef(0);\n  const [active, setActive] = useState(false);\n  const enabled = options?.enabled ?? true;\n\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  const loop = (timestamp: DOMHighResTimeStamp) => {\n    const delta = timestamp - previousFrameTimestampRef.current;\n\n    if (options?.delay && delta < options?.delay) {\n      rafIdRef.current = window.requestAnimationFrame(loop);\n      return;\n    }\n\n    previousFrameTimestampRef.current = timestamp;\n    internalCallbackRef.current({ delta, timestamp });\n    rafIdRef.current = window.requestAnimationFrame(loop);\n  };\n\n  const resume = () => {\n    if (active) return;\n    setActive(true);\n    previousFrameTimestampRef.current = 0;\n    rafIdRef.current = window.requestAnimationFrame(loop);\n  };\n\n  function pause() {\n    if (!rafIdRef.current) return;\n\n    setActive(false);\n    window.cancelAnimationFrame(rafIdRef.current);\n    rafIdRef.current = null;\n  }\n\n  useEffect(() => {\n    if (!enabled) return;\n    resume();\n\n    return pause;\n  }, [enabled, options?.delay]);\n\n  return {\n    active,\n    pause,\n    resume\n  };\n};\n"],"names":["useRaf","callback","options","rafIdRef","useRef","previousFrameTimestampRef","active","setActive","useState","enabled","internalCallbackRef","loop","timestamp","delta","resume","pause","useEffect"],"mappings":";AA8Ca,MAAAA,IAAS,CAACC,GAA0BC,MAA0C;AACnF,QAAAC,IAAWC,EAAsB,IAAI,GACrCC,IAA4BD,EAAO,CAAC,GACpC,CAACE,GAAQC,CAAS,IAAIC,EAAS,EAAK,GACpCC,KAAUP,KAAA,gBAAAA,EAAS,YAAW,IAE9BQ,IAAsBN,EAAOH,CAAQ;AAC3C,EAAAS,EAAoB,UAAUT;AAExB,QAAAU,IAAO,CAACC,MAAmC;AACzC,UAAAC,IAAQD,IAAYP,EAA0B;AAEpD,QAAIH,KAAA,QAAAA,EAAS,SAASW,KAAQX,KAAA,gBAAAA,EAAS,QAAO;AACnC,MAAAC,EAAA,UAAU,OAAO,sBAAsBQ,CAAI;AACpD;AAAA,IAAA;AAGF,IAAAN,EAA0B,UAAUO,GACpCF,EAAoB,QAAQ,EAAE,OAAAG,GAAO,WAAAD,EAAA,CAAW,GACvCT,EAAA,UAAU,OAAO,sBAAsBQ,CAAI;AAAA,EACtD,GAEMG,IAAS,MAAM;AACnB,IAAIR,MACJC,EAAU,EAAI,GACdF,EAA0B,UAAU,GAC3BF,EAAA,UAAU,OAAO,sBAAsBQ,CAAI;AAAA,EACtD;AAEA,WAASI,IAAQ;AACX,IAACZ,EAAS,YAEdI,EAAU,EAAK,GACR,OAAA,qBAAqBJ,EAAS,OAAO,GAC5CA,EAAS,UAAU;AAAA,EAAA;AAGrB,SAAAa,EAAU,MAAM;AACd,QAAKP;AACE,aAAAK,EAAA,GAEAC;AAAA,EACN,GAAA,CAACN,GAASP,KAAA,gBAAAA,EAAS,KAAK,CAAC,GAErB;AAAA,IACL,QAAAI;AAAA,IACA,OAAAS;AAAA,IACA,QAAAD;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useRafValue/useRafValue.mjs

@@ -0,0 +1,12 @@
+import { useRef as u, useState as c } from "react";
+import { useUnmount as m } from "../useUnmount/useUnmount.mjs";
+const f = (t) => {
+  const e = u(0), [n, r] = c(t), a = (o) => {
+    cancelAnimationFrame(e.current), e.current = requestAnimationFrame(() => r(o));
+  };
+  return m(() => cancelAnimationFrame(e.current)), [n, a];
+};
+export {
+  f as useRafValue
+};
+//# sourceMappingURL=useRafValue.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRafValue.mjs","sources":["../../../../src/hooks/useRafValue/useRafValue.ts"],"sourcesContent":["import { useRef, useState } from 'react';\n\nimport { useUnmount } from '../useUnmount/useUnmount';\n\n/* The use raf value params type */\nexport type UseRafValueReturn<Value> = [Value, (value: Value) => void];\n\n/**\n * @name useRafValue\n * @description - Hook that returns the value and a function to set the value\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value} initialValue The initial value\n * @returns {UseRafValueReturn<Value>} An array containing the value and a function to set the value\n *\n * @example\n * const [value, setValue] = useRafValue(initialValue);\n */\nexport const useRafValue = <Value>(initialValue: (() => Value) | Value) => {\n  const rafIdRef = useRef(0);\n  const [value, setValue] = useState(initialValue);\n\n  const set = (value: Value) => {\n    cancelAnimationFrame(rafIdRef.current);\n    rafIdRef.current = requestAnimationFrame(() => setValue(value));\n  };\n\n  useUnmount(() => cancelAnimationFrame(rafIdRef.current));\n\n  return [value, set] as const;\n};\n"],"names":["useRafValue","initialValue","rafIdRef","useRef","value","setValue","useState","set","useUnmount"],"mappings":";;AAmBa,MAAAA,IAAc,CAAQC,MAAwC;AACnE,QAAAC,IAAWC,EAAO,CAAC,GACnB,CAACC,GAAOC,CAAQ,IAAIC,EAASL,CAAY,GAEzCM,IAAM,CAACH,MAAiB;AAC5B,yBAAqBF,EAAS,OAAO,GACrCA,EAAS,UAAU,sBAAsB,MAAMG,EAASD,CAAK,CAAC;AAAA,EAChE;AAEA,SAAAI,EAAW,MAAM,qBAAqBN,EAAS,OAAO,CAAC,GAEhD,CAACE,GAAOG,CAAG;AACpB;"}

package/dist/esm/hooks/useRefState/useRefState.mjs

@@ -0,0 +1,24 @@
+import { useState as o } from "react";
+const u = (n, f) => {
+  let e = n;
+  function t(r) {
+    e !== r && (e = r, f(e));
+  }
+  return Object.defineProperty(t, "current", {
+    get() {
+      return e;
+    },
+    set(r) {
+      e !== r && (e = r, f(e));
+    },
+    configurable: !0,
+    enumerable: !0
+  }), t;
+}, s = (n) => {
+  const [f, e] = o(n), [t] = o(() => u(n, e));
+  return t.state = f, t;
+};
+export {
+  s as useRefState
+};
+//# sourceMappingURL=useRefState.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRefState.mjs","sources":["../../../../src/hooks/useRefState/useRefState.ts"],"sourcesContent":["import { useState } from 'react';\n\nexport interface StateRef<Value> {\n  (node: Value): void;\n  current: Value;\n  state?: Value;\n}\n\nconst createRefState = <Value>(\n  initialValue: Value | undefined,\n  setState: (value: Value) => void\n) => {\n  let temp = initialValue;\n  function ref(value: Value) {\n    if (temp === value) return;\n    temp = value;\n    setState(temp);\n  }\n\n  Object.defineProperty(ref, 'current', {\n    get() {\n      return temp;\n    },\n    set(value: Value) {\n      if (temp === value) return;\n      temp = value;\n      setState(temp);\n    },\n    configurable: true,\n    enumerable: true\n  });\n\n  return ref as StateRef<Value>;\n};\n\n/**\n * @name useRefState\n * @description - Hook that returns the state reference of the value\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value} [initialValue] The initial value\n * @returns {StateRef<Value>} The current value\n *\n * @example\n * const internalRefState = useRefState();\n */\nexport const useRefState = <Value>(initialValue?: Value) => {\n  const [state, setState] = useState<Value | undefined>(initialValue);\n  const [ref] = useState(() => createRefState<Value>(initialValue, setState));\n  ref.state = state;\n  return ref;\n};\n"],"names":["createRefState","initialValue","setState","temp","ref","value","useRefState","state","useState"],"mappings":";AAQA,MAAMA,IAAiB,CACrBC,GACAC,MACG;AACH,MAAIC,IAAOF;AACX,WAASG,EAAIC,GAAc;AACzB,IAAIF,MAASE,MACNF,IAAAE,GACPH,EAASC,CAAI;AAAA,EAAA;AAGR,gBAAA,eAAeC,GAAK,WAAW;AAAA,IACpC,MAAM;AACG,aAAAD;AAAA,IACT;AAAA,IACA,IAAIE,GAAc;AAChB,MAAIF,MAASE,MACNF,IAAAE,GACPH,EAASC,CAAI;AAAA,IACf;AAAA,IACA,cAAc;AAAA,IACd,YAAY;AAAA,EAAA,CACb,GAEMC;AACT,GAcaE,IAAc,CAAQL,MAAyB;AAC1D,QAAM,CAACM,GAAOL,CAAQ,IAAIM,EAA4BP,CAAY,GAC5D,CAACG,CAAG,IAAII,EAAS,MAAMR,EAAsBC,GAAcC,CAAQ,CAAC;AAC1E,SAAAE,EAAI,QAAQG,GACLH;AACT;"}

package/dist/esm/hooks/useRenderCount/useRenderCount.mjs

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderCount.mjs","sources":["../../../../src/hooks/useRenderCount/useRenderCount.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\n/**\n * @name useRenderCount\n * @description - Hook returns count component render times\n * @category Lifecycle\n *\n * @returns {number} A number which determines how many times component renders\n *\n * @example\n * const renderCount = useRenderCount();\n */\nexport const useRenderCount = () => {\n  const renderCountRef = useRef(0);\n\n  useEffect(() => {\n    renderCountRef.current += 1;\n  });\n\n  return renderCountRef.current;\n};\n"],"names":["useRenderCount","renderCountRef","useRef","useEffect"],"mappings":";AAYO,MAAMA,IAAiB,MAAM;AAC5B,QAAAC,IAAiBC,EAAO,CAAC;AAE/B,SAAAC,EAAU,MAAM;AACd,IAAAF,EAAe,WAAW;AAAA,EAAA,CAC3B,GAEMA,EAAe;AACxB;"}

package/dist/esm/hooks/useRenderInfo/useRenderInfo.mjs

@@ -0,0 +1,14 @@
+import { useRef as o } from "react";
+const c = (r = "Unknown", t = !0) => {
+  const e = o({
+    component: r,
+    renders: 0,
+    timestamp: Date.now(),
+    sinceLast: 0
+  }), n = Date.now();
+  return e.current.renders += 1, e.current.sinceLast = e.current.timestamp ? n - e.current.timestamp : 0, e.current.timestamp = n, t && (console.group(`${r} info, render number: ${e.current.renders}`), console.log(`Timestamp: ${e.current.timestamp}`), console.log(`Since last render: ${e.current.sinceLast}`), console.log(`Renders: ${e.current.renders}`), console.dir(e.current), console.groupEnd()), e.current;
+};
+export {
+  c as useRenderInfo
+};
+//# sourceMappingURL=useRenderInfo.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderInfo.mjs","sources":["../../../../src/hooks/useRenderInfo/useRenderInfo.ts"],"sourcesContent":["import { useRef } from 'react';\n\nexport interface UseRenderInfoReturn {\n  component: string;\n  renders: number;\n  sinceLast: number;\n  timestamp: number | null;\n}\n\n/**\n * @name useRenderInfo\n * @description - Hook for getting information about component rerender\n * @category Lifecycle\n *\n * @param {string} [name='Unknown'] Component name\n * @param {boolean} [log=true] Toggle logging\n * @returns {UseRenderInfoReturn} An object containing rerender information\n *\n * @example\n * const rerenderInfo = useRenderInfo('Component');\n */\nexport const useRenderInfo = (name: string = 'Unknown', log: boolean = true) => {\n  const renderInfoRef = useRef<UseRenderInfoReturn>({\n    component: name,\n    renders: 0,\n    timestamp: Date.now(),\n    sinceLast: 0\n  });\n  const now = Date.now();\n\n  renderInfoRef.current.renders += 1;\n  renderInfoRef.current.sinceLast = renderInfoRef.current.timestamp\n    ? now - renderInfoRef.current.timestamp\n    : 0;\n  renderInfoRef.current.timestamp = now;\n\n  if (log) {\n    console.group(`${name} info, render number: ${renderInfoRef.current.renders}`);\n    console.log(`Timestamp: ${renderInfoRef.current.timestamp}`);\n    console.log(`Since last render: ${renderInfoRef.current.sinceLast}`);\n    console.log(`Renders: ${renderInfoRef.current.renders}`);\n    console.dir(renderInfoRef.current);\n    console.groupEnd();\n  }\n\n  return renderInfoRef.current;\n};\n"],"names":["useRenderInfo","name","log","renderInfoRef","useRef","now"],"mappings":";AAqBO,MAAMA,IAAgB,CAACC,IAAe,WAAWC,IAAe,OAAS;AAC9E,QAAMC,IAAgBC,EAA4B;AAAA,IAChD,WAAWH;AAAA,IACX,SAAS;AAAA,IACT,WAAW,KAAK,IAAI;AAAA,IACpB,WAAW;AAAA,EAAA,CACZ,GACKI,IAAM,KAAK,IAAI;AAErB,SAAAF,EAAc,QAAQ,WAAW,GACnBA,EAAA,QAAQ,YAAYA,EAAc,QAAQ,YACpDE,IAAMF,EAAc,QAAQ,YAC5B,GACJA,EAAc,QAAQ,YAAYE,GAE9BH,MACF,QAAQ,MAAM,GAAGD,CAAI,yBAAyBE,EAAc,QAAQ,OAAO,EAAE,GAC7E,QAAQ,IAAI,cAAcA,EAAc,QAAQ,SAAS,EAAE,GAC3D,QAAQ,IAAI,sBAAsBA,EAAc,QAAQ,SAAS,EAAE,GACnE,QAAQ,IAAI,YAAYA,EAAc,QAAQ,OAAO,EAAE,GAC/C,QAAA,IAAIA,EAAc,OAAO,GACjC,QAAQ,SAAS,IAGZA,EAAc;AACvB;"}

package/dist/esm/hooks/useRerender/useRerender.mjs

@@ -0,0 +1,6 @@
+import { useReducer as e } from "react";
+const o = () => e(() => ({}), {})[1];
+export {
+  o as useRerender
+};
+//# sourceMappingURL=useRerender.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRerender.mjs","sources":["../../../../src/hooks/useRerender/useRerender.ts"],"sourcesContent":["import { useReducer } from 'react';\n\n/** The use rerender return type */\ntype UseRerenderReturn = () => void;\n\n/**\n * @name useRerender\n * @description - Hook that defines the logic to force rerender a component\n * @category Lifecycle\n *\n * @returns {UseRerenderReturn} The rerender function\n *\n * @example\n * const rerender = useRerender();\n */\nexport const useRerender = (): UseRerenderReturn => {\n  const rerender = useReducer(() => ({}), {})[1];\n  return rerender;\n};\n"],"names":["useRerender","useReducer"],"mappings":";AAeO,MAAMA,IAAc,MACRC,EAAW,OAAO,KAAK,CAAA,CAAE,EAAE,CAAC;"}

package/dist/esm/hooks/useResizeObserver/useResizeObserver.mjs

@@ -0,0 +1,26 @@
+import { useState as v, useRef as d, useEffect as l } from "react";
+import { useRefState as R } from "../useRefState/useRefState.mjs";
+import { isTarget as g } from "../../utils/helpers/isTarget.mjs";
+import { getElement as E } from "../../utils/helpers/getElement.mjs";
+const w = (...r) => {
+  const t = g(r[0]) ? r[0] : void 0, e = t ? r[1] : r[0], o = (e == null ? void 0 : e.enabled) ?? !0, [u, m] = v([]), n = R(), s = d();
+  return s.current = e == null ? void 0 : e.onChange, l(() => {
+    if (!o && !t && !n.state) return;
+    const f = t ? E(t) : n.current;
+    if (!f) return;
+    const c = new ResizeObserver((i) => {
+      var b;
+      m(i), (b = s.current) == null || b.call(s, i, c);
+    });
+    return c.observe(f, e), () => {
+      c.disconnect();
+    };
+  }, [t, n.state, e == null ? void 0 : e.box, o]), t ? { entries: u } : {
+    ref: n,
+    entries: u
+  };
+};
+export {
+  w as useResizeObserver
+};
+//# sourceMappingURL=useResizeObserver.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResizeObserver.mjs","sources":["../../../../src/hooks/useResizeObserver/useResizeObserver.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 resize observer options type */\nexport interface UseResizeObserverOptions extends ResizeObserverOptions {\n  /** The enabled state */\n  enabled?: boolean;\n  /** The resize observer callback */\n  onChange?: (entries: ResizeObserverEntry[], observer: ResizeObserver) => void;\n}\n\n/** The resize observer return type */\nexport interface UseResizeObserverReturn {\n  /** The resize observer entries */\n  entries: ResizeObserverEntry[];\n}\n\nexport interface UseResizeObserver {\n  (target: HookTarget, options?: UseResizeObserverOptions): UseResizeObserverReturn;\n\n  <Target extends Element>(\n    options?: UseResizeObserverOptions,\n    target?: never\n  ): UseResizeObserverReturn & { ref: StateRef<Target> };\n}\n\n/**\n *  @name useResizeObserver\n *  @description - Hook that gives you resize observer state\n *  @category Browser\n *\n *  @browserapi ResizeObserver https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver\n *\n *  @overload\n *  @template Target The target element\n *  @param {boolean} [options.enabled=true] The IntersectionObserver options\n *  @param {boolean} [options.box] The IntersectionObserver options\n *  @param {(entries: ResizeObserverEntry[], observer: ResizeObserver) => void} [options.onChange] The callback to execute when resize is detected\n *  @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} An object containing the resize observer state\n *\n *  @example\n *  const { ref, entries } = useResizeObserver();\n *\n *  @overload\n *  @template Target The target element\n *  @param {HookTarget} target The target element to observe\n *  @param {boolean} [options.enabled=true] The IntersectionObserver options\n *  @param {boolean} [options.box] The IntersectionObserver options\n *  @param {(entries: ResizeObserverEntry[], observer: ResizeObserver) => void} [options.onChange] The callback to execute when resize is detected\n *  @returns {UseResizeObserverReturn} An object containing the resize observer state\n *\n *  @example\n *  const { entries } = useResizeObserver(ref);\n */\nexport const useResizeObserver = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseResizeObserverOptions | undefined;\n  const enabled = options?.enabled ?? true;\n\n  const [entries, setEntries] = useState<ResizeObserverEntry[]>([]);\n\n  const internalRef = useRefState<Element>();\n  const internalOnChangeRef = useRef<UseResizeObserverOptions['onChange']>();\n  internalOnChangeRef.current = options?.onChange;\n\n  useEffect(() => {\n    if (!enabled && !target && !internalRef.state) return;\n\n    const element = target ? getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const observer = new ResizeObserver((entries) => {\n      setEntries(entries);\n      internalOnChangeRef.current?.(entries, observer);\n    });\n    observer.observe(element as Element, options);\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [target, internalRef.state, options?.box, enabled]);\n\n  if (target) return { entries };\n  return {\n    ref: internalRef,\n    entries\n  };\n}) as UseResizeObserver;\n"],"names":["useResizeObserver","params","target","isTarget","options","enabled","entries","setEntries","useState","internalRef","useRefState","internalOnChangeRef","useRef","useEffect","element","getElement","observer","_a"],"mappings":";;;;AA6Da,MAAAA,IAAqB,IAAIC,MAAkB;AAChD,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,KAAUD,KAAA,gBAAAA,EAAS,YAAW,IAE9B,CAACE,GAASC,CAAU,IAAIC,EAAgC,CAAA,CAAE,GAE1DC,IAAcC,EAAqB,GACnCC,IAAsBC,EAA6C;AAoBrE,SAnBJD,EAAoB,UAAUP,KAAA,gBAAAA,EAAS,UAEvCS,EAAU,MAAM;AACd,QAAI,CAACR,KAAW,CAACH,KAAU,CAACO,EAAY,MAAO;AAE/C,UAAMK,IAAUZ,IAASa,EAAWb,CAAM,IAAIO,EAAY;AAC1D,QAAI,CAACK,EAAS;AAEd,UAAME,IAAW,IAAI,eAAe,CAACV,MAAY;;AAC/C,MAAAC,EAAWD,CAAO,IACEW,IAAAN,EAAA,YAAA,QAAAM,EAAA,KAAAN,GAAUL,GAASU;AAAA,IAAQ,CAChD;AACQ,WAAAA,EAAA,QAAQF,GAAoBV,CAAO,GAErC,MAAM;AACX,MAAAY,EAAS,WAAW;AAAA,IACtB;AAAA,EAAA,GACC,CAACd,GAAQO,EAAY,OAAOL,KAAA,gBAAAA,EAAS,KAAKC,CAAO,CAAC,GAEjDH,IAAe,EAAE,SAAAI,EAAQ,IACtB;AAAA,IACL,KAAKG;AAAA,IACL,SAAAH;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useScreenOrientation/useScreenOrientation.mjs

@@ -0,0 +1,31 @@
+import { useState as r, useEffect as c } from "react";
+const s = () => {
+  const e = typeof window < "u" && "screen" in window && "orientation" in window.screen, n = e ? window.screen.orientation : {}, [t, i] = r(() => ({
+    angle: (n == null ? void 0 : n.angle) ?? 0,
+    orientationType: n == null ? void 0 : n.type
+  }));
+  return c(() => {
+    if (!e) return;
+    const o = () => i({
+      angle: n.angle,
+      orientationType: n.type
+    });
+    return window.addEventListener("orientationchange", o), () => {
+      window.removeEventListener("orientationchange", o);
+    };
+  }), {
+    supported: e,
+    value: t,
+    lock: (o) => {
+      if (e && typeof n.lock == "function")
+        return n.lock(o);
+    },
+    unlock: () => {
+      e && typeof n.unlock == "function" && n.unlock();
+    }
+  };
+};
+export {
+  s as useScreenOrientation
+};
+//# sourceMappingURL=useScreenOrientation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScreenOrientation.mjs","sources":["../../../../src/hooks/useScreenOrientation/useScreenOrientation.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\ndeclare global {\n  interface ScreenOrientation {\n    lock: (orientation: OrientationLockType) => Promise<void>;\n  }\n}\n\n/* The use device orientation value type */\nexport interface UseScreenOrientationValue {\n  /** The current angle */\n  angle: number;\n  /** The current orientation type */\n  orientationType: OrientationType;\n}\n\n/* The screen lock orientation type */\nexport type OrientationLockType =\n  | 'any'\n  | 'landscape-primary'\n  | 'landscape-secondary'\n  | 'landscape'\n  | 'natural'\n  | 'portrait-primary'\n  | 'portrait-secondary'\n  | 'portrait';\n\n/* The use device orientation return type */\nexport interface useScreenOrientationReturn {\n  /** Whether the screen orientation is supported */\n  supported: boolean;\n  /** The current screen orientation value */\n  value: UseScreenOrientationValue;\n  /** Lock the screen orientation */\n  lock: (orientation: OrientationLockType) => void;\n  /** Unlock the screen orientation */\n  unlock: () => void;\n}\n\n/**\n * @name useScreenOrientation\n * @description - Hook that provides the current screen orientation\n * @category Sensors\n *\n * @browserapi screen.orientation https://developer.mozilla.org/en-US/docs/Web/API/Screen/orientation\n *\n * @returns {useScreenOrientationReturn} The current screen orientation\n *\n * @example\n * const { supported, value, lock, unlock } = useScreenOrientation();\n */\nexport const useScreenOrientation = (): useScreenOrientationReturn => {\n  const supported =\n    typeof window !== 'undefined' && 'screen' in window && 'orientation' in window.screen;\n  const screenOrientation = (supported ? window.screen.orientation : {}) as ScreenOrientation;\n\n  const [value, setValue] = useState<UseScreenOrientationValue>(() => {\n    return {\n      angle: screenOrientation?.angle ?? 0,\n      orientationType: screenOrientation?.type\n    };\n  });\n\n  useEffect(() => {\n    if (!supported) return;\n\n    const onOrientationChange = () =>\n      setValue({\n        angle: screenOrientation.angle,\n        orientationType: screenOrientation.type\n      });\n\n    window.addEventListener('orientationchange', onOrientationChange);\n    return () => {\n      window.removeEventListener('orientationchange', onOrientationChange);\n    };\n  });\n\n  const lock = (type: OrientationLockType) => {\n    if (supported && typeof screenOrientation.lock === 'function')\n      return screenOrientation.lock(type);\n  };\n\n  const unlock = () => {\n    if (supported && typeof screenOrientation.unlock === 'function') screenOrientation.unlock();\n  };\n\n  return {\n    supported,\n    value,\n    lock,\n    unlock\n  };\n};\n"],"names":["useScreenOrientation","supported","screenOrientation","value","setValue","useState","useEffect","onOrientationChange","type"],"mappings":";AAmDO,MAAMA,IAAuB,MAAkC;AACpE,QAAMC,IACJ,OAAO,SAAW,OAAe,YAAY,UAAU,iBAAiB,OAAO,QAC3EC,IAAqBD,IAAY,OAAO,OAAO,cAAc,CAAC,GAE9D,CAACE,GAAOC,CAAQ,IAAIC,EAAoC,OACrD;AAAA,IACL,QAAOH,KAAA,gBAAAA,EAAmB,UAAS;AAAA,IACnC,iBAAiBA,KAAA,gBAAAA,EAAmB;AAAA,EACtC,EACD;AAED,SAAAI,EAAU,MAAM;AACd,QAAI,CAACL,EAAW;AAEV,UAAAM,IAAsB,MAC1BH,EAAS;AAAA,MACP,OAAOF,EAAkB;AAAA,MACzB,iBAAiBA,EAAkB;AAAA,IAAA,CACpC;AAEI,kBAAA,iBAAiB,qBAAqBK,CAAmB,GACzD,MAAM;AACJ,aAAA,oBAAoB,qBAAqBA,CAAmB;AAAA,IACrE;AAAA,EAAA,CACD,GAWM;AAAA,IACL,WAAAN;AAAA,IACA,OAAAE;AAAA,IACA,MAZW,CAACK,MAA8B;AACtC,UAAAP,KAAa,OAAOC,EAAkB,QAAS;AAC1C,eAAAA,EAAkB,KAAKM,CAAI;AAAA,IACtC;AAAA,IAUE,QARa,MAAM;AACnB,MAAIP,KAAa,OAAOC,EAAkB,UAAW,gBAA8B,OAAO;AAAA,IAC5F;AAAA,EAOA;AACF;"}

package/dist/esm/hooks/useScript/useScript.mjs

@@ -0,0 +1,32 @@
+import { useState as l, useEffect as p } from "react";
+const n = "script-status", A = (o, u = {}) => {
+  const [d, s] = l(() => {
+    const e = document.querySelector(`script[src="${o}"]`), r = e == null ? void 0 : e.getAttribute(n);
+    return r || (e ? "unknown" : "loading");
+  }), { removeOnUnmount: c = !0, async: m = !0 } = u;
+  return p(() => {
+    const e = document.querySelector(`script[src="${o}"]`), r = e == null ? void 0 : e.getAttribute(
+      n
+    );
+    if (r) return s(r);
+    if (e) return s("unknown");
+    const t = document.createElement("script");
+    t.src = o, t.async = m;
+    for (const [f, S] of Object.entries(u))
+      t.setAttribute(f, String(S));
+    t.setAttribute(n, "loading"), document.body.appendChild(t);
+    const i = () => {
+      t.setAttribute(n, "ready"), s("ready");
+    }, a = () => {
+      t.setAttribute(n, "error"), s("error");
+    };
+    return t.addEventListener("load", i), t.addEventListener("error", a), () => {
+      c && t.remove(), t.removeEventListener("load", i), t.removeEventListener("error", a);
+    };
+  }, [o, c]), d;
+};
+export {
+  n as SCRIPT_STATUS_ATTRIBUTE_NAME,
+  A as useScript
+};
+//# sourceMappingURL=useScript.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScript.mjs","sources":["../../../../src/hooks/useScript/useScript.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/** The use script status */\nexport type UseScriptStatus = 'error' | 'loading' | 'ready' | 'unknown';\nexport const SCRIPT_STATUS_ATTRIBUTE_NAME = 'script-status';\n\n/** The use script options extends from attributes script tag */\nexport interface UseScriptOptions extends ComponentProps<'script'> {\n  /** Whether to remove the script on unmount */\n  removeOnUnmount?: boolean;\n}\n\n/**\n * @name useScript\n * @description - Hook that manages a script with onLoad, onError, and removeOnUnmount functionalities\n * @category Browser\n *\n * @param {string} src The source of the script\n * @param {UseScriptOptions} [options] The options of the script extends from attributes script tag\n * @param {boolean} [options.removeOnUnmount=true] Whether to remove the script on unmount\n * @param {boolean} [options.async=true] Whether to load the script asynchronously\n * @returns {UseScriptStatus} The status of the script\n *\n * @example\n * const status = useScript('https://example.com/script.js');\n */\nexport const useScript = (src: string, options: UseScriptOptions = {}) => {\n  const [status, setStatus] = useState<UseScriptStatus>(() => {\n    const script = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n    const scriptStatus = script?.getAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME) as UseScriptStatus;\n    if (scriptStatus) return scriptStatus;\n    if (script) return 'unknown';\n\n    return 'loading';\n  });\n  const { removeOnUnmount = true, async = true } = options;\n\n  useEffect(() => {\n    const existedScript = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n    const scriptStatus = existedScript?.getAttribute(\n      SCRIPT_STATUS_ATTRIBUTE_NAME\n    ) as UseScriptStatus;\n    if (scriptStatus) return setStatus(scriptStatus);\n    if (existedScript) return setStatus('unknown');\n\n    const script = document.createElement('script');\n    script.src = src;\n    script.async = async;\n\n    for (const [key, value] of Object.entries(options)) {\n      script.setAttribute(key, String(value));\n    }\n\n    script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'loading');\n    document.body.appendChild(script);\n\n    const onLoad = () => {\n      script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'ready');\n      setStatus('ready');\n    };\n\n    const onError = () => {\n      script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'error');\n      setStatus('error');\n    };\n\n    script.addEventListener('load', onLoad);\n    script.addEventListener('error', onError);\n\n    return () => {\n      if (removeOnUnmount) script.remove();\n      script.removeEventListener('load', onLoad);\n      script.removeEventListener('error', onError);\n    };\n  }, [src, removeOnUnmount]);\n\n  return status;\n};\n"],"names":["SCRIPT_STATUS_ATTRIBUTE_NAME","useScript","src","options","status","setStatus","useState","script","scriptStatus","removeOnUnmount","async","useEffect","existedScript","key","value","onLoad","onError"],"mappings":";AAMO,MAAMA,IAA+B,iBAsB/BC,IAAY,CAACC,GAAaC,IAA4B,OAAO;AACxE,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAA0B,MAAM;AAC1D,UAAMC,IAAS,SAAS,cAAc,eAAeL,CAAG,IAAI,GACtDM,IAAeD,KAAA,gBAAAA,EAAQ,aAAaP;AAC1C,WAAIQ,MACAD,IAAe,YAEZ;AAAA,EAAA,CACR,GACK,EAAE,iBAAAE,IAAkB,IAAM,OAAAC,IAAQ,GAAS,IAAAP;AAEjD,SAAAQ,EAAU,MAAM;AACd,UAAMC,IAAgB,SAAS,cAAc,eAAeV,CAAG,IAAI,GAC7DM,IAAeI,KAAA,gBAAAA,EAAe;AAAA,MAClCZ;AAAA;AAEE,QAAAQ,EAAqB,QAAAH,EAAUG,CAAY;AAC3C,QAAAI,EAAsB,QAAAP,EAAU,SAAS;AAEvC,UAAAE,IAAS,SAAS,cAAc,QAAQ;AAC9C,IAAAA,EAAO,MAAML,GACbK,EAAO,QAAQG;AAEf,eAAW,CAACG,GAAKC,CAAK,KAAK,OAAO,QAAQX,CAAO;AAC/C,MAAAI,EAAO,aAAaM,GAAK,OAAOC,CAAK,CAAC;AAGjC,IAAAP,EAAA,aAAaP,GAA8B,SAAS,GAClD,SAAA,KAAK,YAAYO,CAAM;AAEhC,UAAMQ,IAAS,MAAM;AACZ,MAAAR,EAAA,aAAaP,GAA8B,OAAO,GACzDK,EAAU,OAAO;AAAA,IACnB,GAEMW,IAAU,MAAM;AACb,MAAAT,EAAA,aAAaP,GAA8B,OAAO,GACzDK,EAAU,OAAO;AAAA,IACnB;AAEO,WAAAE,EAAA,iBAAiB,QAAQQ,CAAM,GAC/BR,EAAA,iBAAiB,SAASS,CAAO,GAEjC,MAAM;AACP,MAAAP,OAAwB,OAAO,GAC5BF,EAAA,oBAAoB,QAAQQ,CAAM,GAClCR,EAAA,oBAAoB,SAASS,CAAO;AAAA,IAC7C;AAAA,EAAA,GACC,CAACd,GAAKO,CAAe,CAAC,GAElBL;AACT;"}

package/dist/esm/hooks/useScroll/useScroll.mjs

@@ -0,0 +1,51 @@
+import { useRef as w, useState as I, useEffect as O } from "react";
+import { useRefState as P } from "../useRefState/useRefState.mjs";
+import { isTarget as W } from "../../utils/helpers/isTarget.mjs";
+import { getElement as C } from "../../utils/helpers/getElement.mjs";
+const _ = 1, q = (...o) => {
+  const c = W(o[0]) ? o[0] : void 0, n = c ? typeof o[1] == "object" ? o[1] : { onScroll: o[1] } : typeof o[0] == "object" ? o[0] : { onScroll: o[0] }, d = P(), m = w(n);
+  m.current = n;
+  const [g, S] = I(!1), i = w({ x: 0, y: 0 });
+  return O(() => {
+    if (!c && !d.state) return;
+    const u = c ? C(c) : d.current;
+    if (!u) return;
+    const E = (l) => {
+      var e;
+      S(!1), (e = n == null ? void 0 : n.onStop) == null || e.call(n, l);
+    }, R = (l) => {
+      var D, f, H;
+      S(!0);
+      const e = l.target === document ? l.target.documentElement : l.target, { display: y, flexDirection: p, direction: j } = e.style, v = j === "rtl" ? -1 : 1, s = e.scrollLeft;
+      let r = e.scrollTop;
+      e instanceof Document && !r && (r = window.document.body.scrollTop);
+      const t = (D = m.current) == null ? void 0 : D.offset, x = s * v <= ((t == null ? void 0 : t.left) ?? 0), h = s * v + e.clientWidth >= e.scrollWidth - ((t == null ? void 0 : t.right) ?? 0) - _, L = r <= ((t == null ? void 0 : t.top) ?? 0), a = r + e.clientHeight >= e.scrollHeight - ((t == null ? void 0 : t.bottom) ?? 0) - _, b = y === "flex" && p === "column-reverse", T = y === "flex" && p === "column-reverse", A = {
+        x: s,
+        y: r,
+        directions: {
+          left: s < i.current.x,
+          right: s > i.current.x,
+          top: r < i.current.y,
+          bottom: r > i.current.y
+        },
+        arrived: {
+          left: T ? h : x,
+          right: T ? x : h,
+          top: b ? a : L,
+          bottom: b ? L : a
+        }
+      };
+      i.current = { x: s, y: r }, (H = (f = m.current) == null ? void 0 : f.onScroll) == null || H.call(f, A, l);
+    };
+    return u.addEventListener("scroll", R), u.addEventListener("scrollend", E), () => {
+      u.removeEventListener("scroll", R), u.removeEventListener("scrollend", E);
+    };
+  }, [c, d.state]), c ? g : {
+    ref: d,
+    scrolling: g
+  };
+};
+export {
+  q as useScroll
+};
+//# sourceMappingURL=useScroll.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScroll.mjs","sources":["../../../../src/hooks/useScroll/useScroll.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\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n}\n\nexport interface UseScrollCallbackParams {\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n}\n\nexport interface UseScroll {\n  (target: HookTarget, callback?: (params: UseScrollCallbackParams, event: Event) => void): boolean;\n\n  (target: HookTarget, options?: UseScrollOptions): boolean;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    scrolling: boolean;\n  };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    scrolling: boolean;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {boolean} The state of scrolling\n *\n * @example\n * const scrolling = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {boolean} The state of scrolling\n *\n * @example\n * const scrolling = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n *\n * @example\n * const { ref, scrolling } = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n *\n * @example\n * const { ref, scrolling } = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onScroll: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onScroll: params[0] }\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  const [scrolling, setScrolling] = useState(false);\n  const scrollPositionRef = useRef({ x: 0, y: 0 });\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n\n    if (!element) return;\n\n    const onScrollEnd = (event: Event) => {\n      setScrolling(false);\n      options?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      setScrolling(true);\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\n\n      const params = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < scrollPositionRef.current.x,\n          right: scrollLeft > scrollPositionRef.current.x,\n          top: scrollTop < scrollPositionRef.current.y,\n          bottom: scrollTop > scrollPositionRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\n      internalOptionsRef.current?.onScroll?.(params, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return scrolling;\n  return {\n    ref: internalRef,\n    scrolling\n  };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","_a","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse","_c","_b"],"mappings":"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"}

package/dist/esm/hooks/useScrollIntoView/useScrollIntoView.mjs

@@ -0,0 +1,36 @@
+import { useEffect as h } from "react";
+import { useRefState as v } from "../useRefState/useRefState.mjs";
+import { isTarget as k } from "../../utils/helpers/isTarget.mjs";
+import { getElement as l } from "../../utils/helpers/getElement.mjs";
+const d = (...r) => {
+  const e = k(r[0]) ? r[0] : void 0, s = e ? r[1] : r[0], t = v(), {
+    behavior: f = "smooth",
+    block: u = "start",
+    inline: b = "nearest",
+    enabled: n = !0
+  } = s ?? {};
+  h(() => {
+    if (!n || !e && !t.state) return;
+    const o = e ? l(e) : t.current;
+    o && o.scrollIntoView({
+      behavior: f,
+      block: u,
+      inline: b
+    });
+  }, [e, t.state, n]);
+  const i = (o) => {
+    const c = e ? l(e) : t.current;
+    if (!c) return;
+    const { behavior: m, block: a, inline: g } = o ?? {};
+    c.scrollIntoView({
+      behavior: m,
+      block: a,
+      inline: g
+    });
+  };
+  return e ? { trigger: i } : { ref: t, trigger: i };
+};
+export {
+  d as useScrollIntoView
+};
+//# sourceMappingURL=useScrollIntoView.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollIntoView.mjs","sources":["../../../../src/hooks/useScrollIntoView/useScrollIntoView.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The scroll into view options type */\nexport interface UseScrollIntoViewOptions extends ScrollIntoViewOptions {\n  /** Whether to enable the scroll into view */\n  enabled?: boolean;\n}\n\n/** The scroll into view return type */\nexport interface UseScrollIntoViewReturn {\n  /** Function to scroll element into view */\n  trigger: (params?: {\n    behavior?: ScrollBehavior;\n    block?: ScrollLogicalPosition;\n    inline?: ScrollLogicalPosition;\n  }) => void;\n}\n\nexport interface UseScrollIntoView {\n  <Target extends Element>(\n    options?: UseScrollIntoViewOptions,\n    target?: never\n  ): UseScrollIntoViewReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, options?: UseScrollIntoViewOptions): UseScrollIntoViewReturn;\n}\n\n/**\n * @name useScrollIntoView\n * @description - Hook that provides functionality to scroll an element into view\n * @category Sensors\n *\n * @overload\n * @param {HookTarget} target The target element to scroll into view\n * @param {ScrollBehavior} [options.behavior='smooth'] The scrolling behavior\n * @param {ScrollLogicalPosition} [options.block='start'] The vertical alignment\n * @param {ScrollLogicalPosition} [options.inline='nearest'] The horizontal alignment\n * @returns {UseScrollIntoViewReturn} Object containing scroll function\n *\n * @example\n * const { trigger } = useScrollIntoView(ref);\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior='smooth'] The scrolling behavior\n * @param {ScrollLogicalPosition} [options.block='start'] The vertical alignment\n * @param {ScrollLogicalPosition} [options.inline='nearest'] The horizontal alignment\n * @returns {UseScrollIntoViewReturn & { ref: StateRef<Target> }} Object containing scroll function and ref\n *\n * @example\n * const { ref, trigger } = useScrollIntoView<HTMLDivElement>();\n */\nexport const useScrollIntoView = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseScrollIntoViewOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const {\n    behavior = 'smooth',\n    block = 'start',\n    inline = 'nearest',\n    enabled = true\n  } = options ?? {};\n\n  useEffect(() => {\n    if (!enabled) return;\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    element.scrollIntoView({\n      behavior,\n      block,\n      inline\n    });\n  }, [target, internalRef.state, enabled]);\n\n  const trigger = (params?: {\n    behavior?: ScrollBehavior;\n    block?: ScrollLogicalPosition;\n    inline?: ScrollLogicalPosition;\n  }) => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    const { behavior, block, inline } = params ?? {};\n\n    element.scrollIntoView({\n      behavior,\n      block,\n      inline\n    });\n  };\n\n  if (target) return { trigger };\n  return { ref: internalRef, trigger };\n}) as UseScrollIntoView;\n"],"names":["useScrollIntoView","params","target","isTarget","options","internalRef","useRefState","behavior","block","inline","enabled","useEffect","element","getElement","trigger"],"mappings":";;;;AA4Da,MAAAA,IAAqB,IAAIC,MAAkB;AAChD,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCI,IAAcC,EAAqB,GACnC;AAAA,IACJ,UAAAC,IAAW;AAAA,IACX,OAAAC,IAAQ;AAAA,IACR,QAAAC,IAAS;AAAA,IACT,SAAAC,IAAU;AAAA,EACZ,IAAIN,KAAW,CAAC;AAEhB,EAAAO,EAAU,MAAM;AAEd,QADI,CAACD,KACD,CAACR,KAAU,CAACG,EAAY,MAAO;AAEnC,UAAMO,IAAWV,IAASW,EAAWX,CAAM,IAAIG,EAAY;AAC3D,IAAKO,KAELA,EAAQ,eAAe;AAAA,MACrB,UAAAL;AAAA,MACA,OAAAC;AAAA,MACA,QAAAC;AAAA,IAAA,CACD;AAAA,KACA,CAACP,GAAQG,EAAY,OAAOK,CAAO,CAAC;AAEjC,QAAAI,IAAU,CAACb,MAIX;AACJ,UAAMW,IAAWV,IAASW,EAAWX,CAAM,IAAIG,EAAY;AAC3D,QAAI,CAACO,EAAS;AAER,UAAA,EAAE,UAAAL,GAAU,OAAAC,GAAO,QAAAC,MAAWR,KAAU,CAAC;AAE/C,IAAAW,EAAQ,eAAe;AAAA,MACrB,UAAAL;AAAAA,MACA,OAAAC;AAAAA,MACA,QAAAC;AAAAA,IAAA,CACD;AAAA,EACH;AAEI,SAAAP,IAAe,EAAE,SAAAY,EAAQ,IACtB,EAAE,KAAKT,GAAa,SAAAS,EAAQ;AACrC;"}

package/dist/esm/hooks/useScrollTo/useScrollTo.mjs

@@ -0,0 +1,23 @@
+import { useLayoutEffect as p } from "react";
+import { useRefState as v } from "../useRefState/useRefState.mjs";
+import { isTarget as h } from "../../utils/helpers/isTarget.mjs";
+import { getElement as f } from "../../utils/helpers/getElement.mjs";
+const E = (...r) => {
+  const t = h(r[0]) ? r[0] : void 0, c = t ? r[1] : r[0], { x: s, y: u, behavior: l = "auto", enabled: m = !0 } = c ?? {}, e = v();
+  p(() => {
+    if (!m || !t && !e.state) return;
+    const o = t ? f(t) : e.current;
+    o && o.scrollTo({ top: u, left: s, behavior: l });
+  }, [t, e.state]);
+  const n = (o) => {
+    const i = t ? f(t) : e.current;
+    if (!i) return;
+    const { x: a, y: b, behavior: g } = o ?? {};
+    i.scrollTo({ left: a, top: b, behavior: g });
+  };
+  return t ? { trigger: n } : { ref: e, trigger: n };
+};
+export {
+  E as useScrollTo
+};
+//# sourceMappingURL=useScrollTo.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollTo.mjs","sources":["../../../../src/hooks/useScrollTo/useScrollTo.ts"],"sourcesContent":["import { useLayoutEffect } 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 scroll to options type */\nexport interface UseScrollToOptions {\n  /** The scrolling behavior */\n  behavior?: ScrollBehavior;\n  /** Whether to enable the scroll to */\n  enabled?: boolean;\n  /** The horizontal position to scroll to */\n  x: number;\n  /** The vertical position to scroll to */\n  y: number;\n}\n\n/** The use scroll to return type */\nexport interface UseScrollToReturn {\n  /** The state of scrolling */\n  trigger: (params?: { x: number; y: number; behavior?: ScrollBehavior }) => void;\n}\n\nexport interface UseScrollTo {\n  <Target extends Element>(\n    options?: UseScrollToOptions,\n    target?: never\n  ): UseScrollToReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, options?: UseScrollToOptions): UseScrollToReturn;\n}\n\n/**\n * @name useScrollTo\n * @description - Hook for scrolling to a specific element\n * @category Sensors\n *\n * @overload\n * @param {HookTarget} target The target element for scrolling to\n * @param {UseScrollToOptions} [options] The scroll options\n * @returns {UseScrollToReturn} The scroll trigger function\n *\n * @example\n * const trigger = useScrollTo(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {UseScrollToOptions} [options] The scroll options\n * @returns {UseScrollToReturn & { ref: StateRef<Target> }} The scroll trigger function and ref\n *\n * @example\n * const { ref, trigger } = useScrollTo(options);\n */\nexport const useScrollTo = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseScrollToOptions | undefined;\n  const { x, y, behavior = 'auto', enabled = true } = options ?? {};\n  const internalRef = useRefState<Element>();\n\n  useLayoutEffect(() => {\n    if (!enabled) return;\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    element.scrollTo({ top: y, left: x, behavior });\n  }, [target, internalRef.state]);\n\n  const trigger = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n    const { x, y, behavior } = params ?? {};\n\n    element.scrollTo({ left: x, top: y, behavior });\n  };\n\n  if (target) return { trigger };\n  return { ref: internalRef, trigger };\n}) as UseScrollTo;\n"],"names":["useScrollTo","params","target","isTarget","options","x","y","behavior","enabled","internalRef","useRefState","useLayoutEffect","element","getElement","trigger"],"mappings":";;;;AA0Da,MAAAA,IAAe,IAAIC,MAAkB;AAC1C,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxC,EAAE,GAAAI,GAAG,GAAAC,GAAG,UAAAC,IAAW,QAAQ,SAAAC,IAAU,OAASJ,KAAW,CAAC,GAC1DK,IAAcC,EAAqB;AAEzC,EAAAC,EAAgB,MAAM;AAEpB,QADI,CAACH,KACD,CAACN,KAAU,CAACO,EAAY,MAAO;AAEnC,UAAMG,IAAWV,IAASW,EAAWX,CAAM,IAAIO,EAAY;AAC3D,IAAKG,KAELA,EAAQ,SAAS,EAAE,KAAKN,GAAG,MAAMD,GAAG,UAAAE,GAAU;AAAA,EAC7C,GAAA,CAACL,GAAQO,EAAY,KAAK,CAAC;AAExB,QAAAK,IAAU,CAACb,MAAiE;AAChF,UAAMW,IAAWV,IAASW,EAAWX,CAAM,IAAIO,EAAY;AAC3D,QAAI,CAACG,EAAS;AACR,UAAA,EAAE,GAAAP,GAAG,GAAAC,GAAG,UAAAC,MAAaN,KAAU,CAAC;AAE9B,IAAAW,EAAA,SAAS,EAAE,MAAMP,GAAG,KAAKC,GAAG,UAAAC,GAAU;AAAA,EAChD;AAEI,SAAAL,IAAe,EAAE,SAAAY,EAAQ,IACtB,EAAE,KAAKL,GAAa,SAAAK,EAAQ;AACrC;"}

package/dist/esm/hooks/useSessionStorage/useSessionStorage.mjs

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

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

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

package/dist/esm/hooks/useSet/useSet.mjs

@@ -0,0 +1,30 @@
+import { useState as g } from "react";
+const z = (o) => {
+  const [s, t] = g(new Set(o)), r = (e) => t((n) => new Set(n).add(e)), i = (e) => t((n) => {
+    if (!n.has(e)) return n;
+    const c = new Set(n);
+    return c.delete(e), c;
+  }), f = () => t(/* @__PURE__ */ new Set()), d = () => t(new Set(o)), w = (e) => t((n) => {
+    if (!n.has(e)) return new Set(n).add(e);
+    const c = new Set(n);
+    return c.delete(e), c;
+  }), S = (e) => t(s.union(e)), m = (e) => t(s.difference(e)), a = (e) => t(s.symmetricDifference(e)), u = (e) => t(s.intersection(e)), h = (e) => s.has(e);
+  return {
+    value: s,
+    size: s.size,
+    has: h,
+    add: r,
+    remove: i,
+    clear: f,
+    reset: d,
+    toggle: w,
+    union: S,
+    difference: m,
+    symmetricDifference: a,
+    intersection: u
+  };
+};
+export {
+  z as useSet
+};
+//# sourceMappingURL=useSet.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSet.mjs","sources":["../../../../src/hooks/useSet/useSet.ts"],"sourcesContent":["import { useState } from 'react';\n\n/** The use set return type */\ninterface UseSetReturn<Value> {\n  /** The size of the set */\n  size: number;\n  /** The current set */\n  value: Set<Value>;\n  /** Function to add a value to the set */\n  add: (value: Value) => void;\n  /** Function to clear the set */\n  clear: () => void;\n  /** Function to get the symmetric difference of two sets */\n  difference: (other: Set<Value>) => void;\n  /** Function to check if a value exists in the set */\n  has: (value: Value) => boolean;\n  /** Function to get the difference of two sets */\n  intersection: (other: Set<Value>) => void;\n  /** Function to remove a value from the set */\n  remove: (value: Value) => void;\n  /** Function to toggle a value in the set */\n  reset: () => void;\n  /** Function to get the symmetric difference of two sets */\n  symmetricDifference: (other: Set<Value>) => void;\n  /** Function to toggle a value in the set */\n  toggle: (value: Value) => void;\n  /** Function to get the union of two sets */\n  union: (other: Set<Value>) => void;\n}\n\n/**\n * @name useSet\n * @description - Hook that manages a set structure\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value[]} [values] The initial array of the set\n * @returns {UseSetReturn<Value>} An object containing the current set and functions to interact with the set\n *\n * @example\n * const { value, add, remove, clear, reset, toggle, union, intersection, difference, symmetricDifference, size, has } = useSet([1, 2, 3]);\n */\nexport const useSet = <Value>(values?: Value[]): UseSetReturn<Value> => {\n  const [set, setSet] = useState(new Set(values));\n\n  const add = (value: Value) => setSet((prevSet) => new Set(prevSet).add(value));\n  const remove = (value: Value) =>\n    setSet((prevSet) => {\n      if (!prevSet.has(value)) return prevSet;\n      const newSet = new Set(prevSet);\n      newSet.delete(value);\n      return newSet;\n    });\n  const clear = () => setSet(new Set());\n  const reset = () => setSet(new Set(values));\n  const toggle = (value: Value) =>\n    setSet((prevSet) => {\n      if (!prevSet.has(value)) return new Set(prevSet).add(value);\n      const newSet = new Set(prevSet);\n      newSet.delete(value);\n      return newSet;\n    });\n  const union = (other: Set<Value>) => setSet(set.union(other));\n  const difference = (other: Set<Value>) => setSet(set.difference(other));\n  const symmetricDifference = (other: Set<Value>) => setSet(set.symmetricDifference(other));\n  const intersection = (other: Set<Value>) => setSet(set.intersection(other));\n  const has = (value: Value) => set.has(value);\n\n  return {\n    value: set,\n    size: set.size,\n    has,\n    add,\n    remove,\n    clear,\n    reset,\n    toggle,\n    union,\n    difference,\n    symmetricDifference,\n    intersection\n  };\n};\n"],"names":["useSet","values","set","setSet","useState","add","value","prevSet","remove","newSet","clear","reset","toggle","union","other","difference","symmetricDifference","intersection","has"],"mappings":";AA0Ca,MAAAA,IAAS,CAAQC,MAA0C;AAChE,QAAA,CAACC,GAAKC,CAAM,IAAIC,EAAS,IAAI,IAAIH,CAAM,CAAC,GAExCI,IAAM,CAACC,MAAiBH,EAAO,CAACI,MAAY,IAAI,IAAIA,CAAO,EAAE,IAAID,CAAK,CAAC,GACvEE,IAAS,CAACF,MACdH,EAAO,CAACI,MAAY;AAClB,QAAI,CAACA,EAAQ,IAAID,CAAK,EAAU,QAAAC;AAC1B,UAAAE,IAAS,IAAI,IAAIF,CAAO;AAC9B,WAAAE,EAAO,OAAOH,CAAK,GACZG;AAAA,EAAA,CACR,GACGC,IAAQ,MAAMP,EAAO,oBAAI,KAAK,GAC9BQ,IAAQ,MAAMR,EAAO,IAAI,IAAIF,CAAM,CAAC,GACpCW,IAAS,CAACN,MACdH,EAAO,CAACI,MAAY;AACd,QAAA,CAACA,EAAQ,IAAID,CAAK,EAAU,QAAA,IAAI,IAAIC,CAAO,EAAE,IAAID,CAAK;AACpD,UAAAG,IAAS,IAAI,IAAIF,CAAO;AAC9B,WAAAE,EAAO,OAAOH,CAAK,GACZG;AAAA,EAAA,CACR,GACGI,IAAQ,CAACC,MAAsBX,EAAOD,EAAI,MAAMY,CAAK,CAAC,GACtDC,IAAa,CAACD,MAAsBX,EAAOD,EAAI,WAAWY,CAAK,CAAC,GAChEE,IAAsB,CAACF,MAAsBX,EAAOD,EAAI,oBAAoBY,CAAK,CAAC,GAClFG,IAAe,CAACH,MAAsBX,EAAOD,EAAI,aAAaY,CAAK,CAAC,GACpEI,IAAM,CAACZ,MAAiBJ,EAAI,IAAII,CAAK;AAEpC,SAAA;AAAA,IACL,OAAOJ;AAAA,IACP,MAAMA,EAAI;AAAA,IACV,KAAAgB;AAAA,IACA,KAAAb;AAAA,IACA,QAAAG;AAAA,IACA,OAAAE;AAAA,IACA,OAAAC;AAAA,IACA,QAAAC;AAAA,IACA,OAAAC;AAAA,IACA,YAAAE;AAAA,IACA,qBAAAC;AAAA,IACA,cAAAC;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useShare/useShare.mjs

@@ -0,0 +1,15 @@
+const s = (e) => {
+  const r = typeof navigator < "u" && "share" in navigator;
+  return { share: async (n) => {
+    if (!r) return;
+    const a = {
+      ...e,
+      ...n
+    };
+    return a.files && navigator.canShare({ files: a.files }) && navigator.share(a), navigator.share(a);
+  }, supported: r };
+};
+export {
+  s as useShare
+};
+//# sourceMappingURL=useShare.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useShare.mjs","sources":["../../../../src/hooks/useShare/useShare.ts"],"sourcesContent":["/** The use share options type */\nexport interface UseShareParams {\n  /** Array of files to be shared */\n  files?: File[];\n  /** Text content to be shared */\n  text?: string;\n  /** Title of the content being shared */\n  title?: string;\n  /** URL link to be shared */\n  url?: string;\n}\n\n/** The use share return type */\nexport interface UseShareReturn {\n  /** Whether the Web Share API is supported in the current environment */\n  supported: boolean;\n  /** Function to trigger the native share dialog */\n  share: (shareParams: ShareData) => Promise<void>;\n}\n\n/**\n * @name useShare\n * @description - Hook that utilizes the share api\n * @category Browser\n *\n * @param {UseShareParams} [params] The use share options\n * @returns {UseShareReturn}\n *\n * @example\n * const { share, supported } = useShare();\n */\nexport const useShare = (params?: UseShareParams) => {\n  const supported = typeof navigator !== 'undefined' && 'share' in navigator;\n\n  const share = async (shareParams: ShareData) => {\n    if (!supported) return;\n\n    const data = {\n      ...params,\n      ...shareParams\n    };\n\n    if (data.files && navigator.canShare({ files: data.files })) navigator.share(data);\n\n    return navigator.share(data);\n  };\n\n  return { share, supported };\n};\n"],"names":["useShare","params","supported","shareParams","data"],"mappings":"AA+Ba,MAAAA,IAAW,CAACC,MAA4B;AACnD,QAAMC,IAAY,OAAO,YAAc,OAAe,WAAW;AAe1D,SAAA,EAAE,OAbK,OAAOC,MAA2B;AAC9C,QAAI,CAACD,EAAW;AAEhB,UAAME,IAAO;AAAA,MACX,GAAGH;AAAA,MACH,GAAGE;AAAA,IACL;AAEA,WAAIC,EAAK,SAAS,UAAU,SAAS,EAAE,OAAOA,EAAK,MAAA,CAAO,KAAa,UAAA,MAAMA,CAAI,GAE1E,UAAU,MAAMA,CAAI;AAAA,EAC7B,GAEgB,WAAAF,EAAU;AAC5B;"}