@siberiacancode/reactuse 0.3.14 → 0.3.17

package/dist/esm/helpers/createStore/createStore.mjs

@@ -1,30 +1,26 @@
-import { useSyncExternalStore as p } from "react";
-const b = (o) => {
-  let e, r;
-  const i = /* @__PURE__ */ new Set(), c = (t) => {
-    const n = typeof t == "function" ? t(e) : t;
-    if (!Object.is(n, e)) {
-      const S = e;
-      e = typeof n != "object" || n === null || Array.isArray(n) ? n : Object.assign({}, e, n), i.forEach((l) => l(e, S));
-    }
-  }, u = (t) => (i.add(t), () => i.delete(t)), s = () => e, a = () => r;
-  typeof o == "function" ? r = e = o(c, s) : r = e = o;
-  function f(t) {
-    return p(
-      u,
-      () => t ? t(s()) : s(),
-      () => t ? t(a()) : a()
-    );
-  }
-  return {
-    set: c,
-    get: s,
-    getInitial: a,
-    use: f,
-    subscribe: u
-  };
+import { useSyncExternalStore as e } from "react";
+//#region src/helpers/createStore/createStore.ts
+var t = (t) => {
+	let n, r, i = /* @__PURE__ */ new Set(), a = (e) => {
+		let t = typeof e == "function" ? e(n) : e;
+		if (!Object.is(t, n)) {
+			let e = n;
+			n = typeof t != "object" || !t || Array.isArray(t) ? t : Object.assign({}, n, t), i.forEach((t) => t(n, e));
+		}
+	}, o = (e) => (i.add(e), () => i.delete(e)), s = () => n, c = () => r;
+	r = n = typeof t == "function" ? t(a, s) : t;
+	function l(t) {
+		return e(o, () => t ? t(s()) : s(), () => t ? t(c()) : c());
+	}
+	return {
+		set: a,
+		get: s,
+		getInitial: c,
+		use: l,
+		subscribe: o
+	};
 };
-export {
-  b as createStore
-};
-//# sourceMappingURL=createStore.mjs.map
+//#endregion
+export { t as createStore };
+
+//# sourceMappingURL=createStore.mjs.map

package/dist/esm/helpers/createStore/createStore.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createStore.mjs","sources":["../../../../src/helpers/createStore/createStore.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\ntype StoreSetAction<Value> = ((prev: Value) => Partial<Value>) | Partial<Value>;\n\ntype StoreListener<Value> = (state: Value, prevState: Value) => void;\n\ntype StoreCreator<Value> = (\n  set: (action: StoreSetAction<Value>) => void,\n  get: () => Value\n) => Value;\n\nexport interface StoreApi<Value> {\n  get: () => Value;\n  getInitial: () => Value;\n  set: (action: StoreSetAction<Value>) => void;\n  subscribe: (listener: StoreListener<Value>) => () => void;\n\n  use: (() => Value) &\n    (<Selected>(selector: (state: Value) => Selected) => Selected) &\n    (<Selected>(selector?: (state: Value) => Selected) => Selected | Value);\n}\n\n/**\n * @name createStore\n * @description - Creates a store with state management capabilities\n * @category Helpers\n * @usage medium\n *\n * @template Value - The type of the store state\n * @param {StateCreator<Value>} createState - Function that initializes the store state\n * @returns {StoreApi<Value>} - Object containing store methods and hook for accessing state\n *\n * @example\n * const { set, get, use, subscribe } = createStore((set) => ({\n *   count: 0,\n *   increment: () => set(state => ({ count: state.count + 1 }))\n * }));\n */\nexport const createStore = <Value>(createState: StoreCreator<Value> | Value): StoreApi<Value> => {\n  let state: Value;\n  let initialState: Value;\n  const listeners: Set<StoreListener<Value>> = new Set();\n\n  const setState: StoreApi<Value>['set'] = (action: StoreSetAction<Value>) => {\n    const nextState = typeof action === 'function' ? action(state) : action;\n\n    if (!Object.is(nextState, state)) {\n      const prevState = state;\n      state = (\n        typeof nextState !== 'object' || nextState === null || Array.isArray(nextState)\n          ? nextState\n          : Object.assign({}, state, nextState)\n      ) as Value;\n\n      listeners.forEach((listener) => listener(state, prevState));\n    }\n  };\n\n  const subscribe = (listener: StoreListener<Value>) => {\n    listeners.add(listener);\n\n    return () => listeners.delete(listener);\n  };\n\n  const getState = () => state;\n  const getInitialState = () => initialState;\n\n  if (typeof createState === 'function') {\n    initialState = state = (createState as StoreCreator<Value>)(setState, getState);\n  } else {\n    initialState = state = createState;\n  }\n\n  function useStore(): Value;\n  function useStore<Selected>(selector: (state: Value) => Selected): Selected;\n  function useStore<Selected>(selector?: (state: Value) => Selected): Selected | Value {\n    return useSyncExternalStore(\n      subscribe,\n      () => (selector ? selector(getState()) : getState()),\n      () => (selector ? selector(getInitialState()) : getInitialState())\n    );\n  }\n\n  return {\n    set: setState,\n    get: getState,\n    getInitial: getInitialState,\n    use: useStore,\n    subscribe\n  };\n};\n"],"names":["createStore","createState","state","initialState","listeners","setState","action","nextState","prevState","listener","subscribe","getState","getInitialState","useStore","selector","useSyncExternalStore"],"mappings":";AAsCO,MAAMA,IAAc,CAAQC,MAA8D;AAC/F,MAAIC,GACAC;AACJ,QAAMC,wBAA2C,IAAA,GAE3CC,IAAmC,CAACC,MAAkC;AAC1E,UAAMC,IAAY,OAAOD,KAAW,aAAaA,EAAOJ,CAAK,IAAII;AAEjE,QAAI,CAAC,OAAO,GAAGC,GAAWL,CAAK,GAAG;AAChC,YAAMM,IAAYN;AAClB,MAAAA,IACE,OAAOK,KAAc,YAAYA,MAAc,QAAQ,MAAM,QAAQA,CAAS,IAC1EA,IACA,OAAO,OAAO,CAAA,GAAIL,GAAOK,CAAS,GAGxCH,EAAU,QAAQ,CAACK,MAAaA,EAASP,GAAOM,CAAS,CAAC;AAAA,IAAA;AAAA,EAC5D,GAGIE,IAAY,CAACD,OACjBL,EAAU,IAAIK,CAAQ,GAEf,MAAML,EAAU,OAAOK,CAAQ,IAGlCE,IAAW,MAAMT,GACjBU,IAAkB,MAAMT;AAE9B,EAAI,OAAOF,KAAgB,aACzBE,IAAeD,IAASD,EAAoCI,GAAUM,CAAQ,IAE9ER,IAAeD,IAAQD;AAKzB,WAASY,EAAmBC,GAAyD;AACnF,WAAOC;AAAA,MACLL;AAAA,MACA,MAAOI,IAAWA,EAASH,EAAA,CAAU,IAAIA,EAAA;AAAA,MACzC,MAAOG,IAAWA,EAASF,EAAA,CAAiB,IAAIA,EAAA;AAAA,IAAgB;AAAA,EAClE;AAGF,SAAO;AAAA,IACL,KAAKP;AAAA,IACL,KAAKM;AAAA,IACL,YAAYC;AAAA,IACZ,KAAKC;AAAA,IACL,WAAAH;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"createStore.mjs","names":[],"sources":["../../../../src/helpers/createStore/createStore.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\ntype StoreSetAction<Value> = ((prev: Value) => Partial<Value>) | Partial<Value>;\n\ntype StoreListener<Value> = (state: Value, prevState: Value) => void;\n\ntype StoreCreator<Value> = (\n  set: (action: StoreSetAction<Value>) => void,\n  get: () => Value\n) => Value;\n\nexport interface StoreApi<Value> {\n  get: () => Value;\n  getInitial: () => Value;\n  set: (action: StoreSetAction<Value>) => void;\n  subscribe: (listener: StoreListener<Value>) => () => void;\n\n  use: (() => Value) &\n    (<Selected>(selector: (state: Value) => Selected) => Selected) &\n    (<Selected>(selector?: (state: Value) => Selected) => Selected | Value);\n}\n\n/**\n * @name createStore\n * @description - Creates a store with state management capabilities\n * @category Helpers\n * @usage medium\n *\n * @template Value - The type of the store state\n * @param {StateCreator<Value>} createState - Function that initializes the store state\n * @returns {StoreApi<Value>} - Object containing store methods and hook for accessing state\n *\n * @example\n * const { set, get, use, subscribe } = createStore((set) => ({\n *   count: 0,\n *   increment: () => set(state => ({ count: state.count + 1 }))\n * }));\n */\nexport const createStore = <Value>(createState: StoreCreator<Value> | Value): StoreApi<Value> => {\n  let state: Value;\n  let initialState: Value;\n  const listeners: Set<StoreListener<Value>> = new Set();\n\n  const setState: StoreApi<Value>['set'] = (action: StoreSetAction<Value>) => {\n    const nextState = typeof action === 'function' ? action(state) : action;\n\n    if (!Object.is(nextState, state)) {\n      const prevState = state;\n      state = (\n        typeof nextState !== 'object' || nextState === null || Array.isArray(nextState)\n          ? nextState\n          : Object.assign({}, state, nextState)\n      ) as Value;\n\n      listeners.forEach((listener) => listener(state, prevState));\n    }\n  };\n\n  const subscribe = (listener: StoreListener<Value>) => {\n    listeners.add(listener);\n\n    return () => listeners.delete(listener);\n  };\n\n  const getState = () => state;\n  const getInitialState = () => initialState;\n\n  if (typeof createState === 'function') {\n    initialState = state = (createState as StoreCreator<Value>)(setState, getState);\n  } else {\n    initialState = state = createState;\n  }\n\n  function useStore(): Value;\n  function useStore<Selected>(selector: (state: Value) => Selected): Selected;\n  function useStore<Selected>(selector?: (state: Value) => Selected): Selected | Value {\n    return useSyncExternalStore(\n      subscribe,\n      () => (selector ? selector(getState()) : getState()),\n      () => (selector ? selector(getInitialState()) : getInitialState())\n    );\n  }\n\n  return {\n    set: setState,\n    get: getState,\n    getInitial: getInitialState,\n    use: useStore,\n    subscribe\n  };\n};\n"],"mappings":";;AAsCA,IAAa,KAAsB,MAA8D;CAC/F,IAAI,GACA,GACE,oBAAuC,IAAI,KAAK,EAEhD,KAAoC,MAAkC;EAC1E,IAAM,IAAY,OAAO,KAAW,aAAa,EAAO,EAAM,GAAG;AAEjE,MAAI,CAAC,OAAO,GAAG,GAAW,EAAM,EAAE;GAChC,IAAM,IAAY;AAOlB,GANA,IACE,OAAO,KAAc,aAAY,KAAsB,MAAM,QAAQ,EAAU,GAC3E,IACA,OAAO,OAAO,EAAE,EAAE,GAAO,EAAU,EAGzC,EAAU,SAAS,MAAa,EAAS,GAAO,EAAU,CAAC;;IAIzD,KAAa,OACjB,EAAU,IAAI,EAAS,QAEV,EAAU,OAAO,EAAS,GAGnC,UAAiB,GACjB,UAAwB;AAE9B,CAGE,IAHF,AAGiB,IAHb,OAAO,KAAgB,aACD,EAAoC,GAAU,EAAS,GAExD;CAKzB,SAAS,EAAmB,GAAyD;AACnF,SAAO,EACL,SACO,IAAW,EAAS,GAAU,CAAC,GAAG,GAAU,QAC5C,IAAW,EAAS,GAAiB,CAAC,GAAG,GAAiB,CAClE;;AAGH,QAAO;EACL,KAAK;EACL,KAAK;EACL,YAAY;EACZ,KAAK;EACL;EACD"}

package/dist/esm/helpers/makeDestructurable/makeDestructurable.mjs

@@ -0,0 +1,21 @@
+//#region src/helpers/makeDestructurable/makeDestructurable.ts
+var e = (e, t) => {
+	if (typeof Symbol < "u") {
+		let n = { ...e };
+		return Object.defineProperty(n, Symbol.iterator, {
+			enumerable: !1,
+			value() {
+				let e = 0;
+				return { next: () => ({
+					value: t[e++],
+					done: e > t.length
+				}) };
+			}
+		}), n;
+	}
+	return Object.assign([...t], e);
+};
+//#endregion
+export { e as makeDestructurable };
+
+//# sourceMappingURL=makeDestructurable.mjs.map

package/dist/esm/helpers/makeDestructurable/makeDestructurable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeDestructurable.mjs","names":[],"sources":["../../../../src/helpers/makeDestructurable/makeDestructurable.ts"],"sourcesContent":["/**\n * @name makeDestructurable\n * @description - Makes an object also iterable for array-style destructuring\n * @category Helpers\n * @usage low\n *\n * @template Object - The object shape\n * @template Array - The tuple/array shape for destructuring\n * @param {object} obj - Object part of the returned value\n * @param {Array} arr - Iterable tuple/array part of the returned value\n * @returns {object & Array} Combined object that supports both object and array destructuring\n *\n * @example\n * const result = makeDestructurable({ x: 10, y: 20 }, [10, 20] as const);\n */\nexport const makeDestructurable = <\n  Obj extends Record<string, unknown>,\n  Arr extends readonly unknown[]\n>(\n  obj: Obj,\n  arr: Arr\n): Obj & Arr => {\n  if (typeof Symbol !== 'undefined') {\n    const clone = { ...obj };\n\n    Object.defineProperty(clone, Symbol.iterator, {\n      enumerable: false,\n      value() {\n        let index = 0;\n        return {\n          next: () => ({\n            value: arr[index++],\n            done: index > arr.length\n          })\n        };\n      }\n    });\n\n    return clone as unknown as Obj & Arr;\n  }\n\n  return Object.assign([...arr], obj) as unknown as Obj & Arr;\n};\n"],"mappings":";AAeA,IAAa,KAIX,GACA,MACc;AACd,KAAI,OAAO,SAAW,KAAa;EACjC,IAAM,IAAQ,EAAE,GAAG,GAAK;AAexB,SAbA,OAAO,eAAe,GAAO,OAAO,UAAU;GAC5C,YAAY;GACZ,QAAQ;IACN,IAAI,IAAQ;AACZ,WAAO,EACL,aAAa;KACX,OAAO,EAAI;KACX,MAAM,IAAQ,EAAI;KACnB,GACF;;GAEJ,CAAC,EAEK;;AAGT,QAAO,OAAO,OAAO,CAAC,GAAG,EAAI,EAAE,EAAI"}

package/dist/esm/hooks/useActiveElement/useActiveElement.mjs

@@ -1,28 +1,29 @@
-import { useState as f, useEffect as v } from "react";
-import { useRefState as d } from "../useRefState/useRefState.mjs";
-import { isTarget as s } from "../../utils/helpers/isTarget.mjs";
-const L = ((...u) => {
-  const e = s(u[0]) ? u[0] : void 0, [i, c] = f(null), o = d();
-  return v(() => {
-    const t = (e ? s.getElement(e) : o.current) ?? window, m = new MutationObserver((l) => {
-      l.filter((r) => r.removedNodes.length).map((r) => Array.from(r.removedNodes)).flat().forEach((r) => {
-        c((a) => r === a ? document.activeElement : a);
-      });
-    });
-    m.observe(t, {
-      childList: !0,
-      subtree: !0
-    });
-    const n = () => c(document?.activeElement);
-    return t.addEventListener("focus", n, !0), t.addEventListener("blur", n, !0), () => {
-      m.disconnect(), t.removeEventListener("focus", n, !0), t.removeEventListener("blur", n, !0);
-    };
-  }, [e && s.getRawElement(e), o.state]), e ? { value: i } : {
-    ref: o,
-    value: 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/useActiveElement/useActiveElement.ts
+var i = ((...i) => {
+	let a = e(i[0]) ? i[0] : void 0, [o, s] = r(null), c = t();
+	return n(() => {
+		let t = (a ? e.getElement(a) : c.current) ?? window, n = new MutationObserver((e) => {
+			e.filter((e) => e.removedNodes.length).map((e) => Array.from(e.removedNodes)).flat().forEach((e) => {
+				s((t) => e === t ? document.activeElement : t);
+			});
+		});
+		n.observe(t, {
+			childList: !0,
+			subtree: !0
+		});
+		let r = () => s(document?.activeElement);
+		return t.addEventListener("focus", r, !0), t.addEventListener("blur", r, !0), () => {
+			n.disconnect(), t.removeEventListener("focus", r, !0), t.removeEventListener("blur", r, !0);
+		};
+	}, [a && e.getRawElement(a), c.state]), a ? { value: o } : {
+		ref: c,
+		value: o
+	};
 });
-export {
-  L as useActiveElement
-};
-//# sourceMappingURL=useActiveElement.mjs.map
+//#endregion
+export { i as useActiveElement };
+
+//# sourceMappingURL=useActiveElement.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useActiveElement.mjs","sources":["../../../../src/hooks/useActiveElement/useActiveElement.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use active element return type */\nexport interface UseActiveElementReturn<ActiveElement extends HTMLElement = HTMLElement> {\n  value: ActiveElement | null;\n}\n\nexport interface UseActiveElement {\n  (): UseActiveElementReturn;\n\n  <Target extends Element, ActiveElement extends HTMLElement = HTMLElement>(\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n  } & UseActiveElementReturn<ActiveElement>;\n\n  <ActiveElement extends HTMLElement = HTMLElement>(\n    target: HookTarget\n  ): UseActiveElementReturn<ActiveElement>;\n}\n\n/**\n * @name useActiveElement\n * @description - Hook that returns the active element\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {HookTarget} [target=window] The target element to observe active element changes\n * @returns {ActiveElement | null} The active element\n *\n * @example\n * const activeElement = useActiveElement(ref);\n *\n * @overload\n * @template ActiveElement The active element type\n * @returns {{ ref: StateRef<Element>; activeElement: ActiveElement | null }} An object containing the ref and active element\n *\n * @example\n * const { ref, value } = useActiveElement();\n *\n * @see {@link https://siberiacancode.github.io/reactuse/functions/hooks/useActiveElement.html}\n */\nexport const useActiveElement = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const [value, setValue] = useState<HTMLElement | null>(null);\n  const internalRef = useRefState();\n\n  useEffect(() => {\n    const element = ((target ? isTarget.getElement(target) : internalRef.current) ??\n      window) as Element;\n\n    const observer = new MutationObserver((mutations) => {\n      mutations\n        .filter((mutation) => mutation.removedNodes.length)\n        .map((mutation) => Array.from(mutation.removedNodes))\n        .flat()\n        .forEach((node) => {\n          setValue((prevActiveElement) => {\n            if (node === prevActiveElement) return document.activeElement as HTMLElement | null;\n            return prevActiveElement;\n          });\n        });\n    });\n\n    observer.observe(element, {\n      childList: true,\n      subtree: true\n    });\n\n    const onActiveElementChange = () => setValue(document?.activeElement as HTMLElement | null);\n\n    element.addEventListener('focus', onActiveElementChange, true);\n    element.addEventListener('blur', onActiveElementChange, true);\n\n    return () => {\n      observer.disconnect();\n      element.removeEventListener('focus', onActiveElementChange, true);\n      element.removeEventListener('blur', onActiveElementChange, true);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return { value };\n  return {\n    ref: internalRef,\n    value\n  };\n}) as UseActiveElement;\n"],"names":["useActiveElement","params","target","isTarget","value","setValue","useState","internalRef","useRefState","useEffect","element","observer","mutations","mutation","node","prevActiveElement","onActiveElementChange"],"mappings":";;;AAmDO,MAAMA,KAAoB,IAAIC,MAAkB;AACrD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAE5C,CAACG,GAAOC,CAAQ,IAAIC,EAA6B,IAAI,GACrDC,IAAcC,EAAA;AAoCpB,SAlCAC,EAAU,MAAM;AACd,UAAMC,KAAYR,IAASC,EAAS,WAAWD,CAAM,IAAIK,EAAY,YACnE,QAEII,IAAW,IAAI,iBAAiB,CAACC,MAAc;AACnD,MAAAA,EACG,OAAO,CAACC,MAAaA,EAAS,aAAa,MAAM,EACjD,IAAI,CAACA,MAAa,MAAM,KAAKA,EAAS,YAAY,CAAC,EACnD,OACA,QAAQ,CAACC,MAAS;AACjB,QAAAT,EAAS,CAACU,MACJD,MAASC,IAA0B,SAAS,gBACzCA,CACR;AAAA,MAAA,CACF;AAAA,IAAA,CACJ;AAED,IAAAJ,EAAS,QAAQD,GAAS;AAAA,MACxB,WAAW;AAAA,MACX,SAAS;AAAA,IAAA,CACV;AAED,UAAMM,IAAwB,MAAMX,EAAS,UAAU,aAAmC;AAE1F,WAAAK,EAAQ,iBAAiB,SAASM,GAAuB,EAAI,GAC7DN,EAAQ,iBAAiB,QAAQM,GAAuB,EAAI,GAErD,MAAM;AACX,MAAAL,EAAS,WAAA,GACTD,EAAQ,oBAAoB,SAASM,GAAuB,EAAI,GAChEN,EAAQ,oBAAoB,QAAQM,GAAuB,EAAI;AAAA,IAAA;AAAA,EACjE,GACC,CAACd,KAAUC,EAAS,cAAcD,CAAM,GAAGK,EAAY,KAAK,CAAC,GAE5DL,IAAe,EAAE,OAAAE,EAAA,IACd;AAAA,IACL,KAAKG;AAAA,IACL,OAAAH;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useActiveElement.mjs","names":[],"sources":["../../../../src/hooks/useActiveElement/useActiveElement.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use active element return type */\nexport interface UseActiveElementReturn<ActiveElement extends HTMLElement = HTMLElement> {\n  value: ActiveElement | null;\n}\n\nexport interface UseActiveElement {\n  (): UseActiveElementReturn;\n\n  <Target extends Element, ActiveElement extends HTMLElement = HTMLElement>(\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n  } & UseActiveElementReturn<ActiveElement>;\n\n  <ActiveElement extends HTMLElement = HTMLElement>(\n    target: HookTarget\n  ): UseActiveElementReturn<ActiveElement>;\n}\n\n/**\n * @name useActiveElement\n * @description - Hook that returns the active element\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {HookTarget} [target=window] The target element to observe active element changes\n * @returns {ActiveElement | null} The active element\n *\n * @example\n * const activeElement = useActiveElement(ref);\n *\n * @overload\n * @template ActiveElement The active element type\n * @returns {{ ref: StateRef<Element>; activeElement: ActiveElement | null }} An object containing the ref and active element\n *\n * @example\n * const { ref, value } = useActiveElement();\n *\n * @see {@link https://siberiacancode.github.io/reactuse/functions/hooks/useActiveElement.html}\n */\nexport const useActiveElement = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const [value, setValue] = useState<HTMLElement | null>(null);\n  const internalRef = useRefState();\n\n  useEffect(() => {\n    const element = ((target ? isTarget.getElement(target) : internalRef.current) ??\n      window) as Element;\n\n    const observer = new MutationObserver((mutations) => {\n      mutations\n        .filter((mutation) => mutation.removedNodes.length)\n        .map((mutation) => Array.from(mutation.removedNodes))\n        .flat()\n        .forEach((node) => {\n          setValue((prevActiveElement) => {\n            if (node === prevActiveElement) return document.activeElement as HTMLElement | null;\n            return prevActiveElement;\n          });\n        });\n    });\n\n    observer.observe(element, {\n      childList: true,\n      subtree: true\n    });\n\n    const onActiveElementChange = () => setValue(document?.activeElement as HTMLElement | null);\n\n    element.addEventListener('focus', onActiveElementChange, true);\n    element.addEventListener('blur', onActiveElementChange, true);\n\n    return () => {\n      observer.disconnect();\n      element.removeEventListener('focus', onActiveElementChange, true);\n      element.removeEventListener('blur', onActiveElementChange, true);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return { value };\n  return {\n    ref: internalRef,\n    value\n  };\n}) as UseActiveElement;\n"],"mappings":";;;;AAmDA,IAAa,MAAqB,GAAG,MAAkB;CACrD,IAAM,IAAU,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAE5C,CAAC,GAAO,KAAY,EAA6B,KAAK,EACtD,IAAc,GAAa;AAqCjC,QAnCA,QAAgB;EACd,IAAM,KAAY,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY,YACnE,QAEI,IAAW,IAAI,kBAAkB,MAAc;AACnD,KACG,QAAQ,MAAa,EAAS,aAAa,OAAO,CAClD,KAAK,MAAa,MAAM,KAAK,EAAS,aAAa,CAAC,CACpD,MAAM,CACN,SAAS,MAAS;AACjB,OAAU,MACJ,MAAS,IAA0B,SAAS,gBACzC,EACP;KACF;IACJ;AAEF,IAAS,QAAQ,GAAS;GACxB,WAAW;GACX,SAAS;GACV,CAAC;EAEF,IAAM,UAA8B,EAAS,UAAU,cAAoC;AAK3F,SAHA,EAAQ,iBAAiB,SAAS,GAAuB,GAAK,EAC9D,EAAQ,iBAAiB,QAAQ,GAAuB,GAAK,QAEhD;AAGX,GAFA,EAAS,YAAY,EACrB,EAAQ,oBAAoB,SAAS,GAAuB,GAAK,EACjE,EAAQ,oBAAoB,QAAQ,GAAuB,GAAK;;IAEjE,CAAC,KAAU,EAAS,cAAc,EAAO,EAAE,EAAY,MAAM,CAAC,EAE7D,IAAe,EAAE,UAAO,GACrB;EACL,KAAK;EACL;EACD"}

package/dist/esm/hooks/useAsync/useAsync.mjs

@@ -1,22 +1,23 @@
-import { useState as t, useEffect as l } from "react";
-const v = (a, n = []) => {
-  const [c, s] = t(!0), [i, e] = t(!1), [f, o] = t(void 0), [u, d] = t(void 0);
-  return l(() => {
-    s(!0), a().then((r) => {
-      d(r), o(void 0), e(!1);
-    }).catch((r) => {
-      o(r), e(!0);
-    }).finally(() => {
-      s(!1);
-    });
-  }, n), {
-    data: u,
-    isLoading: c,
-    isError: i,
-    error: f
-  };
+import { useEffect as e, useState as t } from "react";
+//#region src/hooks/useAsync/useAsync.ts
+var n = (n, r = []) => {
+	let [i, a] = t(!0), [o, s] = t(!1), [c, l] = t(void 0), [u, d] = t(void 0);
+	return e(() => {
+		a(!0), n().then((e) => {
+			d(e), l(void 0), s(!1);
+		}).catch((e) => {
+			l(e), s(!0);
+		}).finally(() => {
+			a(!1);
+		});
+	}, r), {
+		data: u,
+		isLoading: i,
+		isError: o,
+		error: c
+	};
 };
-export {
-  v as useAsync
-};
-//# sourceMappingURL=useAsync.mjs.map
+//#endregion
+export { n as useAsync };
+
+//# sourceMappingURL=useAsync.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAsync.mjs","sources":["../../../../src/hooks/useAsync/useAsync.ts"],"sourcesContent":["import type { DependencyList } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/* The use query return type */\nexport interface UseAsyncReturn<Data> {\n  /* The state of the query */\n  data?: Data;\n  /* The error of the query */\n  error?: Error;\n  /* The error state of the query  */\n  isError: boolean;\n  /* The loading state of the query */\n  isLoading: boolean;\n}\n\n/**\n * @name useAsync\n * @description - Hook that provides the state of an async callback\n * @category Async\n * @usage medium\n *\n * @param {() => Promise<Data>} callback The async callback\n * @param {DependencyList} [deps=[]] The dependencies of the callback\n * @returns {UseAsyncReturn<Data>} The state of the async callback\n *\n * @example\n * const { data, isLoading, isError, error } = useAsync(() => fetch('url'), [deps]);\n */\nexport const useAsync = <Data>(\n  callback: () => Promise<Data>,\n  deps: DependencyList = []\n): UseAsyncReturn<Data> => {\n  const [isLoading, setIsLoading] = useState(true);\n  const [isError, setIsError] = useState(false);\n\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [data, setData] = useState<Data | undefined>(undefined);\n\n  useEffect(() => {\n    setIsLoading(true);\n    callback()\n      .then((response) => {\n        setData(response);\n        setError(undefined);\n        setIsError(false);\n      })\n      .catch((error: Error) => {\n        setError(error);\n        setIsError(true);\n      })\n      .finally(() => {\n        setIsLoading(false);\n      });\n  }, deps);\n\n  return {\n    data,\n    isLoading,\n    isError,\n    error\n  };\n};\n"],"names":["useAsync","callback","deps","isLoading","setIsLoading","useState","isError","setIsError","error","setError","data","setData","useEffect","response"],"mappings":";AA6BO,MAAMA,IAAW,CACtBC,GACAC,IAAuB,OACE;AACzB,QAAM,CAACC,GAAWC,CAAY,IAAIC,EAAS,EAAI,GACzC,CAACC,GAASC,CAAU,IAAIF,EAAS,EAAK,GAEtC,CAACG,GAAOC,CAAQ,IAAIJ,EAA4B,MAAS,GACzD,CAACK,GAAMC,CAAO,IAAIN,EAA2B,MAAS;AAE5D,SAAAO,EAAU,MAAM;AACd,IAAAR,EAAa,EAAI,GACjBH,EAAA,EACG,KAAK,CAACY,MAAa;AAClB,MAAAF,EAAQE,CAAQ,GAChBJ,EAAS,MAAS,GAClBF,EAAW,EAAK;AAAA,IAAA,CACjB,EACA,MAAM,CAACC,MAAiB;AACvB,MAAAC,EAASD,CAAK,GACdD,EAAW,EAAI;AAAA,IAAA,CAChB,EACA,QAAQ,MAAM;AACb,MAAAH,EAAa,EAAK;AAAA,IAAA,CACnB;AAAA,EAAA,GACFF,CAAI,GAEA;AAAA,IACL,MAAAQ;AAAA,IACA,WAAAP;AAAA,IACA,SAAAG;AAAA,IACA,OAAAE;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useAsync.mjs","names":[],"sources":["../../../../src/hooks/useAsync/useAsync.ts"],"sourcesContent":["import type { DependencyList } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/* The use query return type */\nexport interface UseAsyncReturn<Data> {\n  /* The state of the query */\n  data?: Data;\n  /* The error of the query */\n  error?: Error;\n  /* The error state of the query  */\n  isError: boolean;\n  /* The loading state of the query */\n  isLoading: boolean;\n}\n\n/**\n * @name useAsync\n * @description - Hook that provides the state of an async callback\n * @category Async\n * @usage medium\n *\n * @param {() => Promise<Data>} callback The async callback\n * @param {DependencyList} [deps=[]] The dependencies of the callback\n * @returns {UseAsyncReturn<Data>} The state of the async callback\n *\n * @example\n * const { data, isLoading, isError, error } = useAsync(() => fetch('url'), [deps]);\n */\nexport const useAsync = <Data>(\n  callback: () => Promise<Data>,\n  deps: DependencyList = []\n): UseAsyncReturn<Data> => {\n  const [isLoading, setIsLoading] = useState(true);\n  const [isError, setIsError] = useState(false);\n\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [data, setData] = useState<Data | undefined>(undefined);\n\n  useEffect(() => {\n    setIsLoading(true);\n    callback()\n      .then((response) => {\n        setData(response);\n        setError(undefined);\n        setIsError(false);\n      })\n      .catch((error: Error) => {\n        setError(error);\n        setIsError(true);\n      })\n      .finally(() => {\n        setIsLoading(false);\n      });\n  }, deps);\n\n  return {\n    data,\n    isLoading,\n    isError,\n    error\n  };\n};\n"],"mappings":";;AA6BA,IAAa,KACX,GACA,IAAuB,EAAE,KACA;CACzB,IAAM,CAAC,GAAW,KAAgB,EAAS,GAAK,EAC1C,CAAC,GAAS,KAAc,EAAS,GAAM,EAEvC,CAAC,GAAO,KAAY,EAA4B,KAAA,EAAU,EAC1D,CAAC,GAAM,KAAW,EAA2B,KAAA,EAAU;AAmB7D,QAjBA,QAAgB;AAEd,EADA,EAAa,GAAK,EAClB,GAAU,CACP,MAAM,MAAa;AAGlB,GAFA,EAAQ,EAAS,EACjB,EAAS,KAAA,EAAU,EACnB,EAAW,GAAM;IACjB,CACD,OAAO,MAAiB;AAEvB,GADA,EAAS,EAAM,EACf,EAAW,GAAK;IAChB,CACD,cAAc;AACb,KAAa,GAAM;IACnB;IACH,EAAK,EAED;EACL;EACA;EACA;EACA;EACD"}

package/dist/esm/hooks/useAsyncEffect/useAsyncEffect.mjs

@@ -1,10 +1,11 @@
-import { useIsomorphicLayoutEffect as c } from "../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs";
-const f = (o, t) => {
-  c(() => {
-    o();
-  }, t);
+import { useIsomorphicLayoutEffect as e } from "../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs";
+//#region src/hooks/useAsyncEffect/useAsyncEffect.ts
+var t = (t, n) => {
+	e(() => {
+		t();
+	}, n);
 };
-export {
-  f as useAsyncEffect
-};
-//# sourceMappingURL=useAsyncEffect.mjs.map
+//#endregion
+export { t as useAsyncEffect };
+
+//# sourceMappingURL=useAsyncEffect.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAsyncEffect.mjs","sources":["../../../../src/hooks/useAsyncEffect/useAsyncEffect.ts"],"sourcesContent":["import type { DependencyList } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect';\n\n/**\n * @name useAsyncEffect\n * @description – Hook that triggers the effect callback on updates\n * @category Lifecycle\n * @usage medium\n\n * @param {EffectCallback} effect The effect callback\n * @param {DependencyList} [deps] The dependencies list for the effect\n *\n * @example\n * useAsyncEffect(async () => console.log(\"effect runs on updates\"), deps);\n */\nexport const useAsyncEffect = (сallback: () => Promise<any>, deps?: DependencyList): void => {\n  useIsomorphicLayoutEffect(() => {\n    сallback();\n  }, deps);\n};\n"],"names":["useAsyncEffect","сallback","deps","useIsomorphicLayoutEffect"],"mappings":";AAgBO,MAAMA,IAAiB,CAACC,GAA8BC,MAAgC;AAC3F,EAAAC,EAA0B,MAAM;AAC9B,IAAAF,EAAA;AAAA,EAAS,GACRC,CAAI;AACT;"}
+{"version":3,"file":"useAsyncEffect.mjs","names":[],"sources":["../../../../src/hooks/useAsyncEffect/useAsyncEffect.ts"],"sourcesContent":["import type { DependencyList } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect';\n\n/**\n * @name useAsyncEffect\n * @description – Hook that triggers the effect callback on updates\n * @category Lifecycle\n * @usage medium\n\n * @param {EffectCallback} effect The effect callback\n * @param {DependencyList} [deps] The dependencies list for the effect\n *\n * @example\n * useAsyncEffect(async () => console.log(\"effect runs on updates\"), deps);\n */\nexport const useAsyncEffect = (сallback: () => Promise<any>, deps?: DependencyList): void => {\n  useIsomorphicLayoutEffect(() => {\n    сallback();\n  }, deps);\n};\n"],"mappings":";;AAgBA,IAAa,KAAkB,GAA8B,MAAgC;AAC3F,SAAgC;AAC9B,KAAU;IACT,EAAK"}

package/dist/esm/hooks/useAudio/useAudio.mjs

@@ -1,56 +1,56 @@
-import { useState as o, useRef as h, useEffect as E } from "react";
-const P = (l, a = {}) => {
-  const [i, r] = o(!1), [m, v] = o(a.volume ?? 1), [d, f] = o(a.playbackRate ?? 1), t = h(null);
-  E(() => {
-    const e = new Audio(l);
-    if (e.volume = m, e.playbackRate = d, t.current = e, a.immediately)
-      try {
-        r(!0), e.play();
-      } catch {
-        r(!1);
-      }
-    const n = () => r(!0), c = () => r(!1), u = () => r(!1), y = () => v(e.volume), p = () => f(e.playbackRate);
-    return e.addEventListener("play", n), e.addEventListener("pause", c), e.addEventListener("ended", u), e.addEventListener("volumechange", y), e.addEventListener("ratechange", p), () => {
-      e.removeEventListener("play", n), e.removeEventListener("pause", c), e.removeEventListener("ended", u), e.removeEventListener("volumechange", y), e.removeEventListener("ratechange", p), e.pause(), e.remove();
-    };
-  }, [l]);
-  const s = () => {
-    t.current && (t.current.pause(), t.current.currentTime = 0, r(!1));
-  };
-  return {
-    play: async (e) => {
-      if (!t.current) return;
-      if (a.interrupt && s(), r(!0), !e || !a.sprite?.[e]) {
-        await t.current.play();
-        return;
-      }
-      const [n, c] = a.sprite[e];
-      t.current.currentTime = n, await t.current.play();
-      const u = () => {
-        t.current && (t.current.currentTime >= c && s(), i && requestAnimationFrame(u));
-      };
-      requestAnimationFrame(u);
-    },
-    pause: () => {
-      t.current && (t.current.pause(), r(!1));
-    },
-    stop: s,
-    playing: i,
-    setVolume: (e) => {
-      if (!t.current) return;
-      const n = Math.max(0, Math.min(1, e));
-      t.current.volume = n, v(n);
-    },
-    volume: m,
-    changePlaybackRate: (e) => {
-      if (!t.current) return;
-      const n = Math.max(0.5, Math.min(2, e));
-      t.current.playbackRate = n, f(n);
-    },
-    playbackRate: d
-  };
+import { useEffect as e, useRef as t, useState as n } from "react";
+//#region src/hooks/useAudio/useAudio.ts
+var r = (r, i = {}) => {
+	let [a, o] = n(!1), [s, c] = n(i.volume ?? 1), [l, u] = n(i.playbackRate ?? 1), d = t(null);
+	e(() => {
+		let e = new Audio(r);
+		if (e.volume = s, e.playbackRate = l, d.current = e, i.immediately) try {
+			o(!0), e.play();
+		} catch {
+			o(!1);
+		}
+		let t = () => o(!0), n = () => o(!1), a = () => o(!1), f = () => c(e.volume), p = () => u(e.playbackRate);
+		return e.addEventListener("play", t), e.addEventListener("pause", n), e.addEventListener("ended", a), e.addEventListener("volumechange", f), e.addEventListener("ratechange", p), () => {
+			e.removeEventListener("play", t), e.removeEventListener("pause", n), e.removeEventListener("ended", a), e.removeEventListener("volumechange", f), e.removeEventListener("ratechange", p), e.pause(), e.remove();
+		};
+	}, [r]);
+	let f = () => {
+		d.current && (d.current.pause(), d.current.currentTime = 0, o(!1));
+	};
+	return {
+		play: async (e) => {
+			if (!d.current) return;
+			if (i.interrupt && f(), o(!0), !e || !i.sprite?.[e]) {
+				await d.current.play();
+				return;
+			}
+			let [t, n] = i.sprite[e];
+			d.current.currentTime = t, await d.current.play();
+			let r = () => {
+				d.current && (d.current.currentTime >= n && f(), a && requestAnimationFrame(r));
+			};
+			requestAnimationFrame(r);
+		},
+		pause: () => {
+			d.current && (d.current.pause(), o(!1));
+		},
+		stop: f,
+		playing: a,
+		setVolume: (e) => {
+			if (!d.current) return;
+			let t = Math.max(0, Math.min(1, e));
+			d.current.volume = t, c(t);
+		},
+		volume: s,
+		changePlaybackRate: (e) => {
+			if (!d.current) return;
+			let t = Math.max(.5, Math.min(2, e));
+			d.current.playbackRate = t, u(t);
+		},
+		playbackRate: l
+	};
 };
-export {
-  P as useAudio
-};
-//# sourceMappingURL=useAudio.mjs.map
+//#endregion
+export { r as useAudio };
+
+//# sourceMappingURL=useAudio.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAudio.mjs","sources":["../../../../src/hooks/useAudio/useAudio.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** Type sprite map */\nexport interface SpriteMap {\n  /** [start time in seconds, end time in seconds] */\n  [key: string]: [number, number];\n}\n\n/** Type use audio options */\nexport interface UseAudioOptions {\n  /** Whether audio playback is initially enabled */\n  immediately?: boolean;\n  /** Whether to stop current playback when starting a new one */\n  interrupt?: boolean;\n  /** Initial playback speed (0.5 to 2) */\n  playbackRate?: number;\n  /** Map of named audio segments for sprite-based playback */\n  sprite?: SpriteMap;\n  /** Initial volume level (0 to 1) */\n  volume?: number;\n}\n\n/** Type use audio return type */\nexport interface UseAudioReturn {\n  /** Current playback speed (0.5 to 2) */\n  playbackRate: number;\n  /** Whether audio is currently playing */\n  playing: boolean;\n  /** Current volume level (0 to 1) */\n  volume: number;\n  /** Set playback speed (0.5 to 2) */\n  changePlaybackRate: (value: number) => void;\n  /** Pause audio playback at current position */\n  pause: () => void;\n  /** Start audio playback from the beginning or specified sprite segment */\n  play: (sprite?: string) => Promise<void>;\n  /** Set audio volume level (0 to 1) */\n  setVolume: (value: number) => void;\n  /** Stop audio playback and reset position to start */\n  stop: () => void;\n}\n\n/**\n * @name useAudio\n * @description - Hook that manages audio playback with sprite support\n * @category Browser\n * @usage low\n\n * @browserapi Audio https://developer.mozilla.org/en-US/docs/Web/API/Audio\n *\n * @template Value The type of the value\n * @param {string} url The URL of the audio file to play\n * @param {UseAudioOptions} [options] Audio configuration options\n * @param {number} [options.volume=1] Initial volume level (0 to 1)\n * @param {number} [options.playbackRate=1] Initial playback speed (0.5 to 2)\n * @param {boolean} [options.interrupt=false] Whether to stop current playback when starting a new one\n * @param {boolean} [options.soundEnabled=true] Whether audio playback is initially enabled\n * @param {SpriteMap} [options.sprite] Map of named audio segments for sprite-based playback\n * @returns {UseAudioReturn} An object containing audio controls and state\n *\n * @example\n * const audio = useAudio(\"/path/to/sound.mp3\");\n */\nexport const useAudio = (src: string, options: UseAudioOptions = {}): UseAudioReturn => {\n  const [playing, setPlaying] = useState(false);\n  const [volume, setCurrentVolume] = useState(options.volume ?? 1);\n  const [playbackRate, setPlaybackRate] = useState(options.playbackRate ?? 1);\n\n  const audioRef = useRef<HTMLAudioElement | null>(null);\n\n  useEffect(() => {\n    const audio = new Audio(src);\n\n    audio.volume = volume;\n    audio.playbackRate = playbackRate;\n    audioRef.current = audio;\n\n    if (options.immediately) {\n      try {\n        setPlaying(true);\n        audio.play();\n      } catch {\n        setPlaying(false);\n      }\n    }\n\n    const onPlay = () => setPlaying(true);\n    const onPause = () => setPlaying(false);\n    const onEnded = () => setPlaying(false);\n    const onVolumeChange = () => setCurrentVolume(audio.volume);\n    const onRateChange = () => setPlaybackRate(audio.playbackRate);\n\n    audio.addEventListener('play', onPlay);\n    audio.addEventListener('pause', onPause);\n    audio.addEventListener('ended', onEnded);\n    audio.addEventListener('volumechange', onVolumeChange);\n    audio.addEventListener('ratechange', onRateChange);\n\n    return () => {\n      audio.removeEventListener('play', onPlay);\n      audio.removeEventListener('pause', onPause);\n      audio.removeEventListener('ended', onEnded);\n      audio.removeEventListener('volumechange', onVolumeChange);\n      audio.removeEventListener('ratechange', onRateChange);\n\n      audio.pause();\n      audio.remove();\n    };\n  }, [src]);\n\n  const stop = () => {\n    if (!audioRef.current) return;\n    audioRef.current.pause();\n    audioRef.current.currentTime = 0;\n    setPlaying(false);\n  };\n\n  const play = async (spriteName?: string) => {\n    if (!audioRef.current) return;\n    if (options.interrupt) stop();\n\n    setPlaying(true);\n\n    if (!spriteName || !options.sprite?.[spriteName]) {\n      await audioRef.current.play();\n      return;\n    }\n\n    const [start, end] = options.sprite[spriteName];\n    audioRef.current.currentTime = start;\n    await audioRef.current.play();\n\n    const checkTime = () => {\n      if (!audioRef.current) return;\n      if (audioRef.current.currentTime >= end) {\n        stop();\n      }\n\n      if (!playing) return;\n\n      requestAnimationFrame(checkTime);\n    };\n\n    requestAnimationFrame(checkTime);\n  };\n\n  const pause = () => {\n    if (!audioRef.current) return;\n    audioRef.current.pause();\n    setPlaying(false);\n  };\n\n  const setVolume = (value: number) => {\n    if (!audioRef.current) return;\n    const newVolume = Math.max(0, Math.min(1, value));\n    audioRef.current.volume = newVolume;\n    setCurrentVolume(newVolume);\n  };\n\n  const changePlaybackRate = (value: number) => {\n    if (!audioRef.current) return;\n    const newRate = Math.max(0.5, Math.min(2, value));\n    audioRef.current.playbackRate = newRate;\n    setPlaybackRate(newRate);\n  };\n\n  return {\n    play,\n    pause,\n    stop,\n    playing,\n    setVolume,\n    volume,\n    changePlaybackRate,\n    playbackRate\n  };\n};\n"],"names":["useAudio","src","options","playing","setPlaying","useState","volume","setCurrentVolume","playbackRate","setPlaybackRate","audioRef","useRef","useEffect","audio","onPlay","onPause","onEnded","onVolumeChange","onRateChange","stop","spriteName","start","end","checkTime","value","newVolume","newRate"],"mappings":";AA+DO,MAAMA,IAAW,CAACC,GAAaC,IAA2B,OAAuB;AACtF,QAAM,CAACC,GAASC,CAAU,IAAIC,EAAS,EAAK,GACtC,CAACC,GAAQC,CAAgB,IAAIF,EAASH,EAAQ,UAAU,CAAC,GACzD,CAACM,GAAcC,CAAe,IAAIJ,EAASH,EAAQ,gBAAgB,CAAC,GAEpEQ,IAAWC,EAAgC,IAAI;AAErD,EAAAC,EAAU,MAAM;AACd,UAAMC,IAAQ,IAAI,MAAMZ,CAAG;AAM3B,QAJAY,EAAM,SAASP,GACfO,EAAM,eAAeL,GACrBE,EAAS,UAAUG,GAEfX,EAAQ;AACV,UAAI;AACF,QAAAE,EAAW,EAAI,GACfS,EAAM,KAAA;AAAA,MAAK,QACL;AACN,QAAAT,EAAW,EAAK;AAAA,MAAA;AAIpB,UAAMU,IAAS,MAAMV,EAAW,EAAI,GAC9BW,IAAU,MAAMX,EAAW,EAAK,GAChCY,IAAU,MAAMZ,EAAW,EAAK,GAChCa,IAAiB,MAAMV,EAAiBM,EAAM,MAAM,GACpDK,IAAe,MAAMT,EAAgBI,EAAM,YAAY;AAE7D,WAAAA,EAAM,iBAAiB,QAAQC,CAAM,GACrCD,EAAM,iBAAiB,SAASE,CAAO,GACvCF,EAAM,iBAAiB,SAASG,CAAO,GACvCH,EAAM,iBAAiB,gBAAgBI,CAAc,GACrDJ,EAAM,iBAAiB,cAAcK,CAAY,GAE1C,MAAM;AACX,MAAAL,EAAM,oBAAoB,QAAQC,CAAM,GACxCD,EAAM,oBAAoB,SAASE,CAAO,GAC1CF,EAAM,oBAAoB,SAASG,CAAO,GAC1CH,EAAM,oBAAoB,gBAAgBI,CAAc,GACxDJ,EAAM,oBAAoB,cAAcK,CAAY,GAEpDL,EAAM,MAAA,GACNA,EAAM,OAAA;AAAA,IAAO;AAAA,EACf,GACC,CAACZ,CAAG,CAAC;AAER,QAAMkB,IAAO,MAAM;AACjB,IAAKT,EAAS,YACdA,EAAS,QAAQ,MAAA,GACjBA,EAAS,QAAQ,cAAc,GAC/BN,EAAW,EAAK;AAAA,EAAA;AAoDlB,SAAO;AAAA,IACL,MAlDW,OAAOgB,MAAwB;AAC1C,UAAI,CAACV,EAAS,QAAS;AAKvB,UAJIR,EAAQ,aAAWiB,EAAA,GAEvBf,EAAW,EAAI,GAEX,CAACgB,KAAc,CAAClB,EAAQ,SAASkB,CAAU,GAAG;AAChD,cAAMV,EAAS,QAAQ,KAAA;AACvB;AAAA,MAAA;AAGF,YAAM,CAACW,GAAOC,CAAG,IAAIpB,EAAQ,OAAOkB,CAAU;AAC9C,MAAAV,EAAS,QAAQ,cAAcW,GAC/B,MAAMX,EAAS,QAAQ,KAAA;AAEvB,YAAMa,IAAY,MAAM;AACtB,QAAKb,EAAS,YACVA,EAAS,QAAQ,eAAeY,KAClCH,EAAA,GAGGhB,KAEL,sBAAsBoB,CAAS;AAAA,MAAA;AAGjC,4BAAsBA,CAAS;AAAA,IAAA;AAAA,IAyB/B,OAtBY,MAAM;AAClB,MAAKb,EAAS,YACdA,EAAS,QAAQ,MAAA,GACjBN,EAAW,EAAK;AAAA,IAAA;AAAA,IAoBhB,MAAAe;AAAA,IACA,SAAAhB;AAAA,IACA,WAnBgB,CAACqB,MAAkB;AACnC,UAAI,CAACd,EAAS,QAAS;AACvB,YAAMe,IAAY,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGD,CAAK,CAAC;AAChD,MAAAd,EAAS,QAAQ,SAASe,GAC1BlB,EAAiBkB,CAAS;AAAA,IAAA;AAAA,IAgB1B,QAAAnB;AAAA,IACA,oBAdyB,CAACkB,MAAkB;AAC5C,UAAI,CAACd,EAAS,QAAS;AACvB,YAAMgB,IAAU,KAAK,IAAI,KAAK,KAAK,IAAI,GAAGF,CAAK,CAAC;AAChD,MAAAd,EAAS,QAAQ,eAAegB,GAChCjB,EAAgBiB,CAAO;AAAA,IAAA;AAAA,IAWvB,cAAAlB;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useAudio.mjs","names":[],"sources":["../../../../src/hooks/useAudio/useAudio.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** Type sprite map */\nexport interface SpriteMap {\n  /** [start time in seconds, end time in seconds] */\n  [key: string]: [number, number];\n}\n\n/** Type use audio options */\nexport interface UseAudioOptions {\n  /** Whether audio playback is initially enabled */\n  immediately?: boolean;\n  /** Whether to stop current playback when starting a new one */\n  interrupt?: boolean;\n  /** Initial playback speed (0.5 to 2) */\n  playbackRate?: number;\n  /** Map of named audio segments for sprite-based playback */\n  sprite?: SpriteMap;\n  /** Initial volume level (0 to 1) */\n  volume?: number;\n}\n\n/** Type use audio return type */\nexport interface UseAudioReturn {\n  /** Current playback speed (0.5 to 2) */\n  playbackRate: number;\n  /** Whether audio is currently playing */\n  playing: boolean;\n  /** Current volume level (0 to 1) */\n  volume: number;\n  /** Set playback speed (0.5 to 2) */\n  changePlaybackRate: (value: number) => void;\n  /** Pause audio playback at current position */\n  pause: () => void;\n  /** Start audio playback from the beginning or specified sprite segment */\n  play: (sprite?: string) => Promise<void>;\n  /** Set audio volume level (0 to 1) */\n  setVolume: (value: number) => void;\n  /** Stop audio playback and reset position to start */\n  stop: () => void;\n}\n\n/**\n * @name useAudio\n * @description - Hook that manages audio playback with sprite support\n * @category Browser\n * @usage low\n\n * @browserapi Audio https://developer.mozilla.org/en-US/docs/Web/API/Audio\n *\n * @template Value The type of the value\n * @param {string} url The URL of the audio file to play\n * @param {UseAudioOptions} [options] Audio configuration options\n * @param {number} [options.volume=1] Initial volume level (0 to 1)\n * @param {number} [options.playbackRate=1] Initial playback speed (0.5 to 2)\n * @param {boolean} [options.interrupt=false] Whether to stop current playback when starting a new one\n * @param {boolean} [options.soundEnabled=true] Whether audio playback is initially enabled\n * @param {SpriteMap} [options.sprite] Map of named audio segments for sprite-based playback\n * @returns {UseAudioReturn} An object containing audio controls and state\n *\n * @example\n * const audio = useAudio(\"/path/to/sound.mp3\");\n */\nexport const useAudio = (src: string, options: UseAudioOptions = {}): UseAudioReturn => {\n  const [playing, setPlaying] = useState(false);\n  const [volume, setCurrentVolume] = useState(options.volume ?? 1);\n  const [playbackRate, setPlaybackRate] = useState(options.playbackRate ?? 1);\n\n  const audioRef = useRef<HTMLAudioElement | null>(null);\n\n  useEffect(() => {\n    const audio = new Audio(src);\n\n    audio.volume = volume;\n    audio.playbackRate = playbackRate;\n    audioRef.current = audio;\n\n    if (options.immediately) {\n      try {\n        setPlaying(true);\n        audio.play();\n      } catch {\n        setPlaying(false);\n      }\n    }\n\n    const onPlay = () => setPlaying(true);\n    const onPause = () => setPlaying(false);\n    const onEnded = () => setPlaying(false);\n    const onVolumeChange = () => setCurrentVolume(audio.volume);\n    const onRateChange = () => setPlaybackRate(audio.playbackRate);\n\n    audio.addEventListener('play', onPlay);\n    audio.addEventListener('pause', onPause);\n    audio.addEventListener('ended', onEnded);\n    audio.addEventListener('volumechange', onVolumeChange);\n    audio.addEventListener('ratechange', onRateChange);\n\n    return () => {\n      audio.removeEventListener('play', onPlay);\n      audio.removeEventListener('pause', onPause);\n      audio.removeEventListener('ended', onEnded);\n      audio.removeEventListener('volumechange', onVolumeChange);\n      audio.removeEventListener('ratechange', onRateChange);\n\n      audio.pause();\n      audio.remove();\n    };\n  }, [src]);\n\n  const stop = () => {\n    if (!audioRef.current) return;\n    audioRef.current.pause();\n    audioRef.current.currentTime = 0;\n    setPlaying(false);\n  };\n\n  const play = async (spriteName?: string) => {\n    if (!audioRef.current) return;\n    if (options.interrupt) stop();\n\n    setPlaying(true);\n\n    if (!spriteName || !options.sprite?.[spriteName]) {\n      await audioRef.current.play();\n      return;\n    }\n\n    const [start, end] = options.sprite[spriteName];\n    audioRef.current.currentTime = start;\n    await audioRef.current.play();\n\n    const checkTime = () => {\n      if (!audioRef.current) return;\n      if (audioRef.current.currentTime >= end) {\n        stop();\n      }\n\n      if (!playing) return;\n\n      requestAnimationFrame(checkTime);\n    };\n\n    requestAnimationFrame(checkTime);\n  };\n\n  const pause = () => {\n    if (!audioRef.current) return;\n    audioRef.current.pause();\n    setPlaying(false);\n  };\n\n  const setVolume = (value: number) => {\n    if (!audioRef.current) return;\n    const newVolume = Math.max(0, Math.min(1, value));\n    audioRef.current.volume = newVolume;\n    setCurrentVolume(newVolume);\n  };\n\n  const changePlaybackRate = (value: number) => {\n    if (!audioRef.current) return;\n    const newRate = Math.max(0.5, Math.min(2, value));\n    audioRef.current.playbackRate = newRate;\n    setPlaybackRate(newRate);\n  };\n\n  return {\n    play,\n    pause,\n    stop,\n    playing,\n    setVolume,\n    volume,\n    changePlaybackRate,\n    playbackRate\n  };\n};\n"],"mappings":";;AA+DA,IAAa,KAAY,GAAa,IAA2B,EAAE,KAAqB;CACtF,IAAM,CAAC,GAAS,KAAc,EAAS,GAAM,EACvC,CAAC,GAAQ,KAAoB,EAAS,EAAQ,UAAU,EAAE,EAC1D,CAAC,GAAc,KAAmB,EAAS,EAAQ,gBAAgB,EAAE,EAErE,IAAW,EAAgC,KAAK;AAEtD,SAAgB;EACd,IAAM,IAAQ,IAAI,MAAM,EAAI;AAM5B,MAJA,EAAM,SAAS,GACf,EAAM,eAAe,GACrB,EAAS,UAAU,GAEf,EAAQ,YACV,KAAI;AAEF,GADA,EAAW,GAAK,EAChB,EAAM,MAAM;UACN;AACN,KAAW,GAAM;;EAIrB,IAAM,UAAe,EAAW,GAAK,EAC/B,UAAgB,EAAW,GAAM,EACjC,UAAgB,EAAW,GAAM,EACjC,UAAuB,EAAiB,EAAM,OAAO,EACrD,UAAqB,EAAgB,EAAM,aAAa;AAQ9D,SANA,EAAM,iBAAiB,QAAQ,EAAO,EACtC,EAAM,iBAAiB,SAAS,EAAQ,EACxC,EAAM,iBAAiB,SAAS,EAAQ,EACxC,EAAM,iBAAiB,gBAAgB,EAAe,EACtD,EAAM,iBAAiB,cAAc,EAAa,QAErC;AAQX,GAPA,EAAM,oBAAoB,QAAQ,EAAO,EACzC,EAAM,oBAAoB,SAAS,EAAQ,EAC3C,EAAM,oBAAoB,SAAS,EAAQ,EAC3C,EAAM,oBAAoB,gBAAgB,EAAe,EACzD,EAAM,oBAAoB,cAAc,EAAa,EAErD,EAAM,OAAO,EACb,EAAM,QAAQ;;IAEf,CAAC,EAAI,CAAC;CAET,IAAM,UAAa;AACZ,IAAS,YACd,EAAS,QAAQ,OAAO,EACxB,EAAS,QAAQ,cAAc,GAC/B,EAAW,GAAM;;AAoDnB,QAAO;EACL,MAlDW,OAAO,MAAwB;AAC1C,OAAI,CAAC,EAAS,QAAS;AAKvB,OAJI,EAAQ,aAAW,GAAM,EAE7B,EAAW,GAAK,EAEZ,CAAC,KAAc,CAAC,EAAQ,SAAS,IAAa;AAChD,UAAM,EAAS,QAAQ,MAAM;AAC7B;;GAGF,IAAM,CAAC,GAAO,KAAO,EAAQ,OAAO;AAEpC,GADA,EAAS,QAAQ,cAAc,GAC/B,MAAM,EAAS,QAAQ,MAAM;GAE7B,IAAM,UAAkB;AACjB,MAAS,YACV,EAAS,QAAQ,eAAe,KAClC,GAAM,EAGH,KAEL,sBAAsB,EAAU;;AAGlC,yBAAsB,EAAU;;EAyBhC,aAtBkB;AACb,KAAS,YACd,EAAS,QAAQ,OAAO,EACxB,EAAW,GAAM;;EAoBjB;EACA;EACA,YAnBiB,MAAkB;AACnC,OAAI,CAAC,EAAS,QAAS;GACvB,IAAM,IAAY,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,EAAM,CAAC;AAEjD,GADA,EAAS,QAAQ,SAAS,GAC1B,EAAiB,EAAU;;EAgB3B;EACA,qBAd0B,MAAkB;AAC5C,OAAI,CAAC,EAAS,QAAS;GACvB,IAAM,IAAU,KAAK,IAAI,IAAK,KAAK,IAAI,GAAG,EAAM,CAAC;AAEjD,GADA,EAAS,QAAQ,eAAe,GAChC,EAAgB,EAAQ;;EAWxB;EACD"}

package/dist/esm/hooks/useAutoScroll/useAutoScroll.mjs

@@ -1,41 +1,44 @@
-import { useRef as b, useEffect as p } from "react";
-import { useRefState as R } from "../useRefState/useRefState.mjs";
-import { isTarget as a } from "../../utils/helpers/isTarget.mjs";
-const x = ((...n) => {
-  const r = a(n[0]) ? n[0] : void 0, i = n[1] || (typeof n[0] == "object" ? n[0] : {}), { enabled: h = !0 } = i, s = R(), o = b(i);
-  if (o.current = i, p(() => {
-    if (!h || !r && !s.state) return;
-    const e = r ? a.getElement(r) : s.state;
-    if (!e) return;
-    let c = !0, f = 0, d = 0;
-    const v = () => {
-      if (o.current.force) return;
-      const { scrollHeight: t, clientHeight: l, scrollTop: u } = e, L = t - l, Y = L / 2;
-      u < d ? c = !1 : L - u <= Y && (c = !0), d = u;
-    }, m = (t) => {
-      o.current.force || (t.deltaY < 0 ? c = !1 : v());
-    }, E = (t) => {
-      o.current.force || (f = t.touches[0].clientY);
-    }, g = (t) => {
-      if (o.current.force) return;
-      const l = t.touches[0].clientY;
-      f - l < 0 ? c = !1 : v(), f = l;
-    }, T = () => {
-      !c && !o.current.force || e.scrollTo({ top: e.scrollHeight });
-    };
-    e.addEventListener("wheel", m), e.addEventListener("touchstart", E), e.addEventListener("touchmove", g);
-    const S = new MutationObserver(T);
-    return S.observe(e, {
-      childList: !0,
-      subtree: !0,
-      characterData: !0
-    }), () => {
-      S.disconnect(), e.removeEventListener("wheel", m), e.removeEventListener("touchstart", E), e.removeEventListener("touchmove", g);
-    };
-  }, [h, r && a.getRawElement(r), s.state]), !r)
-    return { ref: s };
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useRef as r } from "react";
+//#region src/hooks/useAutoScroll/useAutoScroll.ts
+var i = ((...i) => {
+	let a = e(i[0]) ? i[0] : void 0, o = i[1] || (typeof i[0] == "object" ? i[0] : {}), { enabled: s = !0 } = o, c = t(), l = r(o);
+	if (l.current = o, n(() => {
+		if (!s || !a && !c.state) return;
+		let t = a ? e.getElement(a) : c.state;
+		if (!t) return;
+		let n = !0, r = 0, i = 0, o = () => {
+			if (l.current.force) return;
+			let { scrollHeight: e, clientHeight: r, scrollTop: a } = t, o = e - r, s = o / 2;
+			a < i ? n = !1 : o - a <= s && (n = !0), i = a;
+		}, u = (e) => {
+			l.current.force || (e.deltaY < 0 ? n = !1 : o());
+		}, d = (e) => {
+			l.current.force || (r = e.touches[0].clientY);
+		}, f = (e) => {
+			if (l.current.force) return;
+			let t = e.touches[0].clientY;
+			r - t < 0 ? n = !1 : o(), r = t;
+		}, p = () => {
+			!n && !l.current.force || t.scrollTo({ top: t.scrollHeight });
+		};
+		t.addEventListener("wheel", u), t.addEventListener("touchstart", d), t.addEventListener("touchmove", f);
+		let m = new MutationObserver(p);
+		return m.observe(t, {
+			childList: !0,
+			subtree: !0,
+			characterData: !0
+		}), () => {
+			m.disconnect(), t.removeEventListener("wheel", u), t.removeEventListener("touchstart", d), t.removeEventListener("touchmove", f);
+		};
+	}, [
+		s,
+		a && e.getRawElement(a),
+		c.state
+	]), !a) return { ref: c };
 });
-export {
-  x as useAutoScroll
-};
-//# sourceMappingURL=useAutoScroll.mjs.map
+//#endregion
+export { i as useAutoScroll };
+
+//# sourceMappingURL=useAutoScroll.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAutoScroll.mjs","sources":["../../../../src/hooks/useAutoScroll/useAutoScroll.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use auto scroll options type */\nexport interface UseAutoScrollOptions {\n  /** Whether auto-scrolling is enabled */\n  enabled?: boolean;\n  /** Whether to force auto-scrolling regardless of user interactions */\n  force?: boolean;\n}\n\nexport interface UseAutoScroll {\n  (target: HookTarget, options?: UseAutoScrollOptions): void;\n\n  <Target extends HTMLElement>(\n    options?: UseAutoScrollOptions\n  ): {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useAutoScroll\n * @description - Hook that automatically scrolls a list element to the bottom\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {HookTarget} target The target element to auto-scroll\n * @param {boolean} [options.enabled] Whether auto-scrolling is enabled\n * @returns {void}\n *\n * @example\n * useAutoScroll(ref);\n *\n * @overload\n * @template Target\n * @param {boolean} [options.enabled] Whether auto-scrolling is enabled\n * @returns {{ ref: StateRef<Target> }} A React ref to attach to the list element\n *\n * @example\n * const { ref } = useAutoScroll();\n */\nexport const useAutoScroll = ((...params: any[]) => {\n  const target = isTarget(params[0]) ? params[0] : undefined;\n  const options = (params[1] ||\n    (typeof params[0] === 'object' ? params[0] : {})) as UseAutoScrollOptions;\n  const { enabled = true } = options;\n\n  const internalRef = useRefState<HTMLElement>();\n  const internalOptionsRef = useRef<UseAutoScrollOptions>(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n\n    const element = (target ? isTarget.getElement(target) : internalRef.state) as HTMLElement;\n\n    if (!element) return;\n\n    let shouldAutoScroll = true;\n    let touchStartY = 0;\n    let lastScrollTop = 0;\n\n    const onCheckScrollPosition = () => {\n      if (internalOptionsRef.current.force) return;\n\n      const { scrollHeight, clientHeight, scrollTop } = element;\n      const maxScrollHeight = scrollHeight - clientHeight;\n      const scrollThreshold = maxScrollHeight / 2;\n\n      if (scrollTop < lastScrollTop) shouldAutoScroll = false;\n      else if (maxScrollHeight - scrollTop <= scrollThreshold) shouldAutoScroll = true;\n\n      lastScrollTop = scrollTop;\n    };\n\n    const onWheel = (event: WheelEvent) => {\n      if (internalOptionsRef.current.force) return;\n\n      if (event.deltaY < 0) shouldAutoScroll = false;\n      else onCheckScrollPosition();\n    };\n\n    const onTouchStart = (event: TouchEvent) => {\n      if (internalOptionsRef.current.force) return;\n      touchStartY = event.touches[0].clientY;\n    };\n\n    const onTouchMove = (event: TouchEvent) => {\n      if (internalOptionsRef.current.force) return;\n\n      const touchEndY = event.touches[0].clientY;\n      const deltaY = touchStartY - touchEndY;\n\n      if (deltaY < 0) shouldAutoScroll = false;\n      else onCheckScrollPosition();\n\n      touchStartY = touchEndY;\n    };\n\n    const onMutation = () => {\n      if (!shouldAutoScroll && !internalOptionsRef.current.force) return;\n      element.scrollTo({ top: element.scrollHeight });\n    };\n\n    element.addEventListener('wheel', onWheel);\n    element.addEventListener('touchstart', onTouchStart);\n    element.addEventListener('touchmove', onTouchMove);\n\n    const observer = new MutationObserver(onMutation);\n\n    observer.observe(element, {\n      childList: true,\n      subtree: true,\n      characterData: true\n    });\n\n    return () => {\n      observer.disconnect();\n      element.removeEventListener('wheel', onWheel);\n      element.removeEventListener('touchstart', onTouchStart);\n      element.removeEventListener('touchmove', onTouchMove);\n    };\n  }, [enabled, target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return;\n  return { ref: internalRef };\n}) as UseAutoScroll;\n"],"names":["useAutoScroll","params","target","isTarget","options","enabled","internalRef","useRefState","internalOptionsRef","useRef","useEffect","element","shouldAutoScroll","touchStartY","lastScrollTop","onCheckScrollPosition","scrollHeight","clientHeight","scrollTop","maxScrollHeight","scrollThreshold","onWheel","event","onTouchStart","onTouchMove","touchEndY","onMutation","observer"],"mappings":";;;AAkDO,MAAMA,KAAiB,IAAIC,MAAkB;AAClD,QAAMC,IAASC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC3CG,IAAWH,EAAO,CAAC,MACtB,OAAOA,EAAO,CAAC,KAAM,WAAWA,EAAO,CAAC,IAAI,CAAA,IACzC,EAAE,SAAAI,IAAU,GAAA,IAASD,GAErBE,IAAcC,EAAA,GACdC,IAAqBC,EAA6BL,CAAO;AA4E/D,MA3EAI,EAAmB,UAAUJ,GAE7BM,EAAU,MAAM;AACd,QAAI,CAACL,KAAY,CAACH,KAAU,CAACI,EAAY,MAAQ;AAEjD,UAAMK,IAAWT,IAASC,EAAS,WAAWD,CAAM,IAAII,EAAY;AAEpE,QAAI,CAACK,EAAS;AAEd,QAAIC,IAAmB,IACnBC,IAAc,GACdC,IAAgB;AAEpB,UAAMC,IAAwB,MAAM;AAClC,UAAIP,EAAmB,QAAQ,MAAO;AAEtC,YAAM,EAAE,cAAAQ,GAAc,cAAAC,GAAc,WAAAC,EAAA,IAAcP,GAC5CQ,IAAkBH,IAAeC,GACjCG,IAAkBD,IAAkB;AAE1C,MAAID,IAAYJ,IAAeF,IAAmB,KACzCO,IAAkBD,KAAaE,MAAiBR,IAAmB,KAE5EE,IAAgBI;AAAA,IAAA,GAGZG,IAAU,CAACC,MAAsB;AACrC,MAAId,EAAmB,QAAQ,UAE3Bc,EAAM,SAAS,IAAGV,IAAmB,KACpCG,EAAA;AAAA,IAAsB,GAGvBQ,IAAe,CAACD,MAAsB;AAC1C,MAAId,EAAmB,QAAQ,UAC/BK,IAAcS,EAAM,QAAQ,CAAC,EAAE;AAAA,IAAA,GAG3BE,IAAc,CAACF,MAAsB;AACzC,UAAId,EAAmB,QAAQ,MAAO;AAEtC,YAAMiB,IAAYH,EAAM,QAAQ,CAAC,EAAE;AAGnC,MAFeT,IAAcY,IAEhB,IAAGb,IAAmB,KAC9BG,EAAA,GAELF,IAAcY;AAAA,IAAA,GAGVC,IAAa,MAAM;AACvB,MAAI,CAACd,KAAoB,CAACJ,EAAmB,QAAQ,SACrDG,EAAQ,SAAS,EAAE,KAAKA,EAAQ,cAAc;AAAA,IAAA;AAGhD,IAAAA,EAAQ,iBAAiB,SAASU,CAAO,GACzCV,EAAQ,iBAAiB,cAAcY,CAAY,GACnDZ,EAAQ,iBAAiB,aAAaa,CAAW;AAEjD,UAAMG,IAAW,IAAI,iBAAiBD,CAAU;AAEhD,WAAAC,EAAS,QAAQhB,GAAS;AAAA,MACxB,WAAW;AAAA,MACX,SAAS;AAAA,MACT,eAAe;AAAA,IAAA,CAChB,GAEM,MAAM;AACX,MAAAgB,EAAS,WAAA,GACThB,EAAQ,oBAAoB,SAASU,CAAO,GAC5CV,EAAQ,oBAAoB,cAAcY,CAAY,GACtDZ,EAAQ,oBAAoB,aAAaa,CAAW;AAAA,IAAA;AAAA,EACtD,GACC,CAACnB,GAASH,KAAUC,EAAS,cAAcD,CAAM,GAAGI,EAAY,KAAK,CAAC,GAErE,CAAAJ;AACJ,WAAO,EAAE,KAAKI,EAAA;AAChB;"}
+{"version":3,"file":"useAutoScroll.mjs","names":[],"sources":["../../../../src/hooks/useAutoScroll/useAutoScroll.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The use auto scroll options type */\nexport interface UseAutoScrollOptions {\n  /** Whether auto-scrolling is enabled */\n  enabled?: boolean;\n  /** Whether to force auto-scrolling regardless of user interactions */\n  force?: boolean;\n}\n\nexport interface UseAutoScroll {\n  (target: HookTarget, options?: UseAutoScrollOptions): void;\n\n  <Target extends HTMLElement>(\n    options?: UseAutoScrollOptions\n  ): {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useAutoScroll\n * @description - Hook that automatically scrolls a list element to the bottom\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {HookTarget} target The target element to auto-scroll\n * @param {boolean} [options.enabled] Whether auto-scrolling is enabled\n * @returns {void}\n *\n * @example\n * useAutoScroll(ref);\n *\n * @overload\n * @template Target\n * @param {boolean} [options.enabled] Whether auto-scrolling is enabled\n * @returns {{ ref: StateRef<Target> }} A React ref to attach to the list element\n *\n * @example\n * const { ref } = useAutoScroll();\n */\nexport const useAutoScroll = ((...params: any[]) => {\n  const target = isTarget(params[0]) ? params[0] : undefined;\n  const options = (params[1] ||\n    (typeof params[0] === 'object' ? params[0] : {})) as UseAutoScrollOptions;\n  const { enabled = true } = options;\n\n  const internalRef = useRefState<HTMLElement>();\n  const internalOptionsRef = useRef<UseAutoScrollOptions>(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n\n    const element = (target ? isTarget.getElement(target) : internalRef.state) as HTMLElement;\n\n    if (!element) return;\n\n    let shouldAutoScroll = true;\n    let touchStartY = 0;\n    let lastScrollTop = 0;\n\n    const onCheckScrollPosition = () => {\n      if (internalOptionsRef.current.force) return;\n\n      const { scrollHeight, clientHeight, scrollTop } = element;\n      const maxScrollHeight = scrollHeight - clientHeight;\n      const scrollThreshold = maxScrollHeight / 2;\n\n      if (scrollTop < lastScrollTop) shouldAutoScroll = false;\n      else if (maxScrollHeight - scrollTop <= scrollThreshold) shouldAutoScroll = true;\n\n      lastScrollTop = scrollTop;\n    };\n\n    const onWheel = (event: WheelEvent) => {\n      if (internalOptionsRef.current.force) return;\n\n      if (event.deltaY < 0) shouldAutoScroll = false;\n      else onCheckScrollPosition();\n    };\n\n    const onTouchStart = (event: TouchEvent) => {\n      if (internalOptionsRef.current.force) return;\n      touchStartY = event.touches[0].clientY;\n    };\n\n    const onTouchMove = (event: TouchEvent) => {\n      if (internalOptionsRef.current.force) return;\n\n      const touchEndY = event.touches[0].clientY;\n      const deltaY = touchStartY - touchEndY;\n\n      if (deltaY < 0) shouldAutoScroll = false;\n      else onCheckScrollPosition();\n\n      touchStartY = touchEndY;\n    };\n\n    const onMutation = () => {\n      if (!shouldAutoScroll && !internalOptionsRef.current.force) return;\n      element.scrollTo({ top: element.scrollHeight });\n    };\n\n    element.addEventListener('wheel', onWheel);\n    element.addEventListener('touchstart', onTouchStart);\n    element.addEventListener('touchmove', onTouchMove);\n\n    const observer = new MutationObserver(onMutation);\n\n    observer.observe(element, {\n      childList: true,\n      subtree: true,\n      characterData: true\n    });\n\n    return () => {\n      observer.disconnect();\n      element.removeEventListener('wheel', onWheel);\n      element.removeEventListener('touchstart', onTouchStart);\n      element.removeEventListener('touchmove', onTouchMove);\n    };\n  }, [enabled, target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return;\n  return { ref: internalRef };\n}) as UseAutoScroll;\n"],"mappings":";;;;AAkDA,IAAa,MAAkB,GAAG,MAAkB;CAClD,IAAM,IAAS,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAC3C,IAAW,EAAO,OACrB,OAAO,EAAO,MAAO,WAAW,EAAO,KAAK,EAAE,GAC3C,EAAE,aAAU,OAAS,GAErB,IAAc,GAA0B,EACxC,IAAqB,EAA6B,EAAQ;AAChE,OAAmB,UAAU,GAE7B,QAAgB;AACd,MAAI,CAAC,KAAY,CAAC,KAAU,CAAC,EAAY,MAAQ;EAEjD,IAAM,IAAW,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AAEpE,MAAI,CAAC,EAAS;EAEd,IAAI,IAAmB,IACnB,IAAc,GACd,IAAgB,GAEd,UAA8B;AAClC,OAAI,EAAmB,QAAQ,MAAO;GAEtC,IAAM,EAAE,iBAAc,iBAAc,iBAAc,GAC5C,IAAkB,IAAe,GACjC,IAAkB,IAAkB;AAK1C,GAHI,IAAY,IAAe,IAAmB,KACzC,IAAkB,KAAa,MAAiB,IAAmB,KAE5E,IAAgB;KAGZ,KAAW,MAAsB;AACjC,KAAmB,QAAQ,UAE3B,EAAM,SAAS,IAAG,IAAmB,KACpC,GAAuB;KAGxB,KAAgB,MAAsB;AACtC,KAAmB,QAAQ,UAC/B,IAAc,EAAM,QAAQ,GAAG;KAG3B,KAAe,MAAsB;AACzC,OAAI,EAAmB,QAAQ,MAAO;GAEtC,IAAM,IAAY,EAAM,QAAQ,GAAG;AAMnC,GALe,IAAc,IAEhB,IAAG,IAAmB,KAC9B,GAAuB,EAE5B,IAAc;KAGV,UAAmB;AACnB,IAAC,KAAoB,CAAC,EAAmB,QAAQ,SACrD,EAAQ,SAAS,EAAE,KAAK,EAAQ,cAAc,CAAC;;AAKjD,EAFA,EAAQ,iBAAiB,SAAS,EAAQ,EAC1C,EAAQ,iBAAiB,cAAc,EAAa,EACpD,EAAQ,iBAAiB,aAAa,EAAY;EAElD,IAAM,IAAW,IAAI,iBAAiB,EAAW;AAQjD,SANA,EAAS,QAAQ,GAAS;GACxB,WAAW;GACX,SAAS;GACT,eAAe;GAChB,CAAC,QAEW;AAIX,GAHA,EAAS,YAAY,EACrB,EAAQ,oBAAoB,SAAS,EAAQ,EAC7C,EAAQ,oBAAoB,cAAc,EAAa,EACvD,EAAQ,oBAAoB,aAAa,EAAY;;IAEtD;EAAC;EAAS,KAAU,EAAS,cAAc,EAAO;EAAE,EAAY;EAAM,CAAC,EAEtE,GACJ,QAAO,EAAE,KAAK,GAAa"}