@siberiacancode/reactuse 0.0.112 → 0.0.113

package/dist/esm/hooks/useStateHistory/useStateHistory.mjs

@@ -0,0 +1,31 @@
+import { useState as f, useRef as x } from "react";
+const b = (u, o) => {
+  const [h, e] = f(u), [n, s] = f([u]), r = x(0), d = (t) => {
+    s((w) => {
+      const c = w.slice(0, r.current + 1);
+      return c.push(t), o && c.length > o && c.shift(), r.current = c.length - 1, c;
+    }), e(t);
+  }, y = () => {
+    r.current !== 0 && (r.current--, e(n[r.current]), s((t) => t.slice(0, r.current + 1)));
+  }, g = (t = 1) => {
+    r.current - t < 0 || (r.current -= t, e(n[r.current]));
+  }, i = (t = 1) => {
+    r.current + t >= n.length || (r.current += t, e(n[r.current]));
+  }, H = () => {
+    e(u), s([u]), r.current = 0;
+  };
+  return {
+    history: n,
+    value: h,
+    set: d,
+    index: r.current,
+    back: g,
+    forward: i,
+    reset: H,
+    undo: y
+  };
+};
+export {
+  b as useStateHistory
+};
+//# sourceMappingURL=useStateHistory.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStateHistory.mjs","sources":["../../../../src/hooks/useStateHistory/useStateHistory.ts"],"sourcesContent":["import { useRef, useState } from 'react';\n\n/** The use state history hook return type */\ninterface UseStateHistoryReturn<Value> {\n  /** All history values */\n  history: Value[];\n  /** Current index in history */\n  index: number;\n  /** Current value */\n  value: Value;\n  /** Go back specified number of steps in history (default: 1) */\n  back: (steps?: number) => void;\n  /** Go forward specified number of steps in history (default: 1) */\n  forward: (steps?: number) => void;\n  /** Reset history to initial state */\n  reset: () => void;\n  /** Set a new value */\n  set: (value: Value) => void;\n  /** Undo the last change */\n  undo: () => void;\n}\n\n/**\n * @name useStateHistory\n * @description - Hook that manages state with history functionality\n * @category Utilities\n *\n * @param {Value} initialValue - The initial value to start the history with\n * @param {number} [maxSize=10] - Maximum number of history entries to keep\n * @returns {UseStateHistoryReturn<Value>} Object containing current value, history array and control methods\n *\n * @example\n * const { value, history, index, set, back, forward, reset, undo } = useStateHistory(0);\n */\nexport const useStateHistory = <Value>(\n  initialValue: Value,\n  maxSize?: number\n): UseStateHistoryReturn<Value> => {\n  const [value, setValue] = useState<Value>(initialValue);\n  const [history, setHistory] = useState<Value[]>([initialValue]);\n  const currentIndexRef = useRef<number>(0);\n\n  const set = (value: Value) => {\n    setHistory((prevHistory) => {\n      const newHistory = prevHistory.slice(0, currentIndexRef.current + 1);\n      newHistory.push(value);\n      if (maxSize && newHistory.length > maxSize) newHistory.shift();\n      currentIndexRef.current = newHistory.length - 1;\n      return newHistory;\n    });\n    setValue(value);\n  };\n\n  const undo = () => {\n    if (currentIndexRef.current === 0) return;\n    currentIndexRef.current--;\n    setValue(history[currentIndexRef.current]);\n    setHistory((prevHistory) => prevHistory.slice(0, currentIndexRef.current + 1));\n  };\n\n  const back = (steps: number = 1) => {\n    if (currentIndexRef.current - steps < 0) return;\n    currentIndexRef.current -= steps;\n    setValue(history[currentIndexRef.current]);\n  };\n\n  const forward = (steps: number = 1) => {\n    if (currentIndexRef.current + steps >= history.length) return;\n    currentIndexRef.current += steps;\n    setValue(history[currentIndexRef.current]);\n  };\n\n  const reset = () => {\n    setValue(initialValue);\n    setHistory([initialValue]);\n    currentIndexRef.current = 0;\n  };\n\n  return {\n    history,\n    value,\n    set,\n    index: currentIndexRef.current,\n    back,\n    forward,\n    reset,\n    undo\n  };\n};\n"],"names":["useStateHistory","initialValue","maxSize","value","setValue","useState","history","setHistory","currentIndexRef","useRef","set","prevHistory","newHistory","undo","back","steps","forward","reset"],"mappings":";AAkCa,MAAAA,IAAkB,CAC7BC,GACAC,MACiC;AACjC,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAAgBJ,CAAY,GAChD,CAACK,GAASC,CAAU,IAAIF,EAAkB,CAACJ,CAAY,CAAC,GACxDO,IAAkBC,EAAe,CAAC,GAElCC,IAAM,CAACP,MAAiB;AAC5B,IAAAI,EAAW,CAACI,MAAgB;AAC1B,YAAMC,IAAaD,EAAY,MAAM,GAAGH,EAAgB,UAAU,CAAC;AACnE,aAAAI,EAAW,KAAKT,CAAK,GACjBD,KAAWU,EAAW,SAASV,OAAoB,MAAM,GAC7CM,EAAA,UAAUI,EAAW,SAAS,GACvCA;AAAA,IAAA,CACR,GACDR,EAASD,CAAK;AAAA,EAChB,GAEMU,IAAO,MAAM;AACb,IAAAL,EAAgB,YAAY,MAChBA,EAAA,WACPJ,EAAAE,EAAQE,EAAgB,OAAO,CAAC,GAC9BD,EAAA,CAACI,MAAgBA,EAAY,MAAM,GAAGH,EAAgB,UAAU,CAAC,CAAC;AAAA,EAC/E,GAEMM,IAAO,CAACC,IAAgB,MAAM;AAC9B,IAAAP,EAAgB,UAAUO,IAAQ,MACtCP,EAAgB,WAAWO,GAClBX,EAAAE,EAAQE,EAAgB,OAAO,CAAC;AAAA,EAC3C,GAEMQ,IAAU,CAACD,IAAgB,MAAM;AACrC,IAAIP,EAAgB,UAAUO,KAAST,EAAQ,WAC/CE,EAAgB,WAAWO,GAClBX,EAAAE,EAAQE,EAAgB,OAAO,CAAC;AAAA,EAC3C,GAEMS,IAAQ,MAAM;AAClB,IAAAb,EAASH,CAAY,GACVM,EAAA,CAACN,CAAY,CAAC,GACzBO,EAAgB,UAAU;AAAA,EAC5B;AAEO,SAAA;AAAA,IACL,SAAAF;AAAA,IACA,OAAAH;AAAA,IACA,KAAAO;AAAA,IACA,OAAOF,EAAgB;AAAA,IACvB,MAAAM;AAAA,IACA,SAAAE;AAAA,IACA,OAAAC;AAAA,IACA,MAAAJ;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useStep/useStep.mjs

@@ -0,0 +1,29 @@
+import { useRef as S, useState as x } from "react";
+const r = 1, E = (s) => {
+  const n = typeof s == "object" ? s.max : s, c = typeof s == "object" ? s.initial : r, o = S(
+    c > n || c < r ? r : c
+  ), [i, e] = x(c), f = i === r, u = i === n;
+  return {
+    counts: n,
+    currentStep: i,
+    isFirst: f,
+    isLast: u,
+    next: () => {
+      u || e((t) => t + 1);
+    },
+    back: () => {
+      f || e((t) => t - 1);
+    },
+    reset: () => e(o.current),
+    set: (t) => {
+      if (t === "first") return e(o.current);
+      if (t === "last" || t >= n) return e(n);
+      if (t <= r) return e(r);
+      e(t);
+    }
+  };
+};
+export {
+  E as useStep
+};
+//# sourceMappingURL=useStep.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStep.mjs","sources":["../../../../src/hooks/useStep/useStep.ts"],"sourcesContent":["import { useRef, useState } from 'react';\n\n/** The use step params type */\ninterface UseStepParams {\n  /** Initial value for step */\n  initial: number;\n  /** Maximum value for step */\n  max: number;\n}\n\n/** The use step return type */\ninterface UseStepReturn {\n  /** Counts of steps */\n  counts: number;\n  /** Current value of step */\n  currentStep: number;\n  /** Boolean value if current step is first */\n  isFirst: boolean;\n  /** Boolean value if current step is last */\n  isLast: boolean;\n  /** Go to back step */\n  back: () => void;\n  /** Go to next step */\n  next: () => void;\n  /** Reset current step to initial value */\n  reset: () => void;\n  /** Go to custom step */\n  set: (value: number | 'first' | 'last') => void;\n}\n\nconst FIRST_STEP_VALUE = 1;\n\n/**\n * @name useStep\n * @description - Hook that create stepper\n * @category Utilities\n *\n * @overload\n * @param {number} max Maximum number of steps\n * @returns {UseStepReturn} An object contains variables and functions to change the step\n *\n * @example\n * const stepper = useStep(5);\n *\n * @overload\n * @param {number} params.max Maximum number of steps\n * @param {number} params.initial Initial value for step\n * @returns {UseStepReturn} An object contains variables and functions to change the step\n *\n * @example\n * const stepper = useStep({ initial: 2, max: 5 });\n */\nexport const useStep = (params: number | UseStepParams): UseStepReturn => {\n  const max = typeof params === 'object' ? params.max : params;\n  const initial = typeof params === 'object' ? params.initial : FIRST_STEP_VALUE;\n\n  const initialStep = useRef(\n    initial > max || initial < FIRST_STEP_VALUE ? FIRST_STEP_VALUE : initial\n  );\n  const [currentStep, setCurrentStep] = useState(initial);\n\n  const isFirst = currentStep === FIRST_STEP_VALUE;\n  const isLast = currentStep === max;\n\n  const next = () => {\n    if (isLast) return;\n    setCurrentStep((prevStep) => prevStep + 1);\n  };\n\n  const back = () => {\n    if (isFirst) return;\n    setCurrentStep((prevStep) => prevStep - 1);\n  };\n\n  const reset = () => setCurrentStep(initialStep.current);\n\n  const set = (value: number | 'first' | 'last') => {\n    if (value === 'first') return setCurrentStep(initialStep.current);\n    if (value === 'last') return setCurrentStep(max);\n    if (value >= max) return setCurrentStep(max);\n    if (value <= FIRST_STEP_VALUE) return setCurrentStep(FIRST_STEP_VALUE);\n    setCurrentStep(value);\n  };\n\n  return {\n    counts: max,\n    currentStep,\n    isFirst,\n    isLast,\n    next,\n    back,\n    reset,\n    set\n  };\n};\n"],"names":["FIRST_STEP_VALUE","useStep","params","max","initial","initialStep","useRef","currentStep","setCurrentStep","useState","isFirst","isLast","prevStep","value"],"mappings":";AA8BA,MAAMA,IAAmB,GAsBZC,IAAU,CAACC,MAAkD;AACxE,QAAMC,IAAM,OAAOD,KAAW,WAAWA,EAAO,MAAMA,GAChDE,IAAU,OAAOF,KAAW,WAAWA,EAAO,UAAUF,GAExDK,IAAcC;AAAA,IAClBF,IAAUD,KAAOC,IAAUJ,IAAmBA,IAAmBI;AAAA,EACnE,GACM,CAACG,GAAaC,CAAc,IAAIC,EAASL,CAAO,GAEhDM,IAAUH,MAAgBP,GAC1BW,IAASJ,MAAgBJ;AAsBxB,SAAA;AAAA,IACL,QAAQA;AAAA,IACR,aAAAI;AAAA,IACA,SAAAG;AAAA,IACA,QAAAC;AAAA,IACA,MAzBW,MAAM;AACjB,MAAIA,KACWH,EAAA,CAACI,MAAaA,IAAW,CAAC;AAAA,IAC3C;AAAA,IAuBE,MArBW,MAAM;AACjB,MAAIF,KACWF,EAAA,CAACI,MAAaA,IAAW,CAAC;AAAA,IAC3C;AAAA,IAmBE,OAjBY,MAAMJ,EAAeH,EAAY,OAAO;AAAA,IAkBpD,KAhBU,CAACQ,MAAqC;AAChD,UAAIA,MAAU,QAAgB,QAAAL,EAAeH,EAAY,OAAO;AAEhE,UADIQ,MAAU,UACVA,KAASV,EAAY,QAAAK,EAAeL,CAAG;AAC3C,UAAIU,KAASb,EAAyB,QAAAQ,EAAeR,CAAgB;AACrE,MAAAQ,EAAeK,CAAK;AAAA,IACtB;AAAA,EAWA;AACF;"}

package/dist/esm/hooks/useSticky/useSticky.mjs

@@ -0,0 +1,32 @@
+import { useState as m, useEffect as v } from "react";
+import { useRefState as L } from "../useRefState/useRefState.mjs";
+import { isTarget as w } from "../../utils/helpers/isTarget.mjs";
+import { getElement as d } from "../../utils/helpers/getElement.mjs";
+const k = (...r) => {
+  const o = w(r[0]) ? r[0] : void 0, e = o ? r[1] : r[0], c = (e == null ? void 0 : e.axis) ?? "vertical", i = L(), [f, u] = m(!1);
+  return v(() => {
+    if (!o && !i.state) return;
+    const s = o ? d(o) : i.current;
+    if (!s) return;
+    const t = e != null && e.root ? d(e.root) : document, a = s.getBoundingClientRect().top + t.scrollTop - t.getBoundingClientRect().top, g = s.getBoundingClientRect().left + t.scrollLeft - t.getBoundingClientRect().left, n = () => {
+      if (c === "vertical") {
+        const l = t.scrollTop;
+        u(l >= a);
+      }
+      if (c === "horizontal") {
+        const l = t.scrollLeft;
+        u(l >= g);
+      }
+    };
+    return t.addEventListener("scroll", n), window.addEventListener("resize", n), window.addEventListener("orientationchange", n), n(), () => {
+      t.removeEventListener("scroll", n), window.removeEventListener("resize", n), window.removeEventListener("orientationchange", n);
+    };
+  }, [o, i.state, c, e == null ? void 0 : e.root]), o ? f : {
+    stuck: f,
+    ref: i
+  };
+};
+export {
+  k as useSticky
+};
+//# sourceMappingURL=useSticky.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSticky.mjs","sources":["../../../../src/hooks/useSticky/useSticky.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use sticky return type */\nexport interface UseStickyReturn {\n  stuck: boolean;\n}\n\n/** The use sticky axis type */\nexport type UseStickyAxis = 'horizontal' | 'vertical';\n\n/** The use sticky options type */\nexport interface UseStickyOptions {\n  axis?: UseStickyAxis;\n  root?: HookTarget;\n}\n\nexport interface UseSticky {\n  (target: HookTarget, options?: UseStickyOptions): boolean;\n\n  <Target extends Element>(\n    options?: UseStickyOptions,\n    target?: never\n  ): { ref: StateRef<Target> } & UseStickyReturn;\n}\n\n/**\n * @name UseSticky\n * @description - Hook that allows you to detect that your sticky component is stuck\n * @category Browser\n *\n * @overload\n * @param {HookTarget} target The target sticky element\n * @param {UseStickyAxis} [options.axis='vertical'] The axis of motion of the sticky component\n * @param {UseStickyRoot} [options.root=document] The element that contains your sticky component\n * @returns {UseStickyReturn} The state of the sticky\n *\n * @example\n * const stuck  = useSticky(ref);\n *\n * @overload\n * @param {UseStickyAxis} [options.axis='vertical'] The axis of motion of the sticky component\n * @param {UseStickyRoot} [options.root=document] The element that contains your sticky component\n * @returns {{ stickyRef: StateRef<Target> } & UseStickyReturn} The state of the sticky\n *\n * @example\n * const { stuck, ref } = useSticky();\n */\nexport const useSticky = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (target ? params[1] : params[0]) as UseStickyOptions;\n  const axis = options?.axis ?? 'vertical';\n\n  const internalRef = useRefState<Element>();\n  const [stuck, setStuck] = useState(false);\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n\n    if (!element) return;\n\n    const root = (options?.root ? getElement(options.root) : document) as Element;\n    const elementOffsetTop =\n      element.getBoundingClientRect().top + root.scrollTop - root.getBoundingClientRect().top;\n    const elementOffsetLeft =\n      element.getBoundingClientRect().left + root.scrollLeft - root.getBoundingClientRect().left;\n\n    const onSticky = () => {\n      if (axis === 'vertical') {\n        const scrollTop = root.scrollTop;\n        setStuck(scrollTop >= elementOffsetTop);\n      }\n\n      if (axis === 'horizontal') {\n        const scrollLeft = root.scrollLeft;\n        setStuck(scrollLeft >= elementOffsetLeft);\n      }\n    };\n\n    root.addEventListener('scroll', onSticky);\n    window.addEventListener('resize', onSticky);\n    window.addEventListener('orientationchange', onSticky);\n\n    onSticky();\n\n    return () => {\n      root.removeEventListener('scroll', onSticky);\n      window.removeEventListener('resize', onSticky);\n      window.removeEventListener('orientationchange', onSticky);\n    };\n  }, [target, internalRef.state, axis, options?.root]);\n\n  if (target) return stuck;\n  return {\n    stuck,\n    ref: internalRef\n  };\n}) as UseSticky;\n"],"names":["useSticky","params","target","isTarget","options","axis","internalRef","useRefState","stuck","setStuck","useState","useEffect","element","getElement","root","elementOffsetTop","elementOffsetLeft","onSticky","scrollTop","scrollLeft"],"mappings":";;;;AAuDa,MAAAA,IAAa,IAAIC,MAAkB;AACxC,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,KAAOD,KAAA,gBAAAA,EAAS,SAAQ,YAExBE,IAAcC,EAAqB,GACnC,CAACC,GAAOC,CAAQ,IAAIC,EAAS,EAAK;AAwCxC,SAtCAC,EAAU,MAAM;AACd,QAAI,CAACT,KAAU,CAACI,EAAY,MAAO;AAEnC,UAAMM,IAAWV,IAASW,EAAWX,CAAM,IAAII,EAAY;AAE3D,QAAI,CAACM,EAAS;AAEd,UAAME,IAAQV,KAAA,QAAAA,EAAS,OAAOS,EAAWT,EAAQ,IAAI,IAAI,UACnDW,IACJH,EAAQ,wBAAwB,MAAME,EAAK,YAAYA,EAAK,sBAAA,EAAwB,KAChFE,IACJJ,EAAQ,wBAAwB,OAAOE,EAAK,aAAaA,EAAK,sBAAA,EAAwB,MAElFG,IAAW,MAAM;AACrB,UAAIZ,MAAS,YAAY;AACvB,cAAMa,IAAYJ,EAAK;AACvB,QAAAL,EAASS,KAAaH,CAAgB;AAAA,MAAA;AAGxC,UAAIV,MAAS,cAAc;AACzB,cAAMc,IAAaL,EAAK;AACxB,QAAAL,EAASU,KAAcH,CAAiB;AAAA,MAAA;AAAA,IAE5C;AAEK,WAAAF,EAAA,iBAAiB,UAAUG,CAAQ,GACjC,OAAA,iBAAiB,UAAUA,CAAQ,GACnC,OAAA,iBAAiB,qBAAqBA,CAAQ,GAE5CA,EAAA,GAEF,MAAM;AACN,MAAAH,EAAA,oBAAoB,UAAUG,CAAQ,GACpC,OAAA,oBAAoB,UAAUA,CAAQ,GACtC,OAAA,oBAAoB,qBAAqBA,CAAQ;AAAA,IAC1D;AAAA,EAAA,GACC,CAACf,GAAQI,EAAY,OAAOD,GAAMD,KAAA,gBAAAA,EAAS,IAAI,CAAC,GAE/CF,IAAeM,IACZ;AAAA,IACL,OAAAA;AAAA,IACA,KAAKF;AAAA,EACP;AACF;"}

package/dist/esm/hooks/useStopwatch/useStopwatch.mjs

@@ -0,0 +1,59 @@
+import { useState as l, useEffect as y } from "react";
+const h = (t) => {
+  if (!t)
+    return {
+      days: 0,
+      hours: 0,
+      minutes: 0,
+      seconds: 0,
+      count: 0
+    };
+  const u = Math.floor(t / 86400), s = Math.floor(t % 86400 / 3600), c = Math.floor(t % 3600 / 60), e = Math.floor(t % 60);
+  return { days: u, hours: s, minutes: c, seconds: e, count: t };
+}, b = (...t) => {
+  var f;
+  const u = (typeof t[0] == "number" ? t[0] : (f = t[0]) == null ? void 0 : f.initialTime) ?? 0, s = typeof t[0] == "number" ? t[1] : t[0], [c, e] = l(h(u)), [r, d] = l(!(s != null && s.enabled));
+  return y(() => {
+    if (r) return;
+    const a = () => {
+      e((n) => {
+        const o = n.count + 1;
+        return o % 60 === 0 ? {
+          ...n,
+          minutes: n.minutes + 1,
+          seconds: 0,
+          count: o
+        } : o % (60 * 60) === 0 ? {
+          ...n,
+          hours: n.hours + 1,
+          minutes: 0,
+          seconds: 0,
+          count: o
+        } : o % (60 * 60 * 24) === 0 ? {
+          ...n,
+          days: n.days + 1,
+          hours: 0,
+          minutes: 0,
+          seconds: 0,
+          count: o
+        } : {
+          ...n,
+          seconds: n.seconds + 1,
+          count: o
+        };
+      });
+    }, i = setInterval(() => a(), 1e3);
+    return () => clearInterval(i);
+  }, [r]), {
+    ...c,
+    paused: r,
+    pause: () => d(!0),
+    start: () => d(!1),
+    reset: () => e(h(u)),
+    toggle: () => d((a) => !a)
+  };
+};
+export {
+  b as useStopwatch
+};
+//# sourceMappingURL=useStopwatch.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStopwatch.mjs","sources":["../../../../src/hooks/useStopwatch/useStopwatch.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nconst getStopwatchTime = (time: number) => {\n  if (!time)\n    return {\n      days: 0,\n      hours: 0,\n      minutes: 0,\n      seconds: 0,\n      count: 0\n    };\n\n  const days = Math.floor(time / 86400);\n  const hours = Math.floor((time % 86400) / 3600);\n  const minutes = Math.floor((time % 3600) / 60);\n  const seconds = Math.floor(time % 60);\n\n  return { days, hours, minutes, seconds, count: time };\n};\n\n/** The use stopwatch return type */\nexport interface UseStopwatchReturn {\n  /** The total count of the stopwatch */\n  count: number;\n  /** The day count of the stopwatch */\n  days: number;\n  /** The hour count of the stopwatch */\n  hours: number;\n  /** The minute count of the stopwatch */\n  minutes: number;\n  /** The over state of the stopwatch */\n  over: boolean;\n  /** The paused state of the stopwatch */\n  paused: boolean;\n  /** The second count of the stopwatch */\n  seconds: number;\n  /** The function to pause the stopwatch */\n  pause: () => void;\n  /** The function to reset the stopwatch */\n  reset: () => void;\n  /** The function to start the stopwatch */\n  start: () => void;\n  /** The function to toggle the stopwatch */\n  toggle: () => void;\n}\n\n/** The use stopwatch options */\nexport interface UseStopwatchOptions {\n  /** The enabled state of the timer */\n  enabled?: boolean;\n}\n\ninterface UseStopwatch {\n  (initialTime?: number, options?: UseStopwatchOptions): UseStopwatchReturn;\n  (options?: UseStopwatchOptions & { initialTime?: number }): UseStopwatchReturn;\n}\n/**\n * @name useStopwatch\n * @description - Hook that creates a stopwatch functionality\n * @category Time\n *\n * @overload\n * @param {number} [initialTime=0] The initial time of the timer\n * @param {boolean} [options.enabled=true] The enabled state of the timer\n * @returns {UseStopwatchReturn} An object containing the current time and functions to interact with the timer\n *\n * @example\n * const { seconds, minutes, start, pause, reset } = useStopwatch(1000, { enabled: false });\n *\n * @overload\n * @param {number} [options.initialTime=0] -The initial time of the timer\n * @param {boolean} [options.enabled=true] The enabled state of the timer\n * @returns {UseStopwatchReturn} An object containing the current time and functions to interact with the timer\n *\n * @example\n * const { seconds, minutes, start, pause, reset } = useStopwatch({ initialTime: 1000, enabled: false });\n */\nexport const useStopwatch = ((...params: any[]) => {\n  const initialTime =\n    (typeof params[0] === 'number'\n      ? (params[0] as number | undefined)\n      : (params[0] as UseStopwatchOptions & { initialTime?: number })?.initialTime) ?? 0;\n\n  const options =\n    typeof params[0] === 'number'\n      ? (params[1] as UseStopwatchOptions | undefined)\n      : (params[0] as (UseStopwatchOptions & { initialTime?: number }) | undefined);\n\n  const [time, setTime] = useState(getStopwatchTime(initialTime));\n  const [paused, setPaused] = useState(!options?.enabled);\n\n  useEffect(() => {\n    if (paused) return;\n    const onInterval = () => {\n      setTime((prevTime) => {\n        const updatedCount = prevTime.count + 1;\n\n        if (updatedCount % 60 === 0) {\n          return {\n            ...prevTime,\n            minutes: prevTime.minutes + 1,\n            seconds: 0,\n            count: updatedCount\n          };\n        }\n\n        if (updatedCount % (60 * 60) === 0) {\n          return {\n            ...prevTime,\n            hours: prevTime.hours + 1,\n            minutes: 0,\n            seconds: 0,\n            count: updatedCount\n          };\n        }\n\n        if (updatedCount % (60 * 60 * 24) === 0) {\n          return {\n            ...prevTime,\n            days: prevTime.days + 1,\n            hours: 0,\n            minutes: 0,\n            seconds: 0,\n            count: updatedCount\n          };\n        }\n\n        return {\n          ...prevTime,\n          seconds: prevTime.seconds + 1,\n          count: updatedCount\n        };\n      });\n    };\n\n    const interval = setInterval(() => onInterval(), 1000);\n    return () => clearInterval(interval);\n  }, [paused]);\n\n  return {\n    ...time,\n    paused,\n    pause: () => setPaused(true),\n    start: () => setPaused(false),\n    reset: () => setTime(getStopwatchTime(initialTime)),\n    toggle: () => setPaused((prevPause) => !prevPause)\n  };\n}) as UseStopwatch;\n"],"names":["getStopwatchTime","time","days","hours","minutes","seconds","useStopwatch","params","initialTime","_a","options","setTime","useState","paused","setPaused","useEffect","onInterval","prevTime","updatedCount","interval","prevPause"],"mappings":";AAEA,MAAMA,IAAmB,CAACC,MAAiB;AACzC,MAAI,CAACA;AACI,WAAA;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAEF,QAAMC,IAAO,KAAK,MAAMD,IAAO,KAAK,GAC9BE,IAAQ,KAAK,MAAOF,IAAO,QAAS,IAAI,GACxCG,IAAU,KAAK,MAAOH,IAAO,OAAQ,EAAE,GACvCI,IAAU,KAAK,MAAMJ,IAAO,EAAE;AAEpC,SAAO,EAAE,MAAAC,GAAM,OAAAC,GAAO,SAAAC,GAAS,SAAAC,GAAS,OAAOJ,EAAK;AACtD,GA2DaK,IAAgB,IAAIC,MAAkB;;AACjD,QAAMC,KACH,OAAOD,EAAO,CAAC,KAAM,WACjBA,EAAO,CAAC,KACRE,IAAAF,EAAO,CAAC,MAAR,gBAAAE,EAA8D,gBAAgB,GAE/EC,IACJ,OAAOH,EAAO,CAAC,KAAM,WAChBA,EAAO,CAAC,IACRA,EAAO,CAAC,GAET,CAACN,GAAMU,CAAO,IAAIC,EAASZ,EAAiBQ,CAAW,CAAC,GACxD,CAACK,GAAQC,CAAS,IAAIF,EAAS,EAACF,KAAA,QAAAA,EAAS,QAAO;AAEtD,SAAAK,EAAU,MAAM;AACd,QAAIF,EAAQ;AACZ,UAAMG,IAAa,MAAM;AACvB,MAAAL,EAAQ,CAACM,MAAa;AACd,cAAAC,IAAeD,EAAS,QAAQ;AAElC,eAAAC,IAAe,OAAO,IACjB;AAAA,UACL,GAAGD;AAAA,UACH,SAASA,EAAS,UAAU;AAAA,UAC5B,SAAS;AAAA,UACT,OAAOC;AAAA,QACT,IAGEA,KAAgB,KAAK,QAAQ,IACxB;AAAA,UACL,GAAGD;AAAA,UACH,OAAOA,EAAS,QAAQ;AAAA,UACxB,SAAS;AAAA,UACT,SAAS;AAAA,UACT,OAAOC;AAAA,QACT,IAGEA,KAAgB,KAAK,KAAK,QAAQ,IAC7B;AAAA,UACL,GAAGD;AAAA,UACH,MAAMA,EAAS,OAAO;AAAA,UACtB,OAAO;AAAA,UACP,SAAS;AAAA,UACT,SAAS;AAAA,UACT,OAAOC;AAAA,QACT,IAGK;AAAA,UACL,GAAGD;AAAA,UACH,SAASA,EAAS,UAAU;AAAA,UAC5B,OAAOC;AAAA,QACT;AAAA,MAAA,CACD;AAAA,IACH,GAEMC,IAAW,YAAY,MAAMH,EAAA,GAAc,GAAI;AAC9C,WAAA,MAAM,cAAcG,CAAQ;AAAA,EAAA,GAClC,CAACN,CAAM,CAAC,GAEJ;AAAA,IACL,GAAGZ;AAAA,IACH,QAAAY;AAAA,IACA,OAAO,MAAMC,EAAU,EAAI;AAAA,IAC3B,OAAO,MAAMA,EAAU,EAAK;AAAA,IAC5B,OAAO,MAAMH,EAAQX,EAAiBQ,CAAW,CAAC;AAAA,IAClD,QAAQ,MAAMM,EAAU,CAACM,MAAc,CAACA,CAAS;AAAA,EACnD;AACF;"}

package/dist/esm/hooks/useStorage/useStorage.mjs

@@ -0,0 +1,51 @@
+import { useState as V, useEffect as E } from "react";
+const c = "reactuse-storage", f = (t) => window.dispatchEvent(new StorageEvent(c, t)), d = (t, r, e) => {
+  const i = t.getItem(r);
+  t.setItem(r, e), f({ key: r, oldValue: i, newValue: e, storageArea: t });
+}, z = (t, r) => {
+  const e = t.getItem(r);
+  t.removeItem(r), f({ key: r, oldValue: e, newValue: null, storageArea: t });
+}, l = (t, r) => {
+  const e = t.getItem(r);
+  if (e)
+    return e;
+}, m = (t, r) => {
+  const e = typeof r == "object" && r && ("serializer" in r || "deserializer" in r || "initialValue" in r || "storage" in r) ? r : void 0, i = e ? e == null ? void 0 : e.initialValue : r;
+  if (typeof window > "u")
+    return {
+      value: typeof i == "function" ? i() : i
+    };
+  const u = (n) => e != null && e.serializer ? e.serializer(n) : typeof n == "string" ? n : JSON.stringify(n), o = (e == null ? void 0 : e.storage) ?? (window == null ? void 0 : window.localStorage), g = (n) => d(o, t, u(n)), v = () => z(o, t), a = (n) => {
+    if (e != null && e.deserializer) return e.deserializer(n);
+    if (n !== "undefined")
+      try {
+        return JSON.parse(n);
+      } catch {
+        return n;
+      }
+  }, [w, S] = V(() => {
+    const n = l(o, t);
+    if (n === void 0 && i !== void 0) {
+      const s = typeof i == "function" ? i() : i;
+      return d(o, t, u(s)), s;
+    }
+    return n ? a(n) : void 0;
+  });
+  return E(() => {
+    const n = () => {
+      const s = l(o, t);
+      S(s ? a(s) : void 0);
+    };
+    return window.addEventListener(c, n), () => window.removeEventListener(c, n);
+  }, [t]), {
+    value: w,
+    set: g,
+    remove: v
+  };
+};
+export {
+  c as STORAGE_EVENT,
+  f as dispatchStorageEvent,
+  m as useStorage
+};
+//# sourceMappingURL=useStorage.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStorage.mjs","sources":["../../../../src/hooks/useStorage/useStorage.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/* The use storage initial value type */\nexport type UseStorageInitialValue<Value> = (() => Value) | Value;\n\n/* The use storage options type */\nexport interface UseStorageOptions<Value> {\n  /* The initial value of the storage */\n  initialValue?: UseStorageInitialValue<Value>;\n  /* The storage to be used */\n  storage?: Storage;\n  /* The deserializer function to be invoked */\n  deserializer?: (value: string) => Value;\n  /* The serializer function to be invoked */\n  serializer?: (value: Value) => string;\n}\n\n/* The use storage return type */\nexport interface UseStorageReturn<Value> {\n  /* The value of the storage */\n  value: Value;\n  /* The error state of the storage */\n  remove: () => void;\n  /* The loading state of the storage */\n  set: (value: Value) => void;\n}\n\nexport const STORAGE_EVENT = 'reactuse-storage';\n\nexport const dispatchStorageEvent = (params: Partial<StorageEvent>) =>\n  window.dispatchEvent(new StorageEvent(STORAGE_EVENT, params));\n\nconst setStorageItem = (storage: Storage, key: string, value: string) => {\n  const oldValue = storage.getItem(key);\n\n  storage.setItem(key, value);\n  dispatchStorageEvent({ key, oldValue, newValue: value, storageArea: storage });\n};\n\nconst removeStorageItem = (storage: Storage, key: string) => {\n  const oldValue = storage.getItem(key);\n\n  storage.removeItem(key);\n  dispatchStorageEvent({ key, oldValue, newValue: null, storageArea: storage });\n};\n\nconst getStorageItem = (storage: Storage, key: string) => {\n  const value = storage.getItem(key);\n  if (!value) return undefined;\n  return value;\n};\n\n/**\n * @name useStorage\n * @description - Hook that manages storage value\n * @category Browser\n *\n * @overload\n * @param {string} key The key of the storage\n * @param {UseStorageInitialValue<Value>} [initialValue] The initial value of the storage\n * @returns {UseStorageReturn<Value>} The value and the set function\n *\n * @overload\n * @param {string} key The key of the storage\n * @param {(value: Value) => string} [params.serializer] The serializer function\n * @param {(value: string) => Value} [params.deserializer] The deserializer function\n * @param {Storage} [params.storage] The storage\n * @param {UseStorageInitialValue<Value>} [params.initialValue] The initial value of the storage\n * @returns {UseStorageReturn<Value>} The value and the set function\n *\n * @example\n * const { value, set, remove } = useStorage('key', 'value');\n */\nexport const useStorage = <Value>(\n  key: string,\n  params?: UseStorageInitialValue<Value> | UseStorageOptions<Value>\n) => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'storage' in params)\n      ? params\n      : undefined\n  ) as UseStorageOptions<Value>;\n  const initialValue = (options ? options?.initialValue : params) as UseStorageInitialValue<Value>;\n\n  if (typeof window === 'undefined')\n    return {\n      value: typeof initialValue === 'function' ? (initialValue as () => Value)() : initialValue\n    } as UseStorageReturn<Value>;\n\n  const serializer = (value: Value) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n    return JSON.stringify(value);\n  };\n\n  const storage = options?.storage ?? window?.localStorage;\n\n  const set = (value: Value) => setStorageItem(storage, key, serializer(value));\n  const remove = () => removeStorageItem(storage, key);\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined') return undefined as unknown as Value;\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value;\n    }\n  };\n\n  const [value, setValue] = useState<Value | undefined>(() => {\n    const storageValue = getStorageItem(storage, key);\n    if (storageValue === undefined && initialValue !== undefined) {\n      const value =\n        typeof initialValue === 'function' ? (initialValue as () => Value)() : initialValue;\n      setStorageItem(storage, key, serializer(value));\n      return value;\n    }\n    return storageValue ? deserializer(storageValue) : undefined;\n  });\n\n  useEffect(() => {\n    const onChange = () => {\n      const storageValue = getStorageItem(storage, key);\n      setValue(storageValue ? deserializer(storageValue) : undefined);\n    };\n    window.addEventListener(STORAGE_EVENT, onChange);\n    return () => window.removeEventListener(STORAGE_EVENT, onChange);\n  }, [key]);\n\n  return {\n    value,\n    set,\n    remove\n  };\n};\n"],"names":["STORAGE_EVENT","dispatchStorageEvent","params","setStorageItem","storage","key","value","oldValue","removeStorageItem","getStorageItem","useStorage","options","initialValue","serializer","set","remove","deserializer","setValue","useState","storageValue","useEffect","onChange"],"mappings":";AA2BO,MAAMA,IAAgB,oBAEhBC,IAAuB,CAACC,MACnC,OAAO,cAAc,IAAI,aAAaF,GAAeE,CAAM,CAAC,GAExDC,IAAiB,CAACC,GAAkBC,GAAaC,MAAkB;AACjE,QAAAC,IAAWH,EAAQ,QAAQC,CAAG;AAE5B,EAAAD,EAAA,QAAQC,GAAKC,CAAK,GAC1BL,EAAqB,EAAE,KAAAI,GAAK,UAAAE,GAAU,UAAUD,GAAO,aAAaF,GAAS;AAC/E,GAEMI,IAAoB,CAACJ,GAAkBC,MAAgB;AACrD,QAAAE,IAAWH,EAAQ,QAAQC,CAAG;AAEpC,EAAAD,EAAQ,WAAWC,CAAG,GACtBJ,EAAqB,EAAE,KAAAI,GAAK,UAAAE,GAAU,UAAU,MAAM,aAAaH,GAAS;AAC9E,GAEMK,IAAiB,CAACL,GAAkBC,MAAgB;AAClD,QAAAC,IAAQF,EAAQ,QAAQC,CAAG;AAC7B,MAACC;AACE,WAAAA;AACT,GAuBaI,IAAa,CACxBL,GACAH,MACG;AACH,QAAMS,IACJ,OAAOT,KAAW,YAClBA,MACC,gBAAgBA,KACf,kBAAkBA,KAClB,kBAAkBA,KAClB,aAAaA,KACXA,IACA,QAEAU,IAAgBD,IAAUA,KAAA,gBAAAA,EAAS,eAAeT;AAExD,MAAI,OAAO,SAAW;AACb,WAAA;AAAA,MACL,OAAO,OAAOU,KAAiB,aAAcA,MAAiCA;AAAA,IAChF;AAEI,QAAAC,IAAa,CAACP,MACdK,KAAA,QAAAA,EAAS,aAAmBA,EAAQ,WAAWL,CAAK,IACpD,OAAOA,KAAU,WAAiBA,IAC/B,KAAK,UAAUA,CAAK,GAGvBF,KAAUO,KAAA,gBAAAA,EAAS,aAAW,iCAAQ,eAEtCG,IAAM,CAACR,MAAiBH,EAAeC,GAASC,GAAKQ,EAAWP,CAAK,CAAC,GACtES,IAAS,MAAMP,EAAkBJ,GAASC,CAAG,GAE7CW,IAAe,CAACV,MAAkB;AACtC,QAAIK,KAAA,QAAAA,EAAS,aAAqB,QAAAA,EAAQ,aAAaL,CAAK;AACxDA,QAAAA,MAAU;AAEV,UAAA;AACK,eAAA,KAAK,MAAMA,CAAK;AAAA,MAAA,QACjB;AACCA,eAAAA;AAAAA,MAAA;AAAA,EAEX,GAEM,CAACA,GAAOW,CAAQ,IAAIC,EAA4B,MAAM;AACpD,UAAAC,IAAeV,EAAeL,GAASC,CAAG;AAC5C,QAAAc,MAAiB,UAAaP,MAAiB,QAAW;AAC5D,YAAMN,IACJ,OAAOM,KAAiB,aAAcA,EAAiC,IAAAA;AACzE,aAAAT,EAAeC,GAASC,GAAKQ,EAAWP,CAAK,CAAC,GACvCA;AAAAA,IAAA;AAEF,WAAAa,IAAeH,EAAaG,CAAY,IAAI;AAAA,EAAA,CACpD;AAED,SAAAC,EAAU,MAAM;AACd,UAAMC,IAAW,MAAM;AACf,YAAAF,IAAeV,EAAeL,GAASC,CAAG;AAChD,MAAAY,EAASE,IAAeH,EAAaG,CAAY,IAAI,MAAS;AAAA,IAChE;AACO,kBAAA,iBAAiBnB,GAAeqB,CAAQ,GACxC,MAAM,OAAO,oBAAoBrB,GAAeqB,CAAQ;AAAA,EAAA,GAC9D,CAAChB,CAAG,CAAC,GAED;AAAA,IACL,OAAAC;AAAA,IACA,KAAAQ;AAAA,IACA,QAAAC;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useTextDirection/useTextDirection.mjs

@@ -0,0 +1,37 @@
+import { useState as d } from "react";
+import { useIsomorphicLayoutEffect as l } from "../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs";
+import { useRefState as v } from "../useRefState/useRefState.mjs";
+import { isTarget as g } from "../../utils/helpers/isTarget.mjs";
+import { getElement as i } from "../../utils/helpers/getElement.mjs";
+const R = (...n) => {
+  const e = g(n[0]) ? n[0] : void 0, a = (e ? n[1] : n[0]) ?? "ltr", r = v(), s = () => {
+    const t = e ? i(e) : r.current;
+    return (t == null ? void 0 : t.getAttribute("dir")) ?? a;
+  }, [u, c] = d(s()), f = () => {
+    const t = e ? i(e) : r.current;
+    t && (t == null || t.removeAttribute("dir"));
+  }, m = (t) => {
+    const o = e ? i(e) : r.current;
+    o && (c(t), o.setAttribute("dir", t));
+  };
+  return l(() => {
+    if (!e && !r.state) return;
+    const t = e ? i(e) : r.current;
+    if (!t) return;
+    const o = s();
+    t.setAttribute("dir", o), c(o);
+    const b = new MutationObserver(s);
+    return b.observe(t, { attributes: !0 }), () => {
+      b.disconnect();
+    };
+  }, [r.state, e]), e ? { value: u, set: m, remove: f } : {
+    ref: r,
+    value: u,
+    set: m,
+    remove: f
+  };
+};
+export {
+  R as useTextDirection
+};
+//# sourceMappingURL=useTextDirection.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTextDirection.mjs","sources":["../../../../src/hooks/useTextDirection/useTextDirection.ts"],"sourcesContent":["import { 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 { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect';\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use text direction value type */\nexport type UseTextDirectionValue = 'auto' | 'ltr' | 'rtl';\n\n/** The use text direction return type */\nexport interface UseTextDirectionReturn {\n  /** The current direction */\n  value: UseTextDirectionValue;\n  /*** The function to remove the direction */\n  remove: () => void;\n  /*** The function to set the direction */\n  set: (value: UseTextDirectionValue | null) => void;\n}\n\nexport interface UseTextDirection {\n  (target: HookTarget, initialValue?: UseTextDirectionValue): UseTextDirectionReturn;\n\n  <Target extends Element>(\n    initialValue?: UseTextDirectionValue,\n    target?: never\n  ): UseTextDirectionReturn & { ref: StateRef<Target> };\n}\n\n/**\n * @name useTextDirection\n * @description - Hook that can get and set the direction of the element\n * @category Browser\n *\n * @overload\n * @param {HookTarget} target The target element to observe\n * @param {UseTextDirectionValue} [initialValue = 'ltr'] The initial direction of the element\n * @returns {UseTextDirectionReturn} An object containing the current text direction of the element\n *\n * @example\n * const { value, set, remove } = useTextDirection(ref);\n *\n * @overload\n * @template Target The target element type\n * @param {UseTextDirectionValue} [initialValue = 'ltr'] The initial direction of the element\n * @returns { { ref: StateRef<Target> } & UseTextDirectionReturn } An object containing the current text direction of the element\n *\n * @example\n * const { ref, value, set, remove } = useTextDirection();\n */\nexport const useTextDirection = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const initialValue = ((target ? params[1] : params[0]) as UseTextDirectionValue) ?? 'ltr';\n\n  const internalRef = useRefState<Element>();\n\n  const getDirection = () => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    return (element?.getAttribute('dir') as UseTextDirectionValue) ?? initialValue;\n  };\n\n  const [value, setValue] = useState<UseTextDirectionValue>(getDirection());\n\n  const remove = () => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    element?.removeAttribute('dir');\n  };\n\n  const set = (value: UseTextDirectionValue) => {\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    setValue(value);\n    element.setAttribute('dir', value);\n  };\n\n  useIsomorphicLayoutEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = (target ? getElement(target) : internalRef.current) as Element;\n    if (!element) return;\n\n    const direction = getDirection();\n    element.setAttribute('dir', direction);\n    setValue(direction);\n\n    const observer = new MutationObserver(getDirection);\n\n    observer.observe(element, { attributes: true });\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [internalRef.state, target]);\n\n  if (target) return { value, set, remove };\n  return {\n    ref: internalRef,\n    value,\n    set,\n    remove\n  };\n}) as UseTextDirection;\n"],"names":["useTextDirection","params","target","isTarget","initialValue","internalRef","useRefState","getDirection","element","getElement","value","setValue","useState","remove","set","useIsomorphicLayoutEffect","direction","observer"],"mappings":";;;;;AAsDa,MAAAA,IAAoB,IAAIC,MAAkB;AAC/C,QAAAC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,KAAiBF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,MAAgC,OAE9EI,IAAcC,EAAqB,GAEnCC,IAAe,MAAM;AACzB,UAAMC,IAAWN,IAASO,EAAWP,CAAM,IAAIG,EAAY;AACnD,YAAAG,KAAA,gBAAAA,EAAS,aAAa,WAAoCJ;AAAA,EACpE,GAEM,CAACM,GAAOC,CAAQ,IAAIC,EAAgCL,GAAc,GAElEM,IAAS,MAAM;AACnB,UAAML,IAAWN,IAASO,EAAWP,CAAM,IAAIG,EAAY;AAC3D,IAAKG,MAELA,KAAA,QAAAA,EAAS,gBAAgB;AAAA,EAC3B,GAEMM,IAAM,CAACJ,MAAiC;AAC5C,UAAMF,IAAWN,IAASO,EAAWP,CAAM,IAAIG,EAAY;AAC3D,IAAKG,MAELG,EAASD,CAAK,GACNF,EAAA,aAAa,OAAOE,CAAK;AAAA,EACnC;AAqBA,SAnBAK,EAA0B,MAAM;AAC9B,QAAI,CAACb,KAAU,CAACG,EAAY,MAAO;AAEnC,UAAMG,IAAWN,IAASO,EAAWP,CAAM,IAAIG,EAAY;AAC3D,QAAI,CAACG,EAAS;AAEd,UAAMQ,IAAYT,EAAa;AACvB,IAAAC,EAAA,aAAa,OAAOQ,CAAS,GACrCL,EAASK,CAAS;AAEZ,UAAAC,IAAW,IAAI,iBAAiBV,CAAY;AAElD,WAAAU,EAAS,QAAQT,GAAS,EAAE,YAAY,IAAM,GAEvC,MAAM;AACX,MAAAS,EAAS,WAAW;AAAA,IACtB;AAAA,EACC,GAAA,CAACZ,EAAY,OAAOH,CAAM,CAAC,GAE1BA,IAAe,EAAE,OAAAQ,GAAO,KAAAI,GAAK,QAAAD,EAAO,IACjC;AAAA,IACL,KAAKR;AAAA,IACL,OAAAK;AAAA,IACA,KAAAI;AAAA,IACA,QAAAD;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useTextSelection/useTextSelection.mjs

@@ -0,0 +1,28 @@
+import { useState as u, useEffect as g } from "react";
+import { useRerender as i } from "../useRerender/useRerender.mjs";
+const a = (t) => {
+  const e = t.rangeCount ?? 0;
+  return Array.from({ length: e }, (r, o) => t.getRangeAt(o));
+}, l = () => {
+  const t = i(), [e, r] = u(
+    typeof document < "u" ? document.getSelection() : null
+  );
+  g(() => {
+    const n = () => {
+      r(document.getSelection()), t();
+    };
+    return document.addEventListener("selectionchange", n), () => document.removeEventListener("selectionchange", n);
+  }, []);
+  const o = (e == null ? void 0 : e.toString()) ?? "", c = e ? a(e) : [], s = c.map((n) => n.getBoundingClientRect());
+  return {
+    text: o,
+    ranges: c,
+    rects: s,
+    selection: e
+  };
+};
+export {
+  a as getRangesSelection,
+  l as useTextSelection
+};
+//# sourceMappingURL=useTextSelection.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTextSelection.mjs","sources":["../../../../src/hooks/useTextSelection/useTextSelection.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { useRerender } from '../useRerender/useRerender';\n\nexport const getRangesSelection = (selection: Selection) => {\n  const rangeCount = selection.rangeCount ?? 0;\n  return Array.from({ length: rangeCount }, (_, i) => selection.getRangeAt(i));\n};\n\n/** The use text selection return type */\nexport interface UseTextSelectionReturn {\n  /** The current selection ranges */\n  ranges: Range[];\n  /** The current selection rects */\n  rects: DOMRect[];\n  /** The current selection */\n  selection: Selection | null;\n  /** The current selection text */\n  text: string;\n}\n\n/**\n * @name useTextSelection\n * @description - Hook that manages the text selection\n * @category Sensors\n *\n * @browserapi document.getSelection https://developer.mozilla.org/en-US/docs/Web/API/Document/getSelection\n *\n * @returns {UseTextSelectionReturn} An object containing the current text selection\n *\n * @example\n * const selection = useTextSelection();\n */\nexport const useTextSelection = (): UseTextSelectionReturn => {\n  const rerender = useRerender();\n  const [selection, setSelection] = useState<Selection | null>(\n    typeof document !== 'undefined' ? document.getSelection() : null\n  );\n\n  useEffect(() => {\n    const onSelectionChange = () => {\n      setSelection(document.getSelection());\n      rerender();\n    };\n\n    document.addEventListener('selectionchange', onSelectionChange);\n    return () => document.removeEventListener('selectionchange', onSelectionChange);\n  }, []);\n\n  const text = selection?.toString() ?? '';\n  const ranges = selection ? getRangesSelection(selection) : [];\n  const rects = ranges.map((range) => range.getBoundingClientRect());\n\n  return {\n    text,\n    ranges,\n    rects,\n    selection\n  };\n};\n"],"names":["getRangesSelection","selection","rangeCount","_","i","useTextSelection","rerender","useRerender","setSelection","useState","useEffect","onSelectionChange","text","ranges","rects","range"],"mappings":";;AAIa,MAAAA,IAAqB,CAACC,MAAyB;AACpD,QAAAC,IAAaD,EAAU,cAAc;AAC3C,SAAO,MAAM,KAAK,EAAE,QAAQC,EAAW,GAAG,CAACC,GAAGC,MAAMH,EAAU,WAAWG,CAAC,CAAC;AAC7E,GA0BaC,IAAmB,MAA8B;AAC5D,QAAMC,IAAWC,EAAY,GACvB,CAACN,GAAWO,CAAY,IAAIC;AAAA,IAChC,OAAO,WAAa,MAAc,SAAS,iBAAiB;AAAA,EAC9D;AAEA,EAAAC,EAAU,MAAM;AACd,UAAMC,IAAoB,MAAM;AACjB,MAAAH,EAAA,SAAS,cAAc,GAC3BF,EAAA;AAAA,IACX;AAES,oBAAA,iBAAiB,mBAAmBK,CAAiB,GACvD,MAAM,SAAS,oBAAoB,mBAAmBA,CAAiB;AAAA,EAChF,GAAG,EAAE;AAEC,QAAAC,KAAOX,KAAA,gBAAAA,EAAW,eAAc,IAChCY,IAASZ,IAAYD,EAAmBC,CAAS,IAAI,CAAC,GACtDa,IAAQD,EAAO,IAAI,CAACE,MAAUA,EAAM,uBAAuB;AAE1D,SAAA;AAAA,IACL,MAAAH;AAAA,IACA,QAAAC;AAAA,IACA,OAAAC;AAAA,IACA,WAAAb;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useThrottleCallback/useThrottleCallback.mjs

@@ -0,0 +1,11 @@
+import { useMemo as e } from "react";
+import { useEvent as l } from "../useEvent/useEvent.mjs";
+import { throttle as m } from "../../utils/helpers/throttle.mjs";
+const h = (o, t) => {
+  const r = l(o);
+  return e(() => m(r, t), [t]);
+};
+export {
+  h as useThrottleCallback
+};
+//# sourceMappingURL=useThrottleCallback.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useThrottleCallback.mjs","sources":["../../../../src/hooks/useThrottleCallback/useThrottleCallback.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport { throttle } from '@/utils/helpers';\n\nimport { useEvent } from '../useEvent/useEvent';\n\n/**\n * @name useThrottleCallback\n * @description - Hook that creates a throttled callback\n * @category Utilities\n *\n * @template Params The type of the params\n * @template Return The type of the return\n * @param {(...args: Params) => Return} callback The callback function\n * @param {number} delay The delay in milliseconds\n * @returns {(...args: Params) => Return} The callback with throttle\n *\n * @example\n * const throttled = useThrottleCallback(() => console.log('callback'), 500);\n */\nexport const useThrottleCallback = <Params extends unknown[], Return>(\n  callback: (...args: Params) => Return,\n  delay: number\n) => {\n  const internalCallback = useEvent(callback);\n  const throttled = useMemo(() => throttle(internalCallback, delay), [delay]);\n\n  return throttled;\n};\n"],"names":["useThrottleCallback","callback","delay","internalCallback","useEvent","useMemo","throttle"],"mappings":";;;AAoBa,MAAAA,IAAsB,CACjCC,GACAC,MACG;AACG,QAAAC,IAAmBC,EAASH,CAAQ;AAGnC,SAFWI,EAAQ,MAAMC,EAASH,GAAkBD,CAAK,GAAG,CAACA,CAAK,CAAC;AAG5E;"}

package/dist/esm/hooks/useThrottleValue/useThrottleValue.mjs

@@ -0,0 +1,12 @@
+import { useRef as c, useState as n, useEffect as f } from "react";
+import { useThrottleCallback as l } from "../useThrottleCallback/useThrottleCallback.mjs";
+const m = (t, r) => {
+  const e = c(t), [o, s] = n(t), u = l(s, r);
+  return f(() => {
+    e.current !== t && (u(t), e.current = t);
+  }, [t]), o;
+};
+export {
+  m as useThrottleValue
+};
+//# sourceMappingURL=useThrottleValue.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useThrottleValue.mjs","sources":["../../../../src/hooks/useThrottleValue/useThrottleValue.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport { useThrottleCallback } from '../useThrottleCallback/useThrottleCallback';\n\n/**\n * @name useThrottleValue\n * @description - Hook that creates a throttled value\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value} value The value to be throttled\n * @param {number} delay The delay in milliseconds\n * @returns {Value} The throttled value\n *\n * @example\n * const throttledValue = useThrottleValue(value, 500);\n */\nexport const useThrottleValue = <Value>(value: Value, delay: number) => {\n  const previousValueRef = useRef(value);\n  const [throttledValue, setThrottleValue] = useState(value);\n\n  const throttledSetState = useThrottleCallback(setThrottleValue, delay);\n\n  useEffect(() => {\n    if (previousValueRef.current === value) return;\n    throttledSetState(value);\n    previousValueRef.current = value;\n  }, [value]);\n\n  return throttledValue;\n};\n"],"names":["useThrottleValue","value","delay","previousValueRef","useRef","throttledValue","setThrottleValue","useState","throttledSetState","useThrottleCallback","useEffect"],"mappings":";;AAiBa,MAAAA,IAAmB,CAAQC,GAAcC,MAAkB;AAChE,QAAAC,IAAmBC,EAAOH,CAAK,GAC/B,CAACI,GAAgBC,CAAgB,IAAIC,EAASN,CAAK,GAEnDO,IAAoBC,EAAoBH,GAAkBJ,CAAK;AAErE,SAAAQ,EAAU,MAAM;AACV,IAAAP,EAAiB,YAAYF,MACjCO,EAAkBP,CAAK,GACvBE,EAAiB,UAAUF;AAAA,EAAA,GAC1B,CAACA,CAAK,CAAC,GAEHI;AACT;"}

package/dist/esm/hooks/useTime/useTime.mjs

@@ -0,0 +1,11 @@
+import { useState as m } from "react";
+import { useInterval as o } from "../useInterval/useInterval.mjs";
+import { getDate as e } from "../../utils/helpers/getDate.mjs";
+const p = () => {
+  const [t, r] = m(e());
+  return o(() => r(e()), 1e3), t;
+};
+export {
+  p as useTime
+};
+//# sourceMappingURL=useTime.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTime.mjs","sources":["../../../../src/hooks/useTime/useTime.ts"],"sourcesContent":["import { useState } from 'react';\n\nimport { getDate } from '@/utils/helpers';\n\nimport { useInterval } from '../useInterval/useInterval';\n\nexport interface UseTimeReturn {\n  day: number;\n  hours: number;\n  meridiemHours: { value: number; type: string };\n  minutes: number;\n  month: number;\n  seconds: number;\n  timestamp: number;\n  year: number;\n}\n\n/**\n * @name useTime\n * @description - Hook that gives you current time in different values\n * @category Time\n *\n * @returns {UseTimeReturn} An object containing the current time\n *\n * @example\n * const { seconds, minutes, hours, meridiemHours, day, month, year, timestamp } = useTime();\n */\nexport const useTime = (): UseTimeReturn => {\n  const [time, setTime] = useState(getDate());\n  useInterval(() => setTime(getDate()), 1000);\n  return time;\n};\n"],"names":["useTime","time","setTime","useState","getDate","useInterval"],"mappings":";;;AA2BO,MAAMA,IAAU,MAAqB;AAC1C,QAAM,CAACC,GAAMC,CAAO,IAAIC,EAASC,GAAS;AAC1C,SAAAC,EAAY,MAAMH,EAAQE,EAAS,CAAA,GAAG,GAAI,GACnCH;AACT;"}

package/dist/esm/hooks/useTimeout/useTimeout.mjs

@@ -0,0 +1,16 @@
+import { useState as n, useRef as s, useEffect as a } from "react";
+import { useEvent as i } from "../useEvent/useEvent.mjs";
+function T(u, t) {
+  const [o, r] = n(!1), e = s(), c = i(u);
+  return a(() => (e.current = setTimeout(() => {
+    c(), r(!0);
+  }, t), () => {
+    clearTimeout(e.current);
+  }), [t]), { ready: o, clear: () => {
+    clearTimeout(e.current), r(!0);
+  } };
+}
+export {
+  T as useTimeout
+};
+//# sourceMappingURL=useTimeout.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeout.mjs","sources":["../../../../src/hooks/useTimeout/useTimeout.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../useEvent/useEvent';\n\n/** The use timeout return type */\ninterface UseTimeoutReturn {\n  /**  Timeout is ready state value */\n  ready: boolean;\n  /** Function to clear timeout */\n  clear: () => void;\n}\n\n/**\n * @name useTimeout\n * @description - Hook that executes a callback function after a specified delay\n * @category Time\n *\n * @param {() => void} callback The function to be executed after the timeout\n * @param {number} delay The delay in milliseconds before the timeout executes the callback function\n * @returns {UseTimeoutReturn} An object with a `ready` boolean state value and a `clear` function to clear timeout\n *\n * @example\n * const { clear, ready } = useTimeout(() => {}, 5000);\n */\nexport function useTimeout(callback: () => void, delay: number): UseTimeoutReturn {\n  const [ready, setReady] = useState(false);\n\n  const timeoutIdRef = useRef<ReturnType<typeof setTimeout>>();\n  const internalCallback = useEvent(callback);\n\n  useEffect(() => {\n    timeoutIdRef.current = setTimeout(() => {\n      internalCallback();\n      setReady(true);\n    }, delay);\n\n    return () => {\n      clearTimeout(timeoutIdRef.current);\n    };\n  }, [delay]);\n\n  const clear = () => {\n    clearTimeout(timeoutIdRef.current);\n    setReady(true);\n  };\n\n  return { ready, clear };\n}\n"],"names":["useTimeout","callback","delay","ready","setReady","useState","timeoutIdRef","useRef","internalCallback","useEvent","useEffect"],"mappings":";;AAwBgB,SAAAA,EAAWC,GAAsBC,GAAiC;AAChF,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAAS,EAAK,GAElCC,IAAeC,EAAsC,GACrDC,IAAmBC,EAASR,CAAQ;AAE1C,SAAAS,EAAU,OACKJ,EAAA,UAAU,WAAW,MAAM;AACrB,IAAAE,EAAA,GACjBJ,EAAS,EAAI;AAAA,KACZF,CAAK,GAED,MAAM;AACX,iBAAaI,EAAa,OAAO;AAAA,EACnC,IACC,CAACJ,CAAK,CAAC,GAOH,EAAE,OAAAC,GAAO,OALF,MAAM;AAClB,iBAAaG,EAAa,OAAO,GACjCF,EAAS,EAAI;AAAA,EACf,EAEsB;AACxB;"}

package/dist/esm/hooks/useTimer/useTimer.mjs

@@ -0,0 +1,69 @@
+import { useState as v, useRef as M, useEffect as k } from "react";
+import { useDidUpdate as A } from "../useDidUpdate/useDidUpdate.mjs";
+const D = (s) => {
+  const e = Math.ceil(s), c = Math.floor(e / (60 * 60 * 24)), u = Math.floor(e % (60 * 60 * 24) / (60 * 60)), t = Math.floor(e % (60 * 60) / 60);
+  return {
+    seconds: Math.floor(e % 60),
+    minutes: t,
+    hours: u,
+    days: c
+  };
+}, q = (...s) => {
+  const e = Math.max(s[0] ?? 0, 0), c = typeof s[1] == "object" ? s[1] : { onExpire: s[1] }, [u, t] = v(e > 0 && ((c == null ? void 0 : c.immediately) ?? !0)), [i, n] = v(e), m = M(), f = M();
+  f.current = c ?? {}, A(() => {
+    if (e <= 0) {
+      t(!1), n(0);
+      return;
+    }
+    t(!0), n(e);
+  }, [e]), k(() => {
+    var r, a;
+    if (!u) return;
+    (a = (r = f.current) == null ? void 0 : r.onStart) == null || a.call(r);
+    const o = () => {
+      var d, p;
+      (p = (d = f.current) == null ? void 0 : d.onTick) == null || p.call(d, i), n((j) => {
+        var l, S;
+        const h = j - 1;
+        return h === 0 && (t(!1), (S = (l = f.current) == null ? void 0 : l.onExpire) == null || S.call(l)), h;
+      });
+    };
+    return m.current = setInterval(o, 1e3), () => {
+      clearInterval(m.current);
+    };
+  }, [u]);
+  const x = () => t(!1), I = () => {
+    i <= 0 || t(!0);
+  }, T = () => {
+    i <= 0 || t(!u);
+  }, g = (o, r = !0) => {
+    n(o), r && t(!0);
+  }, y = () => {
+    e <= 0 || (t(!0), n(e));
+  }, E = () => {
+    t(!1), n(0);
+  }, R = (o) => n((r) => r + o), b = (o) => {
+    n((r) => {
+      const a = r - o;
+      return a <= 0 ? (t(!1), 0) : a;
+    });
+  };
+  return {
+    ...D(i),
+    count: i,
+    pause: x,
+    active: u,
+    resume: I,
+    toggle: T,
+    start: y,
+    restart: g,
+    clear: E,
+    increase: R,
+    decrease: b
+  };
+};
+export {
+  D as getTimeFromSeconds,
+  q as useTimer
+};
+//# sourceMappingURL=useTimer.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTimer.mjs","sources":["../../../../src/hooks/useTimer/useTimer.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport { useDidUpdate } from '../useDidUpdate/useDidUpdate';\n\nexport type PositiveInteger<Value extends number> = `${Value}` extends `-${any}` | `${any}.${any}`\n  ? never\n  : Value;\n\nexport const getTimeFromSeconds = (timestamp: number) => {\n  const roundedTimestamp = Math.ceil(timestamp);\n  const days = Math.floor(roundedTimestamp / (60 * 60 * 24));\n  const hours = Math.floor((roundedTimestamp % (60 * 60 * 24)) / (60 * 60));\n  const minutes = Math.floor((roundedTimestamp % (60 * 60)) / 60);\n  const seconds = Math.floor(roundedTimestamp % 60);\n\n  return {\n    seconds,\n    minutes,\n    hours,\n    days\n  };\n};\n\n/** The use timer options type */\nexport interface UseTimerOptions {\n  /** Whether the timer should start automatically */\n  immediately?: boolean;\n  /** The function to be executed when the timer is expired */\n  onExpire?: () => void;\n  /** The function to be executed when the timer is started */\n  onStart?: () => void;\n  /** Callback function to be executed on each tick of the timer */\n  onTick?: (seconds: number) => void;\n}\n\n/** The use timer return type */\nexport interface UseTimerReturn {\n  /** flag to indicate if timer is active or not */\n  active: boolean;\n  /** The total count of the timer */\n  count: number;\n  /** The day count of the timer */\n  days: number;\n  /** The hour count of the timer */\n  hours: number;\n  /** The minute count of the timer */\n  minutes: number;\n  /** The second count of the timer */\n  seconds: number;\n  /** The function to clear the timer */\n  clear: () => void;\n  /** The function to decrease the timer */\n  decrease: (seconds: PositiveInteger<number>) => void;\n  /** The function to increase the timer */\n  increase: (seconds: PositiveInteger<number>) => void;\n  /** The function to pause the timer */\n  pause: () => void;\n  /** The function to restart the timer */\n  restart: (time: PositiveInteger<number>, immediately?: boolean) => void;\n  /** The function to resume the timer */\n  resume: () => void;\n  /** The function to start the timer */\n  start: () => void;\n  /** The function to toggle the timer */\n  toggle: () => void;\n}\n\nexport interface UseTimer {\n  (): UseTimerReturn;\n\n  (seconds: PositiveInteger<number>, callback: () => void): UseTimerReturn;\n\n  (seconds: PositiveInteger<number>, options?: UseTimerOptions): UseTimerReturn;\n}\n\n/**\n * @name useTimer\n * @description - Hook that creates a timer functionality\n * @category Time\n *\n * @overload\n * @returns {UseTimerReturn} An object containing the timer properties and functions\n *\n * @example\n * const { days, hours, minutes, seconds, toggle, pause, start, restart, resume, active, decrease, increase } = useTimer();\n *\n * @overload\n * @param {number} seconds The seconds value that define for how long the timer will be running\n * @param {() => void} callback The function to be executed once countdown timer is expired\n * @returns {UseTimerReturn} An object containing the timer properties and functions\n *\n * @example\n * const { days, hours, minutes, seconds, toggle, pause, start, restart, resume, active, decrease, increase } = useTimer(1000, () => console.log('ready'));\n *\n * @overload\n * @param {number} seconds The seconds value that define for how long the timer will be running\n * @param {boolean} [options.immediately=true] The flag to decide if timer should start automatically\n * @param {() => void} [options.onExpire] The function to be executed when the timer is expired\n * @param {(timestamp: number) => void} [options.onTick] The function to be executed on each tick of the timer\n * @returns {UseTimerReturn} An object containing the timer properties and functions\n *\n * @example\n * const { days, hours, minutes, seconds, toggle, pause, start, restart, resume, active, decrease, increase } = useTimer(1000);\n */\nexport const useTimer = ((...params: any[]) => {\n  const initialSeconds = Math.max((params[0] ?? 0) as PositiveInteger<number>, 0);\n  const options = (typeof params[1] === 'object' ? params[1] : { onExpire: params[1] }) as\n    | UseTimerOptions\n    | undefined;\n\n  const [active, setActive] = useState(initialSeconds > 0 && (options?.immediately ?? true));\n  const [seconds, setSeconds] = useState(initialSeconds);\n\n  const intervalIdRef = useRef<ReturnType<typeof setInterval>>();\n  const optionsRef = useRef<UseTimerOptions>();\n  optionsRef.current = options ?? {};\n\n  useDidUpdate(() => {\n    if (initialSeconds <= 0) {\n      setActive(false);\n      setSeconds(0);\n      return;\n    }\n\n    setActive(true);\n    setSeconds(initialSeconds);\n  }, [initialSeconds]);\n\n  useEffect(() => {\n    if (!active) return;\n\n    optionsRef.current?.onStart?.();\n    const onInterval = () => {\n      optionsRef.current?.onTick?.(seconds);\n      setSeconds((prevSeconds) => {\n        const updatedSeconds = prevSeconds - 1;\n        if (updatedSeconds === 0) {\n          setActive(false);\n          optionsRef.current?.onExpire?.();\n        }\n        return updatedSeconds;\n      });\n    };\n\n    intervalIdRef.current = setInterval(onInterval, 1000);\n    return () => {\n      clearInterval(intervalIdRef.current);\n    };\n  }, [active]);\n\n  const pause = () => setActive(false);\n  const resume = () => {\n    if (seconds <= 0) return;\n    setActive(true);\n  };\n\n  const toggle = () => {\n    if (seconds <= 0) return;\n    setActive(!active);\n  };\n\n  const restart = (seconds: PositiveInteger<number>, immediately = true) => {\n    setSeconds(seconds);\n    if (immediately) setActive(true);\n  };\n\n  const start = () => {\n    if (initialSeconds <= 0) return;\n\n    setActive(true);\n    setSeconds(initialSeconds);\n  };\n\n  const clear = () => {\n    setActive(false);\n    setSeconds(0);\n  };\n\n  const increase = (seconds: PositiveInteger<number>) =>\n    setSeconds((prevSeconds) => prevSeconds + seconds);\n  const decrease = (seconds: PositiveInteger<number>) => {\n    setSeconds((prevSeconds) => {\n      const updatedSeconds = prevSeconds - seconds;\n      if (updatedSeconds <= 0) {\n        setActive(false);\n        return 0;\n      } else {\n        return updatedSeconds;\n      }\n    });\n  };\n\n  return {\n    ...getTimeFromSeconds(seconds),\n    count: seconds,\n    pause,\n    active,\n    resume,\n    toggle,\n    start,\n    restart,\n    clear,\n    increase,\n    decrease\n  };\n}) as UseTimer;\n"],"names":["getTimeFromSeconds","timestamp","roundedTimestamp","days","hours","minutes","useTimer","params","initialSeconds","options","active","setActive","useState","seconds","setSeconds","intervalIdRef","useRef","optionsRef","useDidUpdate","useEffect","_b","_a","onInterval","prevSeconds","updatedSeconds","pause","resume","toggle","restart","immediately","start","clear","increase","decrease"],"mappings":";;AAQa,MAAAA,IAAqB,CAACC,MAAsB;AACjD,QAAAC,IAAmB,KAAK,KAAKD,CAAS,GACtCE,IAAO,KAAK,MAAMD,KAAoB,KAAK,KAAK,GAAG,GACnDE,IAAQ,KAAK,MAAOF,KAAoB,KAAK,KAAK,OAAQ,KAAK,GAAG,GAClEG,IAAU,KAAK,MAAOH,KAAoB,KAAK,MAAO,EAAE;AAGvD,SAAA;AAAA,IACL,SAHc,KAAK,MAAMA,IAAmB,EAAE;AAAA,IAI9C,SAAAG;AAAA,IACA,OAAAD;AAAA,IACA,MAAAD;AAAA,EACF;AACF,GAmFaG,IAAY,IAAIC,MAAkB;AAC7C,QAAMC,IAAiB,KAAK,IAAKD,EAAO,CAAC,KAAK,GAA+B,CAAC,GACxEE,IAAW,OAAOF,EAAO,CAAC,KAAM,WAAWA,EAAO,CAAC,IAAI,EAAE,UAAUA,EAAO,CAAC,EAAE,GAI7E,CAACG,GAAQC,CAAS,IAAIC,EAASJ,IAAiB,OAAMC,KAAA,gBAAAA,EAAS,gBAAe,GAAK,GACnF,CAACI,GAASC,CAAU,IAAIF,EAASJ,CAAc,GAE/CO,IAAgBC,EAAuC,GACvDC,IAAaD,EAAwB;AAChC,EAAAC,EAAA,UAAUR,KAAW,CAAC,GAEjCS,EAAa,MAAM;AACjB,QAAIV,KAAkB,GAAG;AACvB,MAAAG,EAAU,EAAK,GACfG,EAAW,CAAC;AACZ;AAAA,IAAA;AAGF,IAAAH,EAAU,EAAI,GACdG,EAAWN,CAAc;AAAA,EAAA,GACxB,CAACA,CAAc,CAAC,GAEnBW,EAAU,MAAM;;AACd,QAAI,CAACT,EAAQ;AAEb,KAAAU,KAAAC,IAAAJ,EAAW,YAAX,gBAAAI,EAAoB,YAApB,QAAAD,EAAA,KAAAC;AACA,UAAMC,IAAa,MAAM;;AACZ,OAAAF,KAAAC,IAAAJ,EAAA,YAAA,gBAAAI,EAAS,WAAT,QAAAD,EAAA,KAAAC,GAAkBR,IAC7BC,EAAW,CAACS,MAAgB;;AAC1B,cAAMC,IAAiBD,IAAc;AACrC,eAAIC,MAAmB,MACrBb,EAAU,EAAK,IACfS,KAAAC,IAAAJ,EAAW,YAAX,gBAAAI,EAAoB,aAApB,QAAAD,EAAA,KAAAC,KAEKG;AAAA,MAAA,CACR;AAAA,IACH;AAEc,WAAAT,EAAA,UAAU,YAAYO,GAAY,GAAI,GAC7C,MAAM;AACX,oBAAcP,EAAc,OAAO;AAAA,IACrC;AAAA,EAAA,GACC,CAACL,CAAM,CAAC;AAEL,QAAAe,IAAQ,MAAMd,EAAU,EAAK,GAC7Be,IAAS,MAAM;AACnB,IAAIb,KAAW,KACfF,EAAU,EAAI;AAAA,EAChB,GAEMgB,IAAS,MAAM;AACnB,IAAId,KAAW,KACfF,EAAU,CAACD,CAAM;AAAA,EACnB,GAEMkB,IAAU,CAACf,GAAkCgB,IAAc,OAAS;AACxE,IAAAf,EAAWD,CAAO,GACdgB,OAAuB,EAAI;AAAA,EACjC,GAEMC,IAAQ,MAAM;AAClB,IAAItB,KAAkB,MAEtBG,EAAU,EAAI,GACdG,EAAWN,CAAc;AAAA,EAC3B,GAEMuB,IAAQ,MAAM;AAClB,IAAApB,EAAU,EAAK,GACfG,EAAW,CAAC;AAAA,EACd,GAEMkB,IAAW,CAACnB,MAChBC,EAAW,CAACS,MAAgBA,IAAcV,CAAO,GAC7CoB,IAAW,CAACpB,MAAqC;AACrD,IAAAC,EAAW,CAACS,MAAgB;AAC1B,YAAMC,IAAiBD,IAAcV;AACrC,aAAIW,KAAkB,KACpBb,EAAU,EAAK,GACR,KAEAa;AAAA,IACT,CACD;AAAA,EACH;AAEO,SAAA;AAAA,IACL,GAAGxB,EAAmBa,CAAO;AAAA,IAC7B,OAAOA;AAAA,IACP,OAAAY;AAAA,IACA,QAAAf;AAAA,IACA,QAAAgB;AAAA,IACA,QAAAC;AAAA,IACA,OAAAG;AAAA,IACA,SAAAF;AAAA,IACA,OAAAG;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useToggle/useToggle.mjs

@@ -0,0 +1,12 @@
+import { useReducer as t } from "react";
+const f = (r = [!1, !0]) => {
+  const [[c], u] = t((e, o) => {
+    const s = typeof o == "function" ? o(e[0]) : o, n = Math.abs(e.indexOf(s));
+    return e.slice(n).concat(e.slice(0, n));
+  }, r);
+  return [c, u];
+};
+export {
+  f as useToggle
+};
+//# sourceMappingURL=useToggle.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useToggle.mjs","sources":["../../../../src/hooks/useToggle/useToggle.ts"],"sourcesContent":["import type { SetStateAction } from 'react';\n\nimport { useReducer } from 'react';\n\n/** The use toggle return type */\nexport type UseToggleReturn<Value> = readonly [Value, (value?: Value) => void];\n\n/**\n * @name useToggle\n * @description - Hook that create toggle\n * @category Utilities\n *\n * @template Value The type of the value\n * @param {Value[]} [values=[false, true]] The values to toggle\n *\n * @example\n * const [on, toggle] = useToggle();\n *\n * @example\n * const [value, toggle] = useToggle(['light', 'dark'] as const);\n */\nexport const useToggle = <Value = boolean>(values: readonly Value[] = [false, true] as any) => {\n  const [[option], toggle] = useReducer((state: Value[], action: SetStateAction<Value>) => {\n    const value =\n      typeof action === 'function' ? (action as (prevState: Value) => Value)(state[0]) : action;\n    const index = Math.abs(state.indexOf(value));\n    return state.slice(index).concat(state.slice(0, index));\n  }, values as Value[]);\n\n  return [option, toggle as (value?: SetStateAction<Value>) => void] as const;\n};\n"],"names":["useToggle","values","option","toggle","useReducer","state","action","value","index"],"mappings":";AAqBO,MAAMA,IAAY,CAAkBC,IAA2B,CAAC,IAAO,EAAI,MAAa;AACvF,QAAA,CAAC,CAACC,CAAM,GAAGC,CAAM,IAAIC,EAAW,CAACC,GAAgBC,MAAkC;AACjF,UAAAC,IACJ,OAAOD,KAAW,aAAcA,EAAuCD,EAAM,CAAC,CAAC,IAAIC,GAC/EE,IAAQ,KAAK,IAAIH,EAAM,QAAQE,CAAK,CAAC;AACpC,WAAAF,EAAM,MAAMG,CAAK,EAAE,OAAOH,EAAM,MAAM,GAAGG,CAAK,CAAC;AAAA,KACrDP,CAAiB;AAEb,SAAA,CAACC,GAAQC,CAAiD;AACnE;"}

package/dist/esm/hooks/useUnmount/useUnmount.mjs

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUnmount.mjs","sources":["../../../../src/hooks/useUnmount/useUnmount.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\n/**\n * @name useUnmount\n * @description - Hook that defines the logic when unmounting a component\n * @category Lifecycle\n *\n * @param {() => void} callback The callback function to be invoked on component unmount\n * @returns {void}\n *\n * @example\n * useUnmount(() => console.log('This effect runs on component unmount'));\n */\n\nexport const useUnmount = (callback: () => void) => {\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(\n    () => () => {\n      internalCallbackRef.current();\n    },\n    []\n  );\n};\n"],"names":["useUnmount","callback","internalCallbackRef","useRef","useEffect"],"mappings":";AAca,MAAAA,IAAa,CAACC,MAAyB;AAC5C,QAAAC,IAAsBC,EAAOF,CAAQ;AAC3C,EAAAC,EAAoB,UAAUD,GAE9BG;AAAA,IACE,MAAM,MAAM;AACV,MAAAF,EAAoB,QAAQ;AAAA,IAC9B;AAAA,IACA,CAAA;AAAA,EACF;AACF;"}

package/dist/esm/hooks/useVibrate/useVibrate.mjs

@@ -0,0 +1,22 @@
+import { useRef as v, useState as l, useEffect as g } from "react";
+const I = (a, t = 0) => {
+  const e = typeof navigator < "u" && "vibrate" in navigator, r = v(), [f, n] = l(!1), c = (u = a) => {
+    e && navigator.vibrate(u);
+  }, s = () => {
+    e && (navigator.vibrate(0), n(!1), r.current && clearInterval(r.current));
+  }, o = () => {
+    e && (n(!1), r.current && clearInterval(r.current));
+  }, i = (u = t) => {
+    e && (r.current && clearInterval(r.current), n(!0), r.current = setInterval(c, u));
+  };
+  return g(() => {
+    if (!(!e || t <= 0))
+      return i(t), () => {
+        s();
+      };
+  }, [t, a]), { supported: e, trigger: c, stop: s, active: f, pause: o, resume: i };
+};
+export {
+  I as useVibrate
+};
+//# sourceMappingURL=useVibrate.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVibrate.mjs","sources":["../../../../src/hooks/useVibrate/useVibrate.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** The use vibrate pattern type */\nexport type UseVibratePattern = number | number[];\n\n/** The use vibrate return type */\nexport interface UseVibrateReturn {\n  /** The support indicator */\n  supported: boolean;\n  /** The vibrating indicator */\n  vibrating: boolean;\n  /** The pause function */\n  pause: () => void;\n  /** The resume function */\n  resume: () => void;\n  /** The start function */\n  start: (interval: number) => void;\n  /** The vibrate function */\n  trigger: (pattern?: UseVibratePattern) => void;\n}\n\n/**\n * @name useVibrate\n * @description - Hook that provides vibrate api\n * @category Browser\n *\n * @browserapi navigator.vibrate https://developer.mozilla.org/en-US/docs/Web/API/Navigator/vibrate\n *\n * @overload\n * @param {UseVibratePattern} options.pattern The pattern for vibration\n * @param {number} [options.interval=0] Time in milliseconds between vibrations\n * @returns {UseVibrateReturn} An object containing support indicator, start vibration and stop vibration functions\n *\n * @example\n * const { supported, active, vibrate, stop, pause, resume } = useVibrate(1000);\n */\nexport const useVibrate = (pattern: UseVibratePattern, interval: number = 0) => {\n  const supported = typeof navigator !== 'undefined' && 'vibrate' in navigator;\n\n  const intervalIdRef = useRef<ReturnType<typeof setInterval>>();\n  const [active, setActive] = useState(false);\n\n  const trigger = (internalPattern: UseVibratePattern = pattern) => {\n    if (!supported) return;\n    navigator.vibrate(internalPattern);\n  };\n\n  const stop = () => {\n    if (!supported) return;\n    navigator.vibrate(0);\n    setActive(false);\n    if (intervalIdRef.current) clearInterval(intervalIdRef.current);\n  };\n\n  const pause = () => {\n    if (!supported) return;\n    setActive(false);\n    if (intervalIdRef.current) clearInterval(intervalIdRef.current);\n  };\n\n  const resume = (intervalInterval: number = interval) => {\n    if (!supported) return;\n    if (intervalIdRef.current) clearInterval(intervalIdRef.current);\n    setActive(true);\n    intervalIdRef.current = setInterval(trigger, intervalInterval);\n  };\n\n  useEffect(() => {\n    if (!supported || interval <= 0) return;\n    resume(interval);\n    return () => {\n      stop();\n    };\n  }, [interval, pattern]);\n\n  return { supported, trigger, stop, active, pause, resume };\n};\n"],"names":["useVibrate","pattern","interval","supported","intervalIdRef","useRef","active","setActive","useState","trigger","internalPattern","stop","pause","resume","intervalInterval","useEffect"],"mappings":";AAoCO,MAAMA,IAAa,CAACC,GAA4BC,IAAmB,MAAM;AAC9E,QAAMC,IAAY,OAAO,YAAc,OAAe,aAAa,WAE7DC,IAAgBC,EAAuC,GACvD,CAACC,GAAQC,CAAS,IAAIC,EAAS,EAAK,GAEpCC,IAAU,CAACC,IAAqCT,MAAY;AAChE,IAAKE,KACL,UAAU,QAAQO,CAAe;AAAA,EACnC,GAEMC,IAAO,MAAM;AACjB,IAAKR,MACL,UAAU,QAAQ,CAAC,GACnBI,EAAU,EAAK,GACXH,EAAc,WAAuB,cAAAA,EAAc,OAAO;AAAA,EAChE,GAEMQ,IAAQ,MAAM;AAClB,IAAKT,MACLI,EAAU,EAAK,GACXH,EAAc,WAAuB,cAAAA,EAAc,OAAO;AAAA,EAChE,GAEMS,IAAS,CAACC,IAA2BZ,MAAa;AACtD,IAAKC,MACDC,EAAc,WAAuB,cAAAA,EAAc,OAAO,GAC9DG,EAAU,EAAI,GACAH,EAAA,UAAU,YAAYK,GAASK,CAAgB;AAAA,EAC/D;AAEA,SAAAC,EAAU,MAAM;AACV,QAAA,GAACZ,KAAaD,KAAY;AAC9B,aAAAW,EAAOX,CAAQ,GACR,MAAM;AACN,QAAAS,EAAA;AAAA,MACP;AAAA,EAAA,GACC,CAACT,GAAUD,CAAO,CAAC,GAEf,EAAE,WAAAE,GAAW,SAAAM,GAAS,MAAAE,GAAM,QAAAL,GAAQ,OAAAM,GAAO,QAAAC,EAAO;AAC3D;"}