@siberiacancode/reactuse 0.3.14 → 0.3.17

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

@@ -1 +1 @@
-{"version":3,"file":"useSpeechRecognition.mjs","sources":["../../../../src/hooks/useSpeechRecognition/useSpeechRecognition.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech recognition hook options type */\ninterface UseSpeechRecognitionOptions {\n  /** If true, recognition continues even after pauses in speech. Default is false */\n  continuous?: SpeechRecognition['continuous'];\n  /** A list of grammar rules */\n  grammars?: SpeechRecognition['grammars'];\n  /** If true, interim (non-final) results are provided as the user speaks */\n  interimResults?: SpeechRecognition['interimResults'];\n  /** The language in which recognition should occur. Must be a valid BCP 47 language tag (e.g., \"en-US\", \"ru-RU\") */\n  language?: SpeechRecognition['lang'];\n  /** The maximum number of alternative transcripts returned for a given recognition result. Must be a positive integer */\n  maxAlternatives?: SpeechRecognition['maxAlternatives'];\n  /** Callback invoked when speech recognition ends */\n  onEnd?: () => void;\n  /** Callback invoked when an error occurs during recognition */\n  onError?: (error: SpeechRecognitionErrorEvent) => void;\n  /** Callback invoked when recognition produces a result */\n  onResult?: (event: SpeechRecognitionEvent) => void;\n  /** Callback invoked when speech recognition starts */\n  onStart?: () => void;\n}\n\n/** The return type of the useSpeechRecognition hook. */\ninterface UseSpeechRecognitionReturn {\n  /** The error state */\n  error: SpeechRecognitionErrorEvent | null;\n  /** The final transcript */\n  final: boolean;\n  /** Whether the hook is currently listening for speech */\n  listening: boolean;\n  /** The speech recognition instance */\n  recognition?: SpeechRecognition;\n  /** Whether the current browser supports the Web Speech API */\n  supported: boolean;\n  /** The current transcript */\n  transcript: string;\n  /** Begins speech recognition */\n  start: () => void;\n  /** Ends speech recognition, finalizing results */\n  stop: () => void;\n  /** Toggles the listening state */\n  toggle: (value?: boolean) => void;\n}\n\nexport const getSpeechRecognition = () =>\n  window?.SpeechRecognition ?? window?.webkitSpeechRecognition;\n\n/**\n * @name useSpeechRecognition\n * @description - Hook that provides a streamlined interface for incorporating speech-to-text functionality\n * @category Browser\n * @usage low\n *\n * @browserapi window.SpeechRecognition https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition\n *\n * @param {boolean} [options.continuous=false] Whether recognition should continue after pauses\n * @param {boolean} [options.interimResults=false] Whether interim results should be provided\n * @param {string} [options.language=\"en-US\"] The language for recognition, as a valid BCP 47 tag\n * @param {number} [options.maxAlternatives=1] The maximum number of alternative transcripts to return\n * @param {SpeechGrammarList} [options.grammars] A list of grammar rules\n * @param {() => void} [options.onStart] Callback invoked when speech recognition starts\n * @param {() => void} [options.onEnd] Callback invoked when speech recognition ends\n * @param {(error: SpeechRecognitionErrorEvent) => void} [options.onError] Callback invoked when an error occurs during recognition\n * @param {(event: SpeechRecognitionEvent) => void} [options.onResult] Callback invoked when recognition produces a result\n * @returns {UseSpeechRecognitionReturn} An object containing the speech recognition functionality\n *\n * @example\n * const { supported, value, recognition, listening, error, start, stop, toggle  } = useSpeechRecognition();\n */\nexport const useSpeechRecognition = (\n  options: UseSpeechRecognitionOptions = {}\n): UseSpeechRecognitionReturn => {\n  const supported = typeof window !== 'undefined' && !!getSpeechRecognition();\n\n  const {\n    continuous = false,\n    interimResults = false,\n    language = 'en-US',\n    grammars,\n    maxAlternatives = 1,\n    onStart,\n    onEnd,\n    onError,\n    onResult\n  } = options;\n\n  const [listening, setListening] = useState(false);\n  const [transcript, setTranscript] = useState('');\n  const [final, setFinal] = useState(false);\n  const [error, setError] = useState<SpeechRecognitionErrorEvent | null>(null);\n  const [recognition] = useState<SpeechRecognition | undefined>(() => {\n    if (!supported) return undefined;\n\n    const SpeechRecognition = getSpeechRecognition();\n    const speechRecognition = new SpeechRecognition();\n\n    speechRecognition.continuous = continuous;\n    if (grammars) speechRecognition.grammars = grammars;\n    speechRecognition.interimResults = interimResults;\n    speechRecognition.lang = language;\n    speechRecognition.maxAlternatives = maxAlternatives;\n\n    speechRecognition.onstart = () => {\n      setListening(true);\n      setFinal(false);\n      onStart?.();\n    };\n    speechRecognition.onerror = (event) => {\n      setError(event);\n      setListening(false);\n      onError?.(event);\n    };\n    speechRecognition.onresult = (event) => {\n      const currentResult = event.results[event.resultIndex];\n      const { transcript } = currentResult[0];\n\n      setListening(false);\n      setTranscript(transcript);\n      setError(null);\n      onResult?.(event);\n    };\n    speechRecognition.onend = () => {\n      setListening(false);\n      onEnd?.();\n      speechRecognition.lang = language;\n    };\n\n    return speechRecognition;\n  });\n\n  useEffect(() => () => recognition?.stop(), []);\n\n  const start = () => recognition?.start();\n  const stop = () => recognition?.stop();\n\n  const toggle = (value = !listening) => {\n    if (value) return start();\n    return stop();\n  };\n\n  return {\n    supported,\n    transcript,\n    recognition,\n    final,\n    listening,\n    error,\n    start,\n    stop,\n    toggle\n  };\n};\n"],"names":["getSpeechRecognition","useSpeechRecognition","options","supported","continuous","interimResults","language","grammars","maxAlternatives","onStart","onEnd","onError","onResult","listening","setListening","useState","transcript","setTranscript","final","setFinal","error","setError","recognition","SpeechRecognition","speechRecognition","event","currentResult","useEffect","start","stop","value"],"mappings":";AA8CO,MAAMA,IAAuB,MAClC,QAAQ,qBAAqB,QAAQ,yBAwB1BC,IAAuB,CAClCC,IAAuC,OACR;AAC/B,QAAMC,IAAY,OAAO,SAAW,OAAe,CAAC,CAACH,EAAA,GAE/C;AAAA,IACJ,YAAAI,IAAa;AAAA,IACb,gBAAAC,IAAiB;AAAA,IACjB,UAAAC,IAAW;AAAA,IACX,UAAAC;AAAA,IACA,iBAAAC,IAAkB;AAAA,IAClB,SAAAC;AAAA,IACA,OAAAC;AAAA,IACA,SAAAC;AAAA,IACA,UAAAC;AAAA,EAAA,IACEV,GAEE,CAACW,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1C,CAACC,GAAYC,CAAa,IAAIF,EAAS,EAAE,GACzC,CAACG,GAAOC,CAAQ,IAAIJ,EAAS,EAAK,GAClC,CAACK,GAAOC,CAAQ,IAAIN,EAA6C,IAAI,GACrE,CAACO,CAAW,IAAIP,EAAwC,MAAM;AAClE,QAAI,CAACZ,EAAW;AAEhB,UAAMoB,IAAoBvB,EAAA,GACpBwB,IAAoB,IAAID,EAAA;AAE9B,WAAAC,EAAkB,aAAapB,GAC3BG,QAA4B,WAAWA,IAC3CiB,EAAkB,iBAAiBnB,GACnCmB,EAAkB,OAAOlB,GACzBkB,EAAkB,kBAAkBhB,GAEpCgB,EAAkB,UAAU,MAAM;AAChC,MAAAV,EAAa,EAAI,GACjBK,EAAS,EAAK,GACdV,IAAA;AAAA,IAAU,GAEZe,EAAkB,UAAU,CAACC,MAAU;AACrC,MAAAJ,EAASI,CAAK,GACdX,EAAa,EAAK,GAClBH,IAAUc,CAAK;AAAA,IAAA,GAEjBD,EAAkB,WAAW,CAACC,MAAU;AACtC,YAAMC,IAAgBD,EAAM,QAAQA,EAAM,WAAW,GAC/C,EAAE,YAAAT,MAAeU,EAAc,CAAC;AAEtC,MAAAZ,EAAa,EAAK,GAClBG,EAAcD,CAAU,GACxBK,EAAS,IAAI,GACbT,IAAWa,CAAK;AAAA,IAAA,GAElBD,EAAkB,QAAQ,MAAM;AAC9B,MAAAV,EAAa,EAAK,GAClBJ,IAAA,GACAc,EAAkB,OAAOlB;AAAA,IAAA,GAGpBkB;AAAA,EAAA,CACR;AAED,EAAAG,EAAU,MAAM,MAAML,GAAa,KAAA,GAAQ,CAAA,CAAE;AAE7C,QAAMM,IAAQ,MAAMN,GAAa,MAAA,GAC3BO,IAAO,MAAMP,GAAa,KAAA;AAOhC,SAAO;AAAA,IACL,WAAAnB;AAAA,IACA,YAAAa;AAAA,IACA,aAAAM;AAAA,IACA,OAAAJ;AAAA,IACA,WAAAL;AAAA,IACA,OAAAO;AAAA,IACA,OAAAQ;AAAA,IACA,MAAAC;AAAA,IACA,QAda,CAACC,IAAQ,CAACjB,MACnBiB,IAAcF,EAAA,IACXC,EAAA;AAAA,EAYP;AAEJ;"}
+{"version":3,"file":"useSpeechRecognition.mjs","names":[],"sources":["../../../../src/hooks/useSpeechRecognition/useSpeechRecognition.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech recognition hook options type */\ninterface UseSpeechRecognitionOptions {\n  /** If true, recognition continues even after pauses in speech. Default is false */\n  continuous?: SpeechRecognition['continuous'];\n  /** A list of grammar rules */\n  grammars?: SpeechRecognition['grammars'];\n  /** If true, interim (non-final) results are provided as the user speaks */\n  interimResults?: SpeechRecognition['interimResults'];\n  /** The language in which recognition should occur. Must be a valid BCP 47 language tag (e.g., \"en-US\", \"ru-RU\") */\n  language?: SpeechRecognition['lang'];\n  /** The maximum number of alternative transcripts returned for a given recognition result. Must be a positive integer */\n  maxAlternatives?: SpeechRecognition['maxAlternatives'];\n  /** Callback invoked when speech recognition ends */\n  onEnd?: () => void;\n  /** Callback invoked when an error occurs during recognition */\n  onError?: (error: SpeechRecognitionErrorEvent) => void;\n  /** Callback invoked when recognition produces a result */\n  onResult?: (event: SpeechRecognitionEvent) => void;\n  /** Callback invoked when speech recognition starts */\n  onStart?: () => void;\n}\n\n/** The return type of the useSpeechRecognition hook. */\ninterface UseSpeechRecognitionReturn {\n  /** The error state */\n  error: SpeechRecognitionErrorEvent | null;\n  /** The final transcript */\n  final: boolean;\n  /** Whether the hook is currently listening for speech */\n  listening: boolean;\n  /** The speech recognition instance */\n  recognition?: SpeechRecognition;\n  /** Whether the current browser supports the Web Speech API */\n  supported: boolean;\n  /** The current transcript */\n  transcript: string;\n  /** Begins speech recognition */\n  start: () => void;\n  /** Ends speech recognition, finalizing results */\n  stop: () => void;\n  /** Toggles the listening state */\n  toggle: (value?: boolean) => void;\n}\n\nexport const getSpeechRecognition = () =>\n  window?.SpeechRecognition ?? window?.webkitSpeechRecognition;\n\n/**\n * @name useSpeechRecognition\n * @description - Hook that provides a streamlined interface for incorporating speech-to-text functionality\n * @category Browser\n * @usage low\n *\n * @browserapi window.SpeechRecognition https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition\n *\n * @param {boolean} [options.continuous=false] Whether recognition should continue after pauses\n * @param {boolean} [options.interimResults=false] Whether interim results should be provided\n * @param {string} [options.language=\"en-US\"] The language for recognition, as a valid BCP 47 tag\n * @param {number} [options.maxAlternatives=1] The maximum number of alternative transcripts to return\n * @param {SpeechGrammarList} [options.grammars] A list of grammar rules\n * @param {() => void} [options.onStart] Callback invoked when speech recognition starts\n * @param {() => void} [options.onEnd] Callback invoked when speech recognition ends\n * @param {(error: SpeechRecognitionErrorEvent) => void} [options.onError] Callback invoked when an error occurs during recognition\n * @param {(event: SpeechRecognitionEvent) => void} [options.onResult] Callback invoked when recognition produces a result\n * @returns {UseSpeechRecognitionReturn} An object containing the speech recognition functionality\n *\n * @example\n * const { supported, value, recognition, listening, error, start, stop, toggle  } = useSpeechRecognition();\n */\nexport const useSpeechRecognition = (\n  options: UseSpeechRecognitionOptions = {}\n): UseSpeechRecognitionReturn => {\n  const supported = typeof window !== 'undefined' && !!getSpeechRecognition();\n\n  const {\n    continuous = false,\n    interimResults = false,\n    language = 'en-US',\n    grammars,\n    maxAlternatives = 1,\n    onStart,\n    onEnd,\n    onError,\n    onResult\n  } = options;\n\n  const [listening, setListening] = useState(false);\n  const [transcript, setTranscript] = useState('');\n  const [final, setFinal] = useState(false);\n  const [error, setError] = useState<SpeechRecognitionErrorEvent | null>(null);\n  const [recognition] = useState<SpeechRecognition | undefined>(() => {\n    if (!supported) return undefined;\n\n    const SpeechRecognition = getSpeechRecognition();\n    const speechRecognition = new SpeechRecognition();\n\n    speechRecognition.continuous = continuous;\n    if (grammars) speechRecognition.grammars = grammars;\n    speechRecognition.interimResults = interimResults;\n    speechRecognition.lang = language;\n    speechRecognition.maxAlternatives = maxAlternatives;\n\n    speechRecognition.onstart = () => {\n      setListening(true);\n      setFinal(false);\n      onStart?.();\n    };\n    speechRecognition.onerror = (event) => {\n      setError(event);\n      setListening(false);\n      onError?.(event);\n    };\n    speechRecognition.onresult = (event) => {\n      const currentResult = event.results[event.resultIndex];\n      const { transcript } = currentResult[0];\n\n      setListening(false);\n      setTranscript(transcript);\n      setError(null);\n      onResult?.(event);\n    };\n    speechRecognition.onend = () => {\n      setListening(false);\n      onEnd?.();\n      speechRecognition.lang = language;\n    };\n\n    return speechRecognition;\n  });\n\n  useEffect(() => () => recognition?.stop(), []);\n\n  const start = () => recognition?.start();\n  const stop = () => recognition?.stop();\n\n  const toggle = (value = !listening) => {\n    if (value) return start();\n    return stop();\n  };\n\n  return {\n    supported,\n    transcript,\n    recognition,\n    final,\n    listening,\n    error,\n    start,\n    stop,\n    toggle\n  };\n};\n"],"mappings":";;AA8CA,IAAa,UACX,QAAQ,qBAAqB,QAAQ,yBAwB1B,KACX,IAAuC,EAAE,KACV;CAC/B,IAAM,IAAY,OAAO,SAAW,OAAe,CAAC,CAAC,GAAsB,EAErE,EACJ,gBAAa,IACb,oBAAiB,IACjB,cAAW,SACX,aACA,qBAAkB,GAClB,YACA,UACA,YACA,gBACE,GAEE,CAAC,GAAW,KAAgB,EAAS,GAAM,EAC3C,CAAC,GAAY,KAAiB,EAAS,GAAG,EAC1C,CAAC,GAAO,KAAY,EAAS,GAAM,EACnC,CAAC,GAAO,KAAY,EAA6C,KAAK,EACtE,CAAC,KAAe,QAA8C;AAClE,MAAI,CAAC,EAAW;EAGhB,IAAM,IAAoB,KADA,GAAsB,GACC;AAiCjD,SA/BA,EAAkB,aAAa,GAC3B,MAAU,EAAkB,WAAW,IAC3C,EAAkB,iBAAiB,GACnC,EAAkB,OAAO,GACzB,EAAkB,kBAAkB,GAEpC,EAAkB,gBAAgB;AAGhC,GAFA,EAAa,GAAK,EAClB,EAAS,GAAM,EACf,KAAW;KAEb,EAAkB,WAAW,MAAU;AAGrC,GAFA,EAAS,EAAM,EACf,EAAa,GAAM,EACnB,IAAU,EAAM;KAElB,EAAkB,YAAY,MAAU;GAEtC,IAAM,EAAE,kBADc,EAAM,QAAQ,EAAM,aACL;AAKrC,GAHA,EAAa,GAAM,EACnB,EAAc,EAAW,EACzB,EAAS,KAAK,EACd,IAAW,EAAM;KAEnB,EAAkB,cAAc;AAG9B,GAFA,EAAa,GAAM,EACnB,KAAS,EACT,EAAkB,OAAO;KAGpB;GACP;AAEF,eAAsB,GAAa,MAAM,EAAE,EAAE,CAAC;CAE9C,IAAM,UAAc,GAAa,OAAO,EAClC,UAAa,GAAa,MAAM;AAOtC,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAdc,IAAQ,CAAC,MACnB,IAAc,GAAO,GAClB,GAAM;EAad"}

package/dist/esm/hooks/useSpeechSynthesis/useSpeechSynthesis.mjs

@@ -1,65 +1,66 @@
-import { useState as r, useEffect as v } from "react";
-const R = (S = {}) => {
-  const t = typeof window < "u" && "speechSynthesis" in window && !!window.speechSynthesis, { text: u = "", lang: a = "en-US", pitch: p = 1, rate: l = 1, voice: n = null, volume: w = 1 } = S, [f, s] = r(!1), [y, o] = r("init"), [m, g] = r(), [c, d] = r(), h = (e) => {
-    e.lang = a, e.pitch = p, e.rate = l, e.volume = w, e.voice = n, e.onstart = () => {
-      s(!0), o("play");
-    }, e.onpause = () => {
-      s(!1), o("pause");
-    }, e.onresume = () => {
-      s(!0), o("play");
-    }, e.onend = () => {
-      s(!1), o("end");
-    }, e.onerror = (i) => {
-      s(!1), g(i);
-    };
-  };
-  return v(() => {
-    if (!t) return;
-    const e = new SpeechSynthesisUtterance(u);
-    return h(e), d(e), () => {
-      window.speechSynthesis?.cancel();
-    };
-  }, [
-    u,
-    a,
-    p,
-    l,
-    w,
-    n?.default,
-    n?.lang,
-    n?.localService,
-    n?.name,
-    n?.voiceURI
-  ]), {
-    supported: t,
-    playing: f,
-    status: y,
-    utterance: c,
-    error: m,
-    stop: () => {
-      t && (window.speechSynthesis?.cancel(), s(!1));
-    },
-    toggle: (e = !f) => {
-      t && (e ? window.speechSynthesis?.resume() : window.speechSynthesis?.pause(), s(e));
-    },
-    speak: (e) => {
-      if (t) {
-        if (e) {
-          const i = new SpeechSynthesisUtterance(e);
-          d(i), h(i);
-        }
-        window.speechSynthesis?.cancel(), c && window.speechSynthesis?.speak(c), s(!0);
-      }
-    },
-    resume: () => {
-      s(!0), window.speechSynthesis?.resume();
-    },
-    pause: () => {
-      s(!1), window.speechSynthesis?.pause();
-    }
-  };
+import { useEffect as e, useState as t } from "react";
+//#region src/hooks/useSpeechSynthesis/useSpeechSynthesis.ts
+var n = (n = {}) => {
+	let r = typeof window < "u" && "speechSynthesis" in window && !!window.speechSynthesis, { text: i = "", lang: a = "en-US", pitch: o = 1, rate: s = 1, voice: c = null, volume: l = 1 } = n, [u, d] = t(!1), [f, p] = t("init"), [m, h] = t(), [g, _] = t(), v = (e) => {
+		e.lang = a, e.pitch = o, e.rate = s, e.volume = l, e.voice = c, e.onstart = () => {
+			d(!0), p("play");
+		}, e.onpause = () => {
+			d(!1), p("pause");
+		}, e.onresume = () => {
+			d(!0), p("play");
+		}, e.onend = () => {
+			d(!1), p("end");
+		}, e.onerror = (e) => {
+			d(!1), h(e);
+		};
+	};
+	return e(() => {
+		if (!r) return;
+		let e = new SpeechSynthesisUtterance(i);
+		return v(e), _(e), () => {
+			window.speechSynthesis?.cancel();
+		};
+	}, [
+		i,
+		a,
+		o,
+		s,
+		l,
+		c?.default,
+		c?.lang,
+		c?.localService,
+		c?.name,
+		c?.voiceURI
+	]), {
+		supported: r,
+		playing: u,
+		status: f,
+		utterance: g,
+		error: m,
+		stop: () => {
+			r && (window.speechSynthesis?.cancel(), d(!1));
+		},
+		toggle: (e = !u) => {
+			r && (e ? window.speechSynthesis?.resume() : window.speechSynthesis?.pause(), d(e));
+		},
+		speak: (e) => {
+			if (r) {
+				if (e) {
+					let t = new SpeechSynthesisUtterance(e);
+					_(t), v(t);
+				}
+				window.speechSynthesis?.cancel(), g && window.speechSynthesis?.speak(g), d(!0);
+			}
+		},
+		resume: () => {
+			d(!0), window.speechSynthesis?.resume();
+		},
+		pause: () => {
+			d(!1), window.speechSynthesis?.pause();
+		}
+	};
 };
-export {
-  R as useSpeechSynthesis
-};
-//# sourceMappingURL=useSpeechSynthesis.mjs.map
+//#endregion
+export { n as useSpeechSynthesis };
+
+//# sourceMappingURL=useSpeechSynthesis.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSpeechSynthesis.mjs","sources":["../../../../src/hooks/useSpeechSynthesis/useSpeechSynthesis.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech synthesis status type */\nexport type UseSpeechSynthesisStatus = 'end' | 'init' | 'pause' | 'play';\n\n/** The use speech synthesis options type */\nexport interface UseSpeechSynthesisOptions {\n  /** Language for SpeechSynthesis */\n  lang?: string;\n  /** Gets and sets the pitch at which the utterance will be spoken at. */\n  pitch?: number;\n  /** Gets and sets the speed at which the utterance will be spoken at. */\n  rate?: number;\n  /** The text to be spoken */\n  text?: string;\n  /** Gets and sets the voice that will be used to speak the utterance. */\n  voice?: SpeechSynthesisVoice | null;\n  /** Gets and sets the volume that the utterance will be spoken at. */\n  volume?: number;\n}\n\n/** The use speech synthesis return type */\nexport interface UseSpeechSynthesisReturn {\n  /** Any error that occurred during speech synthesis. */\n  error: SpeechSynthesisErrorEvent | undefined;\n  /** Indicates if speech is currently playing. */\n  playing: boolean;\n  /** The current status of speech synthesis. */\n  status: UseSpeechSynthesisStatus;\n  /** Indicates if the SpeechSynthesis API is supported in the current environment. */\n  supported: boolean;\n  /** The SpeechSynthesisUtterance instance. */\n  utterance: SpeechSynthesisUtterance | undefined;\n  /** Function to pause speech synthesis. */\n  pause: () => void;\n  /** Function to resume speech synthesis. */\n  resume: () => void;\n  /** Function to start speech synthesis. */\n  speak: () => void;\n  /** Function to stop speech synthesis. */\n  stop: () => void;\n  /** Function to toggle between play and pause. */\n  toggle: (value?: boolean) => void;\n}\n\n/**\n * @name useSpeechSynthesis\n * @description - Hook that provides speech synthesis functionality\n * @category Browser\n * @usage low\n *\n * @browserapi SpeechSynthesis https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis\n *\n * @params {string} [options.text] - The text to be spoken\n * @params {string} [options.lang] - The language to be spoken\n * @params {number} [options.pitch] - The pitch to be spoken\n * @params {number} [options.rate] - The rate to be spoken\n * @params {SpeechSynthesisVoice} [options.voice] - The voice to be spoken\n * @params {number} [options.volume] - The volume to be spoken\n * @returns {UseSpeechSynthesisReturn} An object containing the speech synthesis state and control methods\n *\n * @example\n * const { supported, playing, status, utterance, error, stop, toggle, speak, resume, pause } = useSpeechSynthesis();\n */\nexport const useSpeechSynthesis = (\n  options: UseSpeechSynthesisOptions = {}\n): UseSpeechSynthesisReturn => {\n  const supported =\n    typeof window !== 'undefined' && 'speechSynthesis' in window && !!window.speechSynthesis;\n\n  const { text = '', lang = 'en-US', pitch = 1, rate = 1, voice = null, volume = 1 } = options;\n\n  const [playing, setPlaying] = useState(false);\n  const [status, setStatus] = useState<UseSpeechSynthesisStatus>('init');\n  const [error, setError] = useState<SpeechSynthesisErrorEvent>();\n\n  const [utterance, setUtterance] = useState<SpeechSynthesisUtterance>();\n\n  const bindSpeechSynthesisUtterance = (speechSynthesisUtterance: SpeechSynthesisUtterance) => {\n    speechSynthesisUtterance.lang = lang;\n    speechSynthesisUtterance.pitch = pitch;\n    speechSynthesisUtterance.rate = rate;\n    speechSynthesisUtterance.volume = volume;\n    speechSynthesisUtterance.voice = voice;\n\n    speechSynthesisUtterance.onstart = () => {\n      setPlaying(true);\n      setStatus('play');\n    };\n\n    speechSynthesisUtterance.onpause = () => {\n      setPlaying(false);\n      setStatus('pause');\n    };\n\n    speechSynthesisUtterance.onresume = () => {\n      setPlaying(true);\n      setStatus('play');\n    };\n\n    speechSynthesisUtterance.onend = () => {\n      setPlaying(false);\n      setStatus('end');\n    };\n\n    speechSynthesisUtterance.onerror = (event) => {\n      setPlaying(false);\n      setError(event);\n    };\n  };\n\n  useEffect(() => {\n    if (!supported) return;\n\n    const speechSynthesisUtterance = new SpeechSynthesisUtterance(text);\n\n    bindSpeechSynthesisUtterance(speechSynthesisUtterance);\n    setUtterance(speechSynthesisUtterance);\n\n    return () => {\n      window.speechSynthesis?.cancel();\n    };\n  }, [\n    text,\n    lang,\n    pitch,\n    rate,\n    volume,\n    voice?.default,\n    voice?.lang,\n    voice?.localService,\n    voice?.name,\n    voice?.voiceURI\n  ]);\n\n  const speak = (text?: string) => {\n    if (!supported) return;\n\n    if (text) {\n      const utterance = new SpeechSynthesisUtterance(text);\n      setUtterance(utterance);\n      bindSpeechSynthesisUtterance(utterance);\n    }\n\n    window.speechSynthesis?.cancel();\n    if (utterance) window.speechSynthesis?.speak(utterance);\n    setPlaying(true);\n  };\n\n  const stop = () => {\n    if (!supported) return;\n\n    window.speechSynthesis?.cancel();\n    setPlaying(false);\n  };\n\n  const toggle = (value = !playing) => {\n    if (!supported) return;\n\n    if (value) {\n      window.speechSynthesis?.resume();\n    } else {\n      window.speechSynthesis?.pause();\n    }\n    setPlaying(value);\n  };\n\n  const resume = () => {\n    setPlaying(true);\n    window.speechSynthesis?.resume();\n  };\n\n  const pause = () => {\n    setPlaying(false);\n    window.speechSynthesis?.pause();\n  };\n\n  return {\n    supported,\n    playing,\n    status,\n    utterance,\n    error,\n    stop,\n    toggle,\n    speak,\n    resume,\n    pause\n  };\n};\n"],"names":["useSpeechSynthesis","options","supported","text","lang","pitch","rate","voice","volume","playing","setPlaying","useState","status","setStatus","error","setError","utterance","setUtterance","bindSpeechSynthesisUtterance","speechSynthesisUtterance","event","useEffect","value"],"mappings":";AAgEO,MAAMA,IAAqB,CAChCC,IAAqC,OACR;AAC7B,QAAMC,IACJ,OAAO,SAAW,OAAe,qBAAqB,UAAU,CAAC,CAAC,OAAO,iBAErE,EAAE,MAAAC,IAAO,IAAI,MAAAC,IAAO,SAAS,OAAAC,IAAQ,GAAG,MAAAC,IAAO,GAAG,OAAAC,IAAQ,MAAM,QAAAC,IAAS,MAAMP,GAE/E,CAACQ,GAASC,CAAU,IAAIC,EAAS,EAAK,GACtC,CAACC,GAAQC,CAAS,IAAIF,EAAmC,MAAM,GAC/D,CAACG,GAAOC,CAAQ,IAAIJ,EAAA,GAEpB,CAACK,GAAWC,CAAY,IAAIN,EAAA,GAE5BO,IAA+B,CAACC,MAAuD;AAC3F,IAAAA,EAAyB,OAAOf,GAChCe,EAAyB,QAAQd,GACjCc,EAAyB,OAAOb,GAChCa,EAAyB,SAASX,GAClCW,EAAyB,QAAQZ,GAEjCY,EAAyB,UAAU,MAAM;AACvC,MAAAT,EAAW,EAAI,GACfG,EAAU,MAAM;AAAA,IAAA,GAGlBM,EAAyB,UAAU,MAAM;AACvC,MAAAT,EAAW,EAAK,GAChBG,EAAU,OAAO;AAAA,IAAA,GAGnBM,EAAyB,WAAW,MAAM;AACxC,MAAAT,EAAW,EAAI,GACfG,EAAU,MAAM;AAAA,IAAA,GAGlBM,EAAyB,QAAQ,MAAM;AACrC,MAAAT,EAAW,EAAK,GAChBG,EAAU,KAAK;AAAA,IAAA,GAGjBM,EAAyB,UAAU,CAACC,MAAU;AAC5C,MAAAV,EAAW,EAAK,GAChBK,EAASK,CAAK;AAAA,IAAA;AAAA,EAChB;AAGF,SAAAC,EAAU,MAAM;AACd,QAAI,CAACnB,EAAW;AAEhB,UAAMiB,IAA2B,IAAI,yBAAyBhB,CAAI;AAElE,WAAAe,EAA6BC,CAAwB,GACrDF,EAAaE,CAAwB,GAE9B,MAAM;AACX,aAAO,iBAAiB,OAAA;AAAA,IAAO;AAAA,EACjC,GACC;AAAA,IACDhB;AAAA,IACAC;AAAA,IACAC;AAAA,IACAC;AAAA,IACAE;AAAA,IACAD,GAAO;AAAA,IACPA,GAAO;AAAA,IACPA,GAAO;AAAA,IACPA,GAAO;AAAA,IACPA,GAAO;AAAA,EAAA,CACR,GA4CM;AAAA,IACL,WAAAL;AAAA,IACA,SAAAO;AAAA,IACA,QAAAG;AAAA,IACA,WAAAI;AAAA,IACA,OAAAF;AAAA,IACA,MAlCW,MAAM;AACjB,MAAKZ,MAEL,OAAO,iBAAiB,OAAA,GACxBQ,EAAW,EAAK;AAAA,IAAA;AAAA,IA+BhB,QA5Ba,CAACY,IAAQ,CAACb,MAAY;AACnC,MAAKP,MAEDoB,IACF,OAAO,iBAAiB,OAAA,IAExB,OAAO,iBAAiB,MAAA,GAE1BZ,EAAWY,CAAK;AAAA,IAAA;AAAA,IAqBhB,OAlDY,CAACnB,MAAkB;AAC/B,UAAKD,GAEL;AAAA,YAAIC,GAAM;AACR,gBAAMa,IAAY,IAAI,yBAAyBb,CAAI;AACnD,UAAAc,EAAaD,CAAS,GACtBE,EAA6BF,CAAS;AAAA,QAAA;AAGxC,eAAO,iBAAiB,OAAA,GACpBA,KAAW,OAAO,iBAAiB,MAAMA,CAAS,GACtDN,EAAW,EAAI;AAAA;AAAA,IAAA;AAAA,IAwCf,QAnBa,MAAM;AACnB,MAAAA,EAAW,EAAI,GACf,OAAO,iBAAiB,OAAA;AAAA,IAAO;AAAA,IAkB/B,OAfY,MAAM;AAClB,MAAAA,EAAW,EAAK,GAChB,OAAO,iBAAiB,MAAA;AAAA,IAAM;AAAA,EAa9B;AAEJ;"}
+{"version":3,"file":"useSpeechSynthesis.mjs","names":[],"sources":["../../../../src/hooks/useSpeechSynthesis/useSpeechSynthesis.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech synthesis status type */\nexport type UseSpeechSynthesisStatus = 'end' | 'init' | 'pause' | 'play';\n\n/** The use speech synthesis options type */\nexport interface UseSpeechSynthesisOptions {\n  /** Language for SpeechSynthesis */\n  lang?: string;\n  /** Gets and sets the pitch at which the utterance will be spoken at. */\n  pitch?: number;\n  /** Gets and sets the speed at which the utterance will be spoken at. */\n  rate?: number;\n  /** The text to be spoken */\n  text?: string;\n  /** Gets and sets the voice that will be used to speak the utterance. */\n  voice?: SpeechSynthesisVoice | null;\n  /** Gets and sets the volume that the utterance will be spoken at. */\n  volume?: number;\n}\n\n/** The use speech synthesis return type */\nexport interface UseSpeechSynthesisReturn {\n  /** Any error that occurred during speech synthesis. */\n  error: SpeechSynthesisErrorEvent | undefined;\n  /** Indicates if speech is currently playing. */\n  playing: boolean;\n  /** The current status of speech synthesis. */\n  status: UseSpeechSynthesisStatus;\n  /** Indicates if the SpeechSynthesis API is supported in the current environment. */\n  supported: boolean;\n  /** The SpeechSynthesisUtterance instance. */\n  utterance: SpeechSynthesisUtterance | undefined;\n  /** Function to pause speech synthesis. */\n  pause: () => void;\n  /** Function to resume speech synthesis. */\n  resume: () => void;\n  /** Function to start speech synthesis. */\n  speak: () => void;\n  /** Function to stop speech synthesis. */\n  stop: () => void;\n  /** Function to toggle between play and pause. */\n  toggle: (value?: boolean) => void;\n}\n\n/**\n * @name useSpeechSynthesis\n * @description - Hook that provides speech synthesis functionality\n * @category Browser\n * @usage low\n *\n * @browserapi SpeechSynthesis https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis\n *\n * @params {string} [options.text] - The text to be spoken\n * @params {string} [options.lang] - The language to be spoken\n * @params {number} [options.pitch] - The pitch to be spoken\n * @params {number} [options.rate] - The rate to be spoken\n * @params {SpeechSynthesisVoice} [options.voice] - The voice to be spoken\n * @params {number} [options.volume] - The volume to be spoken\n * @returns {UseSpeechSynthesisReturn} An object containing the speech synthesis state and control methods\n *\n * @example\n * const { supported, playing, status, utterance, error, stop, toggle, speak, resume, pause } = useSpeechSynthesis();\n */\nexport const useSpeechSynthesis = (\n  options: UseSpeechSynthesisOptions = {}\n): UseSpeechSynthesisReturn => {\n  const supported =\n    typeof window !== 'undefined' && 'speechSynthesis' in window && !!window.speechSynthesis;\n\n  const { text = '', lang = 'en-US', pitch = 1, rate = 1, voice = null, volume = 1 } = options;\n\n  const [playing, setPlaying] = useState(false);\n  const [status, setStatus] = useState<UseSpeechSynthesisStatus>('init');\n  const [error, setError] = useState<SpeechSynthesisErrorEvent>();\n\n  const [utterance, setUtterance] = useState<SpeechSynthesisUtterance>();\n\n  const bindSpeechSynthesisUtterance = (speechSynthesisUtterance: SpeechSynthesisUtterance) => {\n    speechSynthesisUtterance.lang = lang;\n    speechSynthesisUtterance.pitch = pitch;\n    speechSynthesisUtterance.rate = rate;\n    speechSynthesisUtterance.volume = volume;\n    speechSynthesisUtterance.voice = voice;\n\n    speechSynthesisUtterance.onstart = () => {\n      setPlaying(true);\n      setStatus('play');\n    };\n\n    speechSynthesisUtterance.onpause = () => {\n      setPlaying(false);\n      setStatus('pause');\n    };\n\n    speechSynthesisUtterance.onresume = () => {\n      setPlaying(true);\n      setStatus('play');\n    };\n\n    speechSynthesisUtterance.onend = () => {\n      setPlaying(false);\n      setStatus('end');\n    };\n\n    speechSynthesisUtterance.onerror = (event) => {\n      setPlaying(false);\n      setError(event);\n    };\n  };\n\n  useEffect(() => {\n    if (!supported) return;\n\n    const speechSynthesisUtterance = new SpeechSynthesisUtterance(text);\n\n    bindSpeechSynthesisUtterance(speechSynthesisUtterance);\n    setUtterance(speechSynthesisUtterance);\n\n    return () => {\n      window.speechSynthesis?.cancel();\n    };\n  }, [\n    text,\n    lang,\n    pitch,\n    rate,\n    volume,\n    voice?.default,\n    voice?.lang,\n    voice?.localService,\n    voice?.name,\n    voice?.voiceURI\n  ]);\n\n  const speak = (text?: string) => {\n    if (!supported) return;\n\n    if (text) {\n      const utterance = new SpeechSynthesisUtterance(text);\n      setUtterance(utterance);\n      bindSpeechSynthesisUtterance(utterance);\n    }\n\n    window.speechSynthesis?.cancel();\n    if (utterance) window.speechSynthesis?.speak(utterance);\n    setPlaying(true);\n  };\n\n  const stop = () => {\n    if (!supported) return;\n\n    window.speechSynthesis?.cancel();\n    setPlaying(false);\n  };\n\n  const toggle = (value = !playing) => {\n    if (!supported) return;\n\n    if (value) {\n      window.speechSynthesis?.resume();\n    } else {\n      window.speechSynthesis?.pause();\n    }\n    setPlaying(value);\n  };\n\n  const resume = () => {\n    setPlaying(true);\n    window.speechSynthesis?.resume();\n  };\n\n  const pause = () => {\n    setPlaying(false);\n    window.speechSynthesis?.pause();\n  };\n\n  return {\n    supported,\n    playing,\n    status,\n    utterance,\n    error,\n    stop,\n    toggle,\n    speak,\n    resume,\n    pause\n  };\n};\n"],"mappings":";;AAgEA,IAAa,KACX,IAAqC,EAAE,KACV;CAC7B,IAAM,IACJ,OAAO,SAAW,OAAe,qBAAqB,UAAU,CAAC,CAAC,OAAO,iBAErE,EAAE,UAAO,IAAI,UAAO,SAAS,WAAQ,GAAG,UAAO,GAAG,WAAQ,MAAM,YAAS,MAAM,GAE/E,CAAC,GAAS,KAAc,EAAS,GAAM,EACvC,CAAC,GAAQ,KAAa,EAAmC,OAAO,EAChE,CAAC,GAAO,KAAY,GAAqC,EAEzD,CAAC,GAAW,KAAgB,GAAoC,EAEhE,KAAgC,MAAuD;AA2B3F,EA1BA,EAAyB,OAAO,GAChC,EAAyB,QAAQ,GACjC,EAAyB,OAAO,GAChC,EAAyB,SAAS,GAClC,EAAyB,QAAQ,GAEjC,EAAyB,gBAAgB;AAEvC,GADA,EAAW,GAAK,EAChB,EAAU,OAAO;KAGnB,EAAyB,gBAAgB;AAEvC,GADA,EAAW,GAAM,EACjB,EAAU,QAAQ;KAGpB,EAAyB,iBAAiB;AAExC,GADA,EAAW,GAAK,EAChB,EAAU,OAAO;KAGnB,EAAyB,cAAc;AAErC,GADA,EAAW,GAAM,EACjB,EAAU,MAAM;KAGlB,EAAyB,WAAW,MAAU;AAE5C,GADA,EAAW,GAAM,EACjB,EAAS,EAAM;;;AAsEnB,QAlEA,QAAgB;AACd,MAAI,CAAC,EAAW;EAEhB,IAAM,IAA2B,IAAI,yBAAyB,EAAK;AAKnE,SAHA,EAA6B,EAAyB,EACtD,EAAa,EAAyB,QAEzB;AACX,UAAO,iBAAiB,QAAQ;;IAEjC;EACD;EACA;EACA;EACA;EACA;EACA,GAAO;EACP,GAAO;EACP,GAAO;EACP,GAAO;EACP,GAAO;EACR,CAAC,EA4CK;EACL;EACA;EACA;EACA;EACA;EACA,YAlCiB;AACZ,SAEL,OAAO,iBAAiB,QAAQ,EAChC,EAAW,GAAM;;EA+BjB,SA5Bc,IAAQ,CAAC,MAAY;AAC9B,SAED,IACF,OAAO,iBAAiB,QAAQ,GAEhC,OAAO,iBAAiB,OAAO,EAEjC,EAAW,EAAM;;EAqBjB,QAlDa,MAAkB;AAC1B,UAEL;QAAI,GAAM;KACR,IAAM,IAAY,IAAI,yBAAyB,EAAK;AAEpD,KADA,EAAa,EAAU,EACvB,EAA6B,EAAU;;AAKzC,IAFA,OAAO,iBAAiB,QAAQ,EAC5B,KAAW,OAAO,iBAAiB,MAAM,EAAU,EACvD,EAAW,GAAK;;;EAwChB,cAnBmB;AAEnB,GADA,EAAW,GAAK,EAChB,OAAO,iBAAiB,QAAQ;;EAkBhC,aAfkB;AAElB,GADA,EAAW,GAAM,EACjB,OAAO,iBAAiB,OAAO;;EAchC"}

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

@@ -1,85 +1,97 @@
-import { useReducer as p } from "react";
-const k = (n, c) => {
-  switch (c.type) {
-    case "SET": {
-      const { value: r, capacity: o } = c.payload, e = [...n.history.slice(0, n.currentIndex + 1), r];
-      e.length > o && e.shift();
-      const t = [n.history, ...n.undoStack];
-      return t.length > o && t.pop(), {
-        history: e,
-        currentIndex: e.length - 1,
-        undoStack: t,
-        redoStack: []
-      };
-    }
-    case "UNDO":
-      return n.undoStack.length === 0 ? n : {
-        history: n.undoStack[0],
-        currentIndex: n.undoStack[0].length - 1,
-        undoStack: n.undoStack.slice(1),
-        redoStack: [n.history, ...n.redoStack]
-      };
-    case "REDO":
-      return n.redoStack.length === 0 ? n : {
-        history: n.redoStack[0],
-        currentIndex: n.redoStack[0].length - 1,
-        undoStack: [n.history, ...n.undoStack],
-        redoStack: n.redoStack.slice(1)
-      };
-    case "BACK": {
-      const { steps: r } = c.payload;
-      return {
-        ...n,
-        currentIndex: Math.max(0, n.currentIndex - r)
-      };
-    }
-    case "FORWARD": {
-      const { steps: r } = c.payload;
-      return {
-        ...n,
-        currentIndex: Math.min(n.currentIndex + r, n.history.length - 1)
-      };
-    }
-    case "RESET": {
-      const { initialValue: r, capacity: o } = c.payload;
-      if (n.history.length === 1) return n;
-      const e = [n.history, ...n.undoStack];
-      return e.length > o && e.pop(), {
-        history: [r],
-        currentIndex: 0,
-        undoStack: e,
-        redoStack: []
-      };
-    }
-    default:
-      throw new Error("Unsupported action type");
-  }
-}, x = (n, c = 10) => {
-  const [r, o] = p(k, {
-    history: [n],
-    currentIndex: 0,
-    undoStack: [],
-    redoStack: []
-  }), e = r.history[r.currentIndex], t = r.undoStack.length > 0, u = r.redoStack.length > 0, a = (d) => o({
-    type: "SET",
-    payload: { value: d, capacity: c }
-  }), y = () => o({ type: "UNDO" }), s = () => o({ type: "REDO" }), h = (d = 1) => o({ type: "BACK", payload: { steps: d } }), i = (d = 1) => o({ type: "FORWARD", payload: { steps: d } }), S = () => o({ type: "RESET", payload: { initialValue: n, capacity: c } });
-  return {
-    history: r.history,
-    value: e,
-    set: a,
-    index: r.currentIndex,
-    back: h,
-    forward: i,
-    reset: S,
-    undo: y,
-    redo: s,
-    canUndo: t,
-    canRedo: u
-  };
+import { useReducer as e } from "react";
+//#region src/hooks/useStateHistory/useStateHistory.ts
+var t = (e, t) => {
+	switch (t.type) {
+		case "SET": {
+			let { value: n, capacity: r } = t.payload, i = [...e.history.slice(0, e.currentIndex + 1), n];
+			i.length > r && i.shift();
+			let a = [e.history, ...e.undoStack];
+			return a.length > r && a.pop(), {
+				history: i,
+				currentIndex: i.length - 1,
+				undoStack: a,
+				redoStack: []
+			};
+		}
+		case "UNDO": return e.undoStack.length === 0 ? e : {
+			history: e.undoStack[0],
+			currentIndex: e.undoStack[0].length - 1,
+			undoStack: e.undoStack.slice(1),
+			redoStack: [e.history, ...e.redoStack]
+		};
+		case "REDO": return e.redoStack.length === 0 ? e : {
+			history: e.redoStack[0],
+			currentIndex: e.redoStack[0].length - 1,
+			undoStack: [e.history, ...e.undoStack],
+			redoStack: e.redoStack.slice(1)
+		};
+		case "BACK": {
+			let { steps: n } = t.payload;
+			return {
+				...e,
+				currentIndex: Math.max(0, e.currentIndex - n)
+			};
+		}
+		case "FORWARD": {
+			let { steps: n } = t.payload;
+			return {
+				...e,
+				currentIndex: Math.min(e.currentIndex + n, e.history.length - 1)
+			};
+		}
+		case "RESET": {
+			let { initialValue: n, capacity: r } = t.payload;
+			if (e.history.length === 1) return e;
+			let i = [e.history, ...e.undoStack];
+			return i.length > r && i.pop(), {
+				history: [n],
+				currentIndex: 0,
+				undoStack: i,
+				redoStack: []
+			};
+		}
+		default: throw Error("Unsupported action type");
+	}
+}, n = (n, r = 10) => {
+	let [i, a] = e(t, {
+		history: [n],
+		currentIndex: 0,
+		undoStack: [],
+		redoStack: []
+	}), o = i.history[i.currentIndex], s = i.undoStack.length > 0, c = i.redoStack.length > 0;
+	return {
+		history: i.history,
+		value: o,
+		set: (e) => a({
+			type: "SET",
+			payload: {
+				value: e,
+				capacity: r
+			}
+		}),
+		index: i.currentIndex,
+		back: (e = 1) => a({
+			type: "BACK",
+			payload: { steps: e }
+		}),
+		forward: (e = 1) => a({
+			type: "FORWARD",
+			payload: { steps: e }
+		}),
+		reset: () => a({
+			type: "RESET",
+			payload: {
+				initialValue: n,
+				capacity: r
+			}
+		}),
+		undo: () => a({ type: "UNDO" }),
+		redo: () => a({ type: "REDO" }),
+		canUndo: s,
+		canRedo: c
+	};
 };
-export {
-  k as stateHistoryReducer,
-  x as useStateHistory
-};
-//# sourceMappingURL=useStateHistory.mjs.map
+//#endregion
+export { t as stateHistoryReducer, n as useStateHistory };
+
+//# sourceMappingURL=useStateHistory.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useStateHistory.mjs","sources":["../../../../src/hooks/useStateHistory/useStateHistory.ts"],"sourcesContent":["import { useReducer } from 'react';\n\n/** The use state history hook return type */\ninterface UseStateHistoryReturn<Value> {\n  /** True if a redo operation can be performed */\n  canRedo: boolean;\n  /** True if an undo operation can be performed */\n  canUndo: boolean;\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  /** Redo the last change */\n  redo: () => 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\nexport type StateHistoryAction<Value> =\n  | { type: 'BACK'; payload: { steps: number } }\n  | { type: 'FORWARD'; payload: { steps: number } }\n  | { type: 'REDO' }\n  | { type: 'RESET'; payload: { initialValue: Value; capacity: number } }\n  | { type: 'SET'; payload: { value: Value; capacity: number } }\n  | { type: 'UNDO' };\n\nexport interface StateHistory<Value> {\n  currentIndex: number;\n  history: Value[];\n  redoStack: Value[][];\n  undoStack: Value[][];\n}\n\nexport const stateHistoryReducer = <Value>(\n  state: StateHistory<Value>,\n  action: StateHistoryAction<Value>\n): StateHistory<Value> => {\n  switch (action.type) {\n    case 'SET': {\n      const { value, capacity } = action.payload;\n\n      const newHistory = [...state.history.slice(0, state.currentIndex + 1), value];\n      if (newHistory.length > capacity) {\n        newHistory.shift();\n      }\n\n      const newUndoStack = [state.history, ...state.undoStack];\n      if (newUndoStack.length > capacity) {\n        newUndoStack.pop();\n      }\n\n      return {\n        history: newHistory,\n        currentIndex: newHistory.length - 1,\n        undoStack: newUndoStack,\n        redoStack: []\n      };\n    }\n\n    case 'UNDO': {\n      if (state.undoStack.length === 0) return state;\n\n      return {\n        history: state.undoStack[0],\n        currentIndex: state.undoStack[0].length - 1,\n        undoStack: state.undoStack.slice(1),\n        redoStack: [state.history, ...state.redoStack]\n      };\n    }\n\n    case 'REDO': {\n      if (state.redoStack.length === 0) return state;\n\n      return {\n        history: state.redoStack[0],\n        currentIndex: state.redoStack[0].length - 1,\n        undoStack: [state.history, ...state.undoStack],\n        redoStack: state.redoStack.slice(1)\n      };\n    }\n\n    case 'BACK': {\n      const { steps } = action.payload;\n      return {\n        ...state,\n        currentIndex: Math.max(0, state.currentIndex - steps)\n      };\n    }\n\n    case 'FORWARD': {\n      const { steps } = action.payload;\n      return {\n        ...state,\n        currentIndex: Math.min(state.currentIndex + steps, state.history.length - 1)\n      };\n    }\n\n    case 'RESET': {\n      const { initialValue, capacity } = action.payload;\n      if (state.history.length === 1) return state;\n\n      const newUndoStack = [state.history, ...state.undoStack];\n      if (newUndoStack.length > capacity) {\n        newUndoStack.pop();\n      }\n\n      return {\n        history: [initialValue],\n        currentIndex: 0,\n        undoStack: newUndoStack,\n        redoStack: []\n      };\n    }\n\n    default:\n      throw new Error('Unsupported action type');\n  }\n};\n\n/**\n * @name useStateHistory\n * @description - Hook that manages state with history functionality\n * @category State\n * @usage medium\n *\n * @param {Value} initialValue - The initial value to start the history with\n * @param {number} [capacity=10] - Maximum number of history entries and undo actions 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, redo, canUndo, canRedo } = useStateHistory(0);\n */\nexport const useStateHistory = <Value>(\n  initialValue: Value,\n  capacity = 10\n): UseStateHistoryReturn<Value> => {\n  const [state, dispatch] = useReducer(stateHistoryReducer<Value>, {\n    history: [initialValue],\n    currentIndex: 0,\n    undoStack: [],\n    redoStack: []\n  });\n\n  const value = state.history[state.currentIndex];\n  const canUndo = state.undoStack.length > 0;\n  const canRedo = state.redoStack.length > 0;\n\n  const set = (value: Value) =>\n    dispatch({\n      type: 'SET',\n      payload: { value, capacity }\n    });\n\n  const undo = () => dispatch({ type: 'UNDO' });\n\n  const redo = () => dispatch({ type: 'REDO' });\n\n  const back = (steps = 1) => dispatch({ type: 'BACK', payload: { steps } });\n\n  const forward = (steps = 1) => dispatch({ type: 'FORWARD', payload: { steps } });\n\n  const reset = () => dispatch({ type: 'RESET', payload: { initialValue, capacity } });\n\n  return {\n    history: state.history,\n    value,\n    set,\n    index: state.currentIndex,\n    back,\n    forward,\n    reset,\n    undo,\n    redo,\n    canUndo,\n    canRedo\n  };\n};\n"],"names":["stateHistoryReducer","state","action","value","capacity","newHistory","newUndoStack","steps","initialValue","useStateHistory","dispatch","useReducer","canUndo","canRedo","set","undo","redo","back","forward","reset"],"mappings":";AA2CO,MAAMA,IAAsB,CACjCC,GACAC,MACwB;AACxB,UAAQA,EAAO,MAAA;AAAA,IACb,KAAK,OAAO;AACV,YAAM,EAAE,OAAAC,GAAO,UAAAC,EAAA,IAAaF,EAAO,SAE7BG,IAAa,CAAC,GAAGJ,EAAM,QAAQ,MAAM,GAAGA,EAAM,eAAe,CAAC,GAAGE,CAAK;AAC5E,MAAIE,EAAW,SAASD,KACtBC,EAAW,MAAA;AAGb,YAAMC,IAAe,CAACL,EAAM,SAAS,GAAGA,EAAM,SAAS;AACvD,aAAIK,EAAa,SAASF,KACxBE,EAAa,IAAA,GAGR;AAAA,QACL,SAASD;AAAA,QACT,cAAcA,EAAW,SAAS;AAAA,QAClC,WAAWC;AAAA,QACX,WAAW,CAAA;AAAA,MAAC;AAAA,IACd;AAAA,IAGF,KAAK;AACH,aAAIL,EAAM,UAAU,WAAW,IAAUA,IAElC;AAAA,QACL,SAASA,EAAM,UAAU,CAAC;AAAA,QAC1B,cAAcA,EAAM,UAAU,CAAC,EAAE,SAAS;AAAA,QAC1C,WAAWA,EAAM,UAAU,MAAM,CAAC;AAAA,QAClC,WAAW,CAACA,EAAM,SAAS,GAAGA,EAAM,SAAS;AAAA,MAAA;AAAA,IAIjD,KAAK;AACH,aAAIA,EAAM,UAAU,WAAW,IAAUA,IAElC;AAAA,QACL,SAASA,EAAM,UAAU,CAAC;AAAA,QAC1B,cAAcA,EAAM,UAAU,CAAC,EAAE,SAAS;AAAA,QAC1C,WAAW,CAACA,EAAM,SAAS,GAAGA,EAAM,SAAS;AAAA,QAC7C,WAAWA,EAAM,UAAU,MAAM,CAAC;AAAA,MAAA;AAAA,IAItC,KAAK,QAAQ;AACX,YAAM,EAAE,OAAAM,MAAUL,EAAO;AACzB,aAAO;AAAA,QACL,GAAGD;AAAA,QACH,cAAc,KAAK,IAAI,GAAGA,EAAM,eAAeM,CAAK;AAAA,MAAA;AAAA,IACtD;AAAA,IAGF,KAAK,WAAW;AACd,YAAM,EAAE,OAAAA,MAAUL,EAAO;AACzB,aAAO;AAAA,QACL,GAAGD;AAAA,QACH,cAAc,KAAK,IAAIA,EAAM,eAAeM,GAAON,EAAM,QAAQ,SAAS,CAAC;AAAA,MAAA;AAAA,IAC7E;AAAA,IAGF,KAAK,SAAS;AACZ,YAAM,EAAE,cAAAO,GAAc,UAAAJ,EAAA,IAAaF,EAAO;AAC1C,UAAID,EAAM,QAAQ,WAAW,EAAG,QAAOA;AAEvC,YAAMK,IAAe,CAACL,EAAM,SAAS,GAAGA,EAAM,SAAS;AACvD,aAAIK,EAAa,SAASF,KACxBE,EAAa,IAAA,GAGR;AAAA,QACL,SAAS,CAACE,CAAY;AAAA,QACtB,cAAc;AAAA,QACd,WAAWF;AAAA,QACX,WAAW,CAAA;AAAA,MAAC;AAAA,IACd;AAAA,IAGF;AACE,YAAM,IAAI,MAAM,yBAAyB;AAAA,EAAA;AAE/C,GAeaG,IAAkB,CAC7BD,GACAJ,IAAW,OACsB;AACjC,QAAM,CAACH,GAAOS,CAAQ,IAAIC,EAAWX,GAA4B;AAAA,IAC/D,SAAS,CAACQ,CAAY;AAAA,IACtB,cAAc;AAAA,IACd,WAAW,CAAA;AAAA,IACX,WAAW,CAAA;AAAA,EAAC,CACb,GAEKL,IAAQF,EAAM,QAAQA,EAAM,YAAY,GACxCW,IAAUX,EAAM,UAAU,SAAS,GACnCY,IAAUZ,EAAM,UAAU,SAAS,GAEnCa,IAAM,CAACX,MACXO,EAAS;AAAA,IACP,MAAM;AAAA,IACN,SAAS,EAAE,OAAAP,GAAO,UAAAC,EAAA;AAAA,EAAS,CAC5B,GAEGW,IAAO,MAAML,EAAS,EAAE,MAAM,QAAQ,GAEtCM,IAAO,MAAMN,EAAS,EAAE,MAAM,QAAQ,GAEtCO,IAAO,CAACV,IAAQ,MAAMG,EAAS,EAAE,MAAM,QAAQ,SAAS,EAAE,OAAAH,EAAA,EAAM,CAAG,GAEnEW,IAAU,CAACX,IAAQ,MAAMG,EAAS,EAAE,MAAM,WAAW,SAAS,EAAE,OAAAH,EAAA,EAAM,CAAG,GAEzEY,IAAQ,MAAMT,EAAS,EAAE,MAAM,SAAS,SAAS,EAAE,cAAAF,GAAc,UAAAJ,EAAA,GAAY;AAEnF,SAAO;AAAA,IACL,SAASH,EAAM;AAAA,IACf,OAAAE;AAAA,IACA,KAAAW;AAAA,IACA,OAAOb,EAAM;AAAA,IACb,MAAAgB;AAAA,IACA,SAAAC;AAAA,IACA,OAAAC;AAAA,IACA,MAAAJ;AAAA,IACA,MAAAC;AAAA,IACA,SAAAJ;AAAA,IACA,SAAAC;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useStateHistory.mjs","names":[],"sources":["../../../../src/hooks/useStateHistory/useStateHistory.ts"],"sourcesContent":["import { useReducer } from 'react';\n\n/** The use state history hook return type */\ninterface UseStateHistoryReturn<Value> {\n  /** True if a redo operation can be performed */\n  canRedo: boolean;\n  /** True if an undo operation can be performed */\n  canUndo: boolean;\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  /** Redo the last change */\n  redo: () => 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\nexport type StateHistoryAction<Value> =\n  | { type: 'BACK'; payload: { steps: number } }\n  | { type: 'FORWARD'; payload: { steps: number } }\n  | { type: 'REDO' }\n  | { type: 'RESET'; payload: { initialValue: Value; capacity: number } }\n  | { type: 'SET'; payload: { value: Value; capacity: number } }\n  | { type: 'UNDO' };\n\nexport interface StateHistory<Value> {\n  currentIndex: number;\n  history: Value[];\n  redoStack: Value[][];\n  undoStack: Value[][];\n}\n\nexport const stateHistoryReducer = <Value>(\n  state: StateHistory<Value>,\n  action: StateHistoryAction<Value>\n): StateHistory<Value> => {\n  switch (action.type) {\n    case 'SET': {\n      const { value, capacity } = action.payload;\n\n      const newHistory = [...state.history.slice(0, state.currentIndex + 1), value];\n      if (newHistory.length > capacity) {\n        newHistory.shift();\n      }\n\n      const newUndoStack = [state.history, ...state.undoStack];\n      if (newUndoStack.length > capacity) {\n        newUndoStack.pop();\n      }\n\n      return {\n        history: newHistory,\n        currentIndex: newHistory.length - 1,\n        undoStack: newUndoStack,\n        redoStack: []\n      };\n    }\n\n    case 'UNDO': {\n      if (state.undoStack.length === 0) return state;\n\n      return {\n        history: state.undoStack[0],\n        currentIndex: state.undoStack[0].length - 1,\n        undoStack: state.undoStack.slice(1),\n        redoStack: [state.history, ...state.redoStack]\n      };\n    }\n\n    case 'REDO': {\n      if (state.redoStack.length === 0) return state;\n\n      return {\n        history: state.redoStack[0],\n        currentIndex: state.redoStack[0].length - 1,\n        undoStack: [state.history, ...state.undoStack],\n        redoStack: state.redoStack.slice(1)\n      };\n    }\n\n    case 'BACK': {\n      const { steps } = action.payload;\n      return {\n        ...state,\n        currentIndex: Math.max(0, state.currentIndex - steps)\n      };\n    }\n\n    case 'FORWARD': {\n      const { steps } = action.payload;\n      return {\n        ...state,\n        currentIndex: Math.min(state.currentIndex + steps, state.history.length - 1)\n      };\n    }\n\n    case 'RESET': {\n      const { initialValue, capacity } = action.payload;\n      if (state.history.length === 1) return state;\n\n      const newUndoStack = [state.history, ...state.undoStack];\n      if (newUndoStack.length > capacity) {\n        newUndoStack.pop();\n      }\n\n      return {\n        history: [initialValue],\n        currentIndex: 0,\n        undoStack: newUndoStack,\n        redoStack: []\n      };\n    }\n\n    default:\n      throw new Error('Unsupported action type');\n  }\n};\n\n/**\n * @name useStateHistory\n * @description - Hook that manages state with history functionality\n * @category State\n * @usage medium\n *\n * @param {Value} initialValue - The initial value to start the history with\n * @param {number} [capacity=10] - Maximum number of history entries and undo actions 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, redo, canUndo, canRedo } = useStateHistory(0);\n */\nexport const useStateHistory = <Value>(\n  initialValue: Value,\n  capacity = 10\n): UseStateHistoryReturn<Value> => {\n  const [state, dispatch] = useReducer(stateHistoryReducer<Value>, {\n    history: [initialValue],\n    currentIndex: 0,\n    undoStack: [],\n    redoStack: []\n  });\n\n  const value = state.history[state.currentIndex];\n  const canUndo = state.undoStack.length > 0;\n  const canRedo = state.redoStack.length > 0;\n\n  const set = (value: Value) =>\n    dispatch({\n      type: 'SET',\n      payload: { value, capacity }\n    });\n\n  const undo = () => dispatch({ type: 'UNDO' });\n\n  const redo = () => dispatch({ type: 'REDO' });\n\n  const back = (steps = 1) => dispatch({ type: 'BACK', payload: { steps } });\n\n  const forward = (steps = 1) => dispatch({ type: 'FORWARD', payload: { steps } });\n\n  const reset = () => dispatch({ type: 'RESET', payload: { initialValue, capacity } });\n\n  return {\n    history: state.history,\n    value,\n    set,\n    index: state.currentIndex,\n    back,\n    forward,\n    reset,\n    undo,\n    redo,\n    canUndo,\n    canRedo\n  };\n};\n"],"mappings":";;AA2CA,IAAa,KACX,GACA,MACwB;AACxB,SAAQ,EAAO,MAAf;EACE,KAAK,OAAO;GACV,IAAM,EAAE,UAAO,gBAAa,EAAO,SAE7B,IAAa,CAAC,GAAG,EAAM,QAAQ,MAAM,GAAG,EAAM,eAAe,EAAE,EAAE,EAAM;AAC7E,GAAI,EAAW,SAAS,KACtB,EAAW,OAAO;GAGpB,IAAM,IAAe,CAAC,EAAM,SAAS,GAAG,EAAM,UAAU;AAKxD,UAJI,EAAa,SAAS,KACxB,EAAa,KAAK,EAGb;IACL,SAAS;IACT,cAAc,EAAW,SAAS;IAClC,WAAW;IACX,WAAW,EAAE;IACd;;EAGH,KAAK,OAGH,QAFI,EAAM,UAAU,WAAW,IAAU,IAElC;GACL,SAAS,EAAM,UAAU;GACzB,cAAc,EAAM,UAAU,GAAG,SAAS;GAC1C,WAAW,EAAM,UAAU,MAAM,EAAE;GACnC,WAAW,CAAC,EAAM,SAAS,GAAG,EAAM,UAAU;GAC/C;EAGH,KAAK,OAGH,QAFI,EAAM,UAAU,WAAW,IAAU,IAElC;GACL,SAAS,EAAM,UAAU;GACzB,cAAc,EAAM,UAAU,GAAG,SAAS;GAC1C,WAAW,CAAC,EAAM,SAAS,GAAG,EAAM,UAAU;GAC9C,WAAW,EAAM,UAAU,MAAM,EAAE;GACpC;EAGH,KAAK,QAAQ;GACX,IAAM,EAAE,aAAU,EAAO;AACzB,UAAO;IACL,GAAG;IACH,cAAc,KAAK,IAAI,GAAG,EAAM,eAAe,EAAM;IACtD;;EAGH,KAAK,WAAW;GACd,IAAM,EAAE,aAAU,EAAO;AACzB,UAAO;IACL,GAAG;IACH,cAAc,KAAK,IAAI,EAAM,eAAe,GAAO,EAAM,QAAQ,SAAS,EAAE;IAC7E;;EAGH,KAAK,SAAS;GACZ,IAAM,EAAE,iBAAc,gBAAa,EAAO;AAC1C,OAAI,EAAM,QAAQ,WAAW,EAAG,QAAO;GAEvC,IAAM,IAAe,CAAC,EAAM,SAAS,GAAG,EAAM,UAAU;AAKxD,UAJI,EAAa,SAAS,KACxB,EAAa,KAAK,EAGb;IACL,SAAS,CAAC,EAAa;IACvB,cAAc;IACd,WAAW;IACX,WAAW,EAAE;IACd;;EAGH,QACE,OAAU,MAAM,0BAA0B;;GAiBnC,KACX,GACA,IAAW,OACsB;CACjC,IAAM,CAAC,GAAO,KAAY,EAAW,GAA4B;EAC/D,SAAS,CAAC,EAAa;EACvB,cAAc;EACd,WAAW,EAAE;EACb,WAAW,EAAE;EACd,CAAC,EAEI,IAAQ,EAAM,QAAQ,EAAM,eAC5B,IAAU,EAAM,UAAU,SAAS,GACnC,IAAU,EAAM,UAAU,SAAS;AAkBzC,QAAO;EACL,SAAS,EAAM;EACf;EACA,MAnBW,MACX,EAAS;GACP,MAAM;GACN,SAAS;IAAE;IAAO;IAAU;GAC7B,CAAC;EAgBF,OAAO,EAAM;EACb,OAXY,IAAQ,MAAM,EAAS;GAAE,MAAM;GAAQ,SAAS,EAAE,UAAO;GAAE,CAAC;EAYxE,UAVe,IAAQ,MAAM,EAAS;GAAE,MAAM;GAAW,SAAS,EAAE,UAAO;GAAE,CAAC;EAW9E,aATkB,EAAS;GAAE,MAAM;GAAS,SAAS;IAAE;IAAc;IAAU;GAAE,CAAC;EAUlF,YAlBiB,EAAS,EAAE,MAAM,QAAQ,CAAC;EAmB3C,YAjBiB,EAAS,EAAE,MAAM,QAAQ,CAAC;EAkB3C;EACA;EACD"}

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

@@ -1,29 +1,28 @@
-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);
-    }
-  };
+import { useRef as e, useState as t } from "react";
+//#region src/hooks/useStep/useStep.ts
+var n = 1, r = (r) => {
+	let i = typeof r == "object" ? r.max : r, a = typeof r == "object" ? r.initial : n, o = e(a > i || a < n ? n : a), [s, c] = t(a), l = s === n, u = s === i;
+	return {
+		counts: i,
+		currentStep: s,
+		isFirst: l,
+		isLast: u,
+		next: () => {
+			u || c((e) => e + 1);
+		},
+		back: () => {
+			l || c((e) => e - 1);
+		},
+		reset: () => c(o.current),
+		set: (e) => {
+			if (e === "first") return c(o.current);
+			if (e === "last" || e >= i) return c(i);
+			if (e <= n) return c(n);
+			c(e);
+		}
+	};
 };
-export {
-  E as useStep
-};
-//# sourceMappingURL=useStep.mjs.map
+//#endregion
+export { r as useStep };
+
+//# sourceMappingURL=useStep.mjs.map

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

@@ -1 +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 */\nexport interface 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 */\nexport interface 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 State\n * @usage medium\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,GAuBZC,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,EAAA,GAE7D,CAACG,GAAaC,CAAc,IAAIC,EAASL,CAAO,GAEhDM,IAAUH,MAAgBP,GAC1BW,IAASJ,MAAgBJ;AAsB/B,SAAO;AAAA,IACL,QAAQA;AAAA,IACR,aAAAI;AAAA,IACA,SAAAG;AAAA,IACA,QAAAC;AAAA,IACA,MAzBW,MAAM;AACjB,MAAIA,KACJH,EAAe,CAACI,MAAaA,IAAW,CAAC;AAAA,IAAA;AAAA,IAwBzC,MArBW,MAAM;AACjB,MAAIF,KACJF,EAAe,CAACI,MAAaA,IAAW,CAAC;AAAA,IAAA;AAAA,IAoBzC,OAjBY,MAAMJ,EAAeH,EAAY,OAAO;AAAA,IAkBpD,KAhBU,CAACQ,MAAqC;AAChD,UAAIA,MAAU,QAAS,QAAOL,EAAeH,EAAY,OAAO;AAEhE,UADIQ,MAAU,UACVA,KAASV,EAAK,QAAOK,EAAeL,CAAG;AAC3C,UAAIU,KAASb,EAAkB,QAAOQ,EAAeR,CAAgB;AACrE,MAAAQ,EAAeK,CAAK;AAAA,IAAA;AAAA,EAWpB;AAEJ;"}
+{"version":3,"file":"useStep.mjs","names":[],"sources":["../../../../src/hooks/useStep/useStep.ts"],"sourcesContent":["import { useRef, useState } from 'react';\n\n/** The use step params type */\nexport interface 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 */\nexport interface 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 State\n * @usage medium\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"],"mappings":";;AA8BA,IAAM,IAAmB,GAuBZ,KAAW,MAAkD;CACxE,IAAM,IAAM,OAAO,KAAW,WAAW,EAAO,MAAM,GAChD,IAAU,OAAO,KAAW,WAAW,EAAO,UAAU,GAExD,IAAc,EAClB,IAAU,KAAO,IAAU,IAAmB,IAAmB,EAClE,EACK,CAAC,GAAa,KAAkB,EAAS,EAAQ,EAEjD,IAAU,MAAgB,GAC1B,IAAS,MAAgB;AAsB/B,QAAO;EACL,QAAQ;EACR;EACA;EACA;EACA,YAzBiB;AACb,QACJ,GAAgB,MAAa,IAAW,EAAE;;EAwB1C,YArBiB;AACb,QACJ,GAAgB,MAAa,IAAW,EAAE;;EAoB1C,aAjBkB,EAAe,EAAY,QAAQ;EAkBrD,MAhBW,MAAqC;AAChD,OAAI,MAAU,QAAS,QAAO,EAAe,EAAY,QAAQ;AAEjE,OADI,MAAU,UACV,KAAS,EAAK,QAAO,EAAe,EAAI;AAC5C,OAAI,KAAS,EAAkB,QAAO,EAAe,EAAiB;AACtE,KAAe,EAAM;;EAYtB"}

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

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