@siberiacancode/reactuse 0.3.15 → 0.3.17

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

@@ -1 +1 @@
-{"version":3,"file":"useRenderInfo.mjs","sources":["../../../../src/hooks/useRenderInfo/useRenderInfo.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/** The use render info return type */\nexport interface UseRenderInfoReturn {\n  /** The name of the component */\n  component: string;\n  /** The number of renders */\n  renders: number;\n  /** The time since the last render */\n  sinceLast: number;\n  /** The timestamp of the render */\n  timestamp: number | null;\n}\n\n/**\n * @name useRenderInfo\n * @description - Hook for getting information about component rerender\n * @category Debug\n * @usage low\n *\n * @param {string} [name='Unknown'] Component name\n * @param {boolean} [log=true] Toggle logging\n * @returns {UseRenderInfoReturn} An object containing rerender information\n *\n * @example\n * const rerenderInfo = useRenderInfo('Component');\n */\nexport const useRenderInfo = (name: string = 'Unknown', log: boolean = true) => {\n  const renderInfoRef = useRef<UseRenderInfoReturn>({\n    component: name,\n    renders: 0,\n    timestamp: Date.now(),\n    sinceLast: 0\n  });\n  const now = Date.now();\n\n  renderInfoRef.current.renders += 1;\n  renderInfoRef.current.sinceLast = renderInfoRef.current.timestamp\n    ? now - renderInfoRef.current.timestamp\n    : 0;\n  renderInfoRef.current.timestamp = now;\n\n  if (log) {\n    console.group(`${name} info, render number: ${renderInfoRef.current.renders}`);\n    console.log(`Timestamp: ${renderInfoRef.current.timestamp}`);\n    console.log(`Since last render: ${renderInfoRef.current.sinceLast}`);\n    console.log(`Renders: ${renderInfoRef.current.renders}`);\n    console.dir(renderInfoRef.current);\n    console.groupEnd();\n  }\n\n  return renderInfoRef.current;\n};\n"],"names":["useRenderInfo","name","log","renderInfoRef","useRef","now"],"mappings":";AA2BO,MAAMA,IAAgB,CAACC,IAAe,WAAWC,IAAe,OAAS;AAC9E,QAAMC,IAAgBC,EAA4B;AAAA,IAChD,WAAWH;AAAA,IACX,SAAS;AAAA,IACT,WAAW,KAAK,IAAA;AAAA,IAChB,WAAW;AAAA,EAAA,CACZ,GACKI,IAAM,KAAK,IAAA;AAEjB,SAAAF,EAAc,QAAQ,WAAW,GACjCA,EAAc,QAAQ,YAAYA,EAAc,QAAQ,YACpDE,IAAMF,EAAc,QAAQ,YAC5B,GACJA,EAAc,QAAQ,YAAYE,GAE9BH,MACF,QAAQ,MAAM,GAAGD,CAAI,yBAAyBE,EAAc,QAAQ,OAAO,EAAE,GAC7E,QAAQ,IAAI,cAAcA,EAAc,QAAQ,SAAS,EAAE,GAC3D,QAAQ,IAAI,sBAAsBA,EAAc,QAAQ,SAAS,EAAE,GACnE,QAAQ,IAAI,YAAYA,EAAc,QAAQ,OAAO,EAAE,GACvD,QAAQ,IAAIA,EAAc,OAAO,GACjC,QAAQ,SAAA,IAGHA,EAAc;AACvB;"}
+{"version":3,"file":"useRenderInfo.mjs","names":[],"sources":["../../../../src/hooks/useRenderInfo/useRenderInfo.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/** The use render info return type */\nexport interface UseRenderInfoReturn {\n  /** The name of the component */\n  component: string;\n  /** The number of renders */\n  renders: number;\n  /** The time since the last render */\n  sinceLast: number;\n  /** The timestamp of the render */\n  timestamp: number | null;\n}\n\n/**\n * @name useRenderInfo\n * @description - Hook for getting information about component rerender\n * @category Debug\n * @usage low\n *\n * @param {string} [name='Unknown'] Component name\n * @param {boolean} [log=true] Toggle logging\n * @returns {UseRenderInfoReturn} An object containing rerender information\n *\n * @example\n * const rerenderInfo = useRenderInfo('Component');\n */\nexport const useRenderInfo = (name: string = 'Unknown', log: boolean = true) => {\n  const renderInfoRef = useRef<UseRenderInfoReturn>({\n    component: name,\n    renders: 0,\n    timestamp: Date.now(),\n    sinceLast: 0\n  });\n  const now = Date.now();\n\n  renderInfoRef.current.renders += 1;\n  renderInfoRef.current.sinceLast = renderInfoRef.current.timestamp\n    ? now - renderInfoRef.current.timestamp\n    : 0;\n  renderInfoRef.current.timestamp = now;\n\n  if (log) {\n    console.group(`${name} info, render number: ${renderInfoRef.current.renders}`);\n    console.log(`Timestamp: ${renderInfoRef.current.timestamp}`);\n    console.log(`Since last render: ${renderInfoRef.current.sinceLast}`);\n    console.log(`Renders: ${renderInfoRef.current.renders}`);\n    console.dir(renderInfoRef.current);\n    console.groupEnd();\n  }\n\n  return renderInfoRef.current;\n};\n"],"mappings":";;AA2BA,IAAa,KAAiB,IAAe,WAAW,IAAe,OAAS;CAC9E,IAAM,IAAgB,EAA4B;EAChD,WAAW;EACX,SAAS;EACT,WAAW,KAAK,KAAK;EACrB,WAAW;EACZ,CAAC,EACI,IAAM,KAAK,KAAK;AAiBtB,QAfA,EAAc,QAAQ,WAAW,GACjC,EAAc,QAAQ,YAAY,EAAc,QAAQ,YACpD,IAAM,EAAc,QAAQ,YAC5B,GACJ,EAAc,QAAQ,YAAY,GAE9B,MACF,QAAQ,MAAM,GAAG,EAAK,wBAAwB,EAAc,QAAQ,UAAU,EAC9E,QAAQ,IAAI,cAAc,EAAc,QAAQ,YAAY,EAC5D,QAAQ,IAAI,sBAAsB,EAAc,QAAQ,YAAY,EACpE,QAAQ,IAAI,YAAY,EAAc,QAAQ,UAAU,EACxD,QAAQ,IAAI,EAAc,QAAQ,EAClC,QAAQ,UAAU,GAGb,EAAc"}

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

@@ -1,6 +1,7 @@
 import { useReducer as e } from "react";
-const o = () => e(() => ({}), {})[1];
-export {
-  o as useRerender
-};
-//# sourceMappingURL=useRerender.mjs.map
+//#region src/hooks/useRerender/useRerender.ts
+var t = () => e(() => ({}), {})[1];
+//#endregion
+export { t as useRerender };
+
+//# sourceMappingURL=useRerender.mjs.map

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

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

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

@@ -1,25 +1,34 @@
-import { useState as v, useRef as C, useEffect as E } from "react";
-import { useRefState as h } from "../useRefState/useRefState.mjs";
-import { isTarget as s } from "../../utils/helpers/isTarget.mjs";
-const k = ((...e) => {
-  const t = s(e[0]) ? e[0] : void 0, n = t ? typeof e[1] == "object" ? e[1] : { onChange: e[1] } : typeof e[0] == "object" ? e[0] : { onChange: e[0] }, c = n?.onChange, f = n?.enabled ?? !0, [i, R] = v(), [u, a] = v(), r = h(), b = C(c);
-  return b.current = c, E(() => {
-    if (!f || !t && !r.state) return;
-    const l = t ? s.getElement(t) : r.current;
-    if (!l) return;
-    const o = new ResizeObserver(([g], d) => {
-      R(g), b.current?.(g, d);
-    });
-    return a(o), o.observe(l, n), () => {
-      o.disconnect();
-    };
-  }, [t && s.getRawElement(t), r.state, n?.box, f]), t ? { entry: i, observer: u } : {
-    ref: r,
-    entry: i,
-    observer: u
-  };
+import { isTarget as e } from "../../utils/helpers/isTarget.mjs";
+import { useRefState as t } from "../useRefState/useRefState.mjs";
+import { useEffect as n, useRef as r, useState as i } from "react";
+//#region src/hooks/useResizeObserver/useResizeObserver.ts
+var a = ((...a) => {
+	let o = e(a[0]) ? a[0] : void 0, s = o ? typeof a[1] == "object" ? a[1] : { onChange: a[1] } : typeof a[0] == "object" ? a[0] : { onChange: a[0] }, c = s?.onChange, l = s?.enabled ?? !0, [u, d] = i(), [f, p] = i(), m = t(), h = r(c);
+	return h.current = c, n(() => {
+		if (!l || !o && !m.state) return;
+		let t = o ? e.getElement(o) : m.current;
+		if (!t) return;
+		let n = new ResizeObserver(([e], t) => {
+			d(e), h.current?.(e, t);
+		});
+		return p(n), n.observe(t, s), () => {
+			n.disconnect();
+		};
+	}, [
+		o && e.getRawElement(o),
+		m.state,
+		s?.box,
+		l
+	]), o ? {
+		entry: u,
+		observer: f
+	} : {
+		ref: m,
+		entry: u,
+		observer: f
+	};
 });
-export {
-  k as useResizeObserver
-};
-//# sourceMappingURL=useResizeObserver.mjs.map
+//#endregion
+export { a as useResizeObserver };
+
+//# sourceMappingURL=useResizeObserver.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useResizeObserver.mjs","sources":["../../../../src/hooks/useResizeObserver/useResizeObserver.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The resize observer callback type */\nexport type UseResizeObserverCallback = (\n  entry: ResizeObserverEntry,\n  observer: ResizeObserver\n) => void;\n\n/** The resize observer options type */\nexport interface UseResizeObserverOptions extends ResizeObserverOptions {\n  /** The enabled state of the resize observer */\n  enabled?: boolean;\n  /** The callback to execute when resize is detected */\n  onChange?: UseResizeObserverCallback;\n}\n\n/** The resize observer return type */\nexport interface UseResizeObserverReturn {\n  /** The resize observer entries */\n  entry: ResizeObserverEntry;\n  /** The resize observer instance */\n  observer?: ResizeObserver;\n}\n\nexport interface UseResizeObserver {\n  <Target extends Element>(\n    options?: UseResizeObserverOptions,\n    target?: never\n  ): UseResizeObserverReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, options?: UseResizeObserverOptions): UseResizeObserverReturn;\n\n  <Target extends Element>(\n    callback: UseResizeObserverCallback,\n    target?: never\n  ): UseResizeObserverReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, callback: UseResizeObserverCallback): UseResizeObserverReturn;\n}\n\n/**\n * @name useResizeObserver\n * @description - Hook that gives you resize observer state\n * @category Sensors\n * @usage low\n *\n * @browserapi ResizeObserver https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver\n *\n * @overload\n * @param {HookTarget} target The target element to observe\n * @param {boolean} [options.enabled=true] The enabled state of the resize observer\n * @param {ResizeObserverBoxOptions} [options.box] The box model to observe\n * @param {UseResizeObserverCallback} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n *\n * @example\n * const { entries, observer } = useResizeObserver(ref);\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The enabled state of the resize observer\n * @param {ResizeObserverBoxOptions} [options.box] The box model to observe\n * @param {UseResizeObserverCallback} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { ref, entry, observer } = useResizeObserver();\n *\n * @overload\n * @template Target The target element\n * @param {UseResizeObserverCallback} callback The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { ref, entry, observer } = useResizeObserver((entry) => console.log(entry));\n *\n * @overload\n * @param {HookTarget} target The target element to observe\n * @param {UseResizeObserverCallback} callback The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n *\n * @example\n * const { entry, observer } = useResizeObserver(ref, (entry) => console.log(entry));\n */\nexport const useResizeObserver = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onChange: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onChange: params[0] }\n  ) as UseResizeObserverOptions | undefined;\n\n  const callback = options?.onChange;\n  const enabled = options?.enabled ?? true;\n\n  const [entry, setEntry] = useState<ResizeObserverEntry>();\n  const [observer, setObserver] = useState<ResizeObserver>();\n\n  const internalRef = useRefState<Element>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const observer = new ResizeObserver(([entry], observer) => {\n      setEntry(entry);\n      internalCallbackRef.current?.(entry, observer);\n    });\n\n    setObserver(observer);\n    observer.observe(element as Element, options);\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state, options?.box, enabled]);\n\n  if (target) return { entry, observer };\n  return {\n    ref: internalRef,\n    entry,\n    observer\n  };\n}) as UseResizeObserver;\n"],"names":["useResizeObserver","params","target","isTarget","options","callback","enabled","entry","setEntry","useState","observer","setObserver","internalRef","useRefState","internalCallbackRef","useRef","useEffect","element"],"mappings":";;;AA4FO,MAAMA,KAAqB,IAAIC,MAAkB;AACtD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAE5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,IACtB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,GAGtBI,IAAWD,GAAS,UACpBE,IAAUF,GAAS,WAAW,IAE9B,CAACG,GAAOC,CAAQ,IAAIC,EAAA,GACpB,CAACC,GAAUC,CAAW,IAAIF,EAAA,GAE1BG,IAAcC,EAAA,GACdC,IAAsBC,EAAOV,CAAQ;AAsB3C,SArBAS,EAAoB,UAAUT,GAE9BW,EAAU,MAAM;AACd,QAAI,CAACV,KAAY,CAACJ,KAAU,CAACU,EAAY,MAAQ;AAEjD,UAAMK,IAAUf,IAASC,EAAS,WAAWD,CAAM,IAAIU,EAAY;AACnE,QAAI,CAACK,EAAS;AAEd,UAAMP,IAAW,IAAI,eAAe,CAAC,CAACH,CAAK,GAAGG,MAAa;AACzD,MAAAF,EAASD,CAAK,GACdO,EAAoB,UAAUP,GAAOG,CAAQ;AAAA,IAAA,CAC9C;AAED,WAAAC,EAAYD,CAAQ,GACpBA,EAAS,QAAQO,GAAoBb,CAAO,GAErC,MAAM;AACXM,MAAAA,EAAS,WAAA;AAAA,IAAW;AAAA,EACtB,GACC,CAACR,KAAUC,EAAS,cAAcD,CAAM,GAAGU,EAAY,OAAOR,GAAS,KAAKE,CAAO,CAAC,GAEnFJ,IAAe,EAAE,OAAAK,GAAO,UAAAG,EAAA,IACrB;AAAA,IACL,KAAKE;AAAA,IACL,OAAAL;AAAA,IACA,UAAAG;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useResizeObserver.mjs","names":[],"sources":["../../../../src/hooks/useResizeObserver/useResizeObserver.ts"],"sourcesContent":["import { useEffect, useRef, 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 resize observer callback type */\nexport type UseResizeObserverCallback = (\n  entry: ResizeObserverEntry,\n  observer: ResizeObserver\n) => void;\n\n/** The resize observer options type */\nexport interface UseResizeObserverOptions extends ResizeObserverOptions {\n  /** The enabled state of the resize observer */\n  enabled?: boolean;\n  /** The callback to execute when resize is detected */\n  onChange?: UseResizeObserverCallback;\n}\n\n/** The resize observer return type */\nexport interface UseResizeObserverReturn {\n  /** The resize observer entries */\n  entry: ResizeObserverEntry;\n  /** The resize observer instance */\n  observer?: ResizeObserver;\n}\n\nexport interface UseResizeObserver {\n  <Target extends Element>(\n    options?: UseResizeObserverOptions,\n    target?: never\n  ): UseResizeObserverReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, options?: UseResizeObserverOptions): UseResizeObserverReturn;\n\n  <Target extends Element>(\n    callback: UseResizeObserverCallback,\n    target?: never\n  ): UseResizeObserverReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, callback: UseResizeObserverCallback): UseResizeObserverReturn;\n}\n\n/**\n * @name useResizeObserver\n * @description - Hook that gives you resize observer state\n * @category Sensors\n * @usage low\n *\n * @browserapi ResizeObserver https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver\n *\n * @overload\n * @param {HookTarget} target The target element to observe\n * @param {boolean} [options.enabled=true] The enabled state of the resize observer\n * @param {ResizeObserverBoxOptions} [options.box] The box model to observe\n * @param {UseResizeObserverCallback} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n *\n * @example\n * const { entries, observer } = useResizeObserver(ref);\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The enabled state of the resize observer\n * @param {ResizeObserverBoxOptions} [options.box] The box model to observe\n * @param {UseResizeObserverCallback} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { ref, entry, observer } = useResizeObserver();\n *\n * @overload\n * @template Target The target element\n * @param {UseResizeObserverCallback} callback The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { ref, entry, observer } = useResizeObserver((entry) => console.log(entry));\n *\n * @overload\n * @param {HookTarget} target The target element to observe\n * @param {UseResizeObserverCallback} callback The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n *\n * @example\n * const { entry, observer } = useResizeObserver(ref, (entry) => console.log(entry));\n */\nexport const useResizeObserver = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onChange: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onChange: params[0] }\n  ) as UseResizeObserverOptions | undefined;\n\n  const callback = options?.onChange;\n  const enabled = options?.enabled ?? true;\n\n  const [entry, setEntry] = useState<ResizeObserverEntry>();\n  const [observer, setObserver] = useState<ResizeObserver>();\n\n  const internalRef = useRefState<Element>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const observer = new ResizeObserver(([entry], observer) => {\n      setEntry(entry);\n      internalCallbackRef.current?.(entry, observer);\n    });\n\n    setObserver(observer);\n    observer.observe(element as Element, options);\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state, options?.box, enabled]);\n\n  if (target) return { entry, observer };\n  return {\n    ref: internalRef,\n    entry,\n    observer\n  };\n}) as UseResizeObserver;\n"],"mappings":";;;;AA4FA,IAAa,MAAsB,GAAG,MAAkB;CACtD,IAAM,IAAU,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAE5C,IACJ,IACI,OAAO,EAAO,MAAO,WACnB,EAAO,KACP,EAAE,UAAU,EAAO,IAAI,GACzB,OAAO,EAAO,MAAO,WACnB,EAAO,KACP,EAAE,UAAU,EAAO,IAAI,EAGzB,IAAW,GAAS,UACpB,IAAU,GAAS,WAAW,IAE9B,CAAC,GAAO,KAAY,GAA+B,EACnD,CAAC,GAAU,KAAe,GAA0B,EAEpD,IAAc,GAAsB,EACpC,IAAsB,EAAO,EAAS;AAuB5C,QAtBA,EAAoB,UAAU,GAE9B,QAAgB;AACd,MAAI,CAAC,KAAY,CAAC,KAAU,CAAC,EAAY,MAAQ;EAEjD,IAAM,IAAU,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACnE,MAAI,CAAC,EAAS;EAEd,IAAM,IAAW,IAAI,gBAAgB,CAAC,IAAQ,MAAa;AAEzD,GADA,EAAS,EAAM,EACf,EAAoB,UAAU,GAAO,EAAS;IAC9C;AAKF,SAHA,EAAY,EAAS,EACrB,EAAS,QAAQ,GAAoB,EAAQ,QAEhC;AACX,KAAS,YAAY;;IAEtB;EAAC,KAAU,EAAS,cAAc,EAAO;EAAE,EAAY;EAAO,GAAS;EAAK;EAAQ,CAAC,EAEpF,IAAe;EAAE;EAAO;EAAU,GAC/B;EACL,KAAK;EACL;EACA;EACD"}

package/dist/esm/hooks/useRightClick/useRightClick.mjs

@@ -1,35 +1,38 @@
-import { useRef as h, useEffect as m } from "react";
-import { useRefState as v } from "../useRefState/useRefState.mjs";
-import { isTarget as i } from "../../utils/helpers/isTarget.mjs";
-const g = ((...r) => {
-  const e = i(r[0]) ? r[0] : void 0, l = e ? r[1] : r[0], f = e ? r[2] : r[1], c = v(), s = h(l);
-  s.current = l;
-  const u = h(f);
-  if (u.current = f, m(() => {
-    if (!e && !c.state) return;
-    const n = e ? i.getElement(e) : c.current;
-    if (!n) return;
-    const a = (t) => {
-      t.preventDefault(), u.current?.onStart?.(t);
-      const o = t;
-      s.current({ x: o.clientX, y: o.clientY }, t);
-    }, E = (t) => {
-      t.preventDefault(), u.current?.onStart?.(t);
-      const o = t;
-      s.current(
-        { x: o.touches[0].clientX, y: o.touches[0].clientY },
-        t
-      );
-    }, d = (t) => {
-      t.preventDefault(), u.current?.onEnd?.(t);
-    };
-    return n.addEventListener("contextmenu", a), n.addEventListener("touchstart", E), n.addEventListener("touchend", d), () => {
-      n.removeEventListener("contextmenu", a), n.removeEventListener("touchstart", E), n.removeEventListener("touchend", d);
-    };
-  }, [e && i.getRawElement(e), c.state]), !e)
-    return c;
+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/useRightClick/useRightClick.ts
+var i = ((...i) => {
+	let a = e(i[0]) ? i[0] : void 0, o = a ? i[1] : i[0], s = a ? i[2] : i[1], c = t(), l = r(o);
+	l.current = o;
+	let u = r(s);
+	if (u.current = s, n(() => {
+		if (!a && !c.state) return;
+		let t = a ? e.getElement(a) : c.current;
+		if (!t) return;
+		let n = (e) => {
+			e.preventDefault(), u.current?.onStart?.(e);
+			let t = e;
+			l.current({
+				x: t.clientX,
+				y: t.clientY
+			}, e);
+		}, r = (e) => {
+			e.preventDefault(), u.current?.onStart?.(e);
+			let t = e;
+			l.current({
+				x: t.touches[0].clientX,
+				y: t.touches[0].clientY
+			}, e);
+		}, i = (e) => {
+			e.preventDefault(), u.current?.onEnd?.(e);
+		};
+		return t.addEventListener("contextmenu", n), t.addEventListener("touchstart", r), t.addEventListener("touchend", i), () => {
+			t.removeEventListener("contextmenu", n), t.removeEventListener("touchstart", r), t.removeEventListener("touchend", i);
+		};
+	}, [a && e.getRawElement(a), c.state]), !a) return c;
 });
-export {
-  g as useRightClick
-};
-//# sourceMappingURL=useRightClick.mjs.map
+//#endregion
+export { i as useRightClick };
+
+//# sourceMappingURL=useRightClick.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"useRightClick.mjs","sources":["../../../../src/hooks/useRightClick/useRightClick.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\nexport type RightClickEvent = MouseEvent | TouchEvent;\nexport interface RightClickPositions {\n  x: number;\n  y: number;\n}\n\nexport interface UseRightClickOptions {\n  // * The callback function to be invoked on right click end\n  onEnd?: (event: RightClickEvent) => void;\n  // * The callback function to be invoked on right click start\n  onStart?: (event: RightClickEvent) => void;\n}\n\nexport interface UseRightClick {\n  (target: HookTarget, callback: (event: Event) => void, options?: UseRightClickOptions): void;\n\n  <Target extends Element>(\n    callback: (positions: RightClickPositions, event: Event) => void,\n    options?: UseRightClickOptions,\n    target?: never\n  ): StateRef<Target>;\n}\n\n/**\n * @name useRightClick\n * @description - Hook that handles right-click events and long press on mobile devices\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {HookTarget} target The target element for right-click handling\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {void}\n *\n * @example\n * useRightClick(ref, () => console.log('clicked'));\n *\n * @overload\n * @template Target The target element\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {StateRef<Target>} Ref to attach to the element\n *\n * @example\n * const ref = useRightClick(() => console.log('clicked'));\n */\nexport const useRightClick = ((...params: any[]): any => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const callback = (target ? params[1] : params[0]) as (\n    positions: RightClickPositions,\n    event: RightClickEvent\n  ) => void;\n  const options = (target ? params[2] : params[1]) as UseRightClickOptions;\n\n  const internalRef = useRefState<Element>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const onContextMenu = (event: RightClickEvent) => {\n      event.preventDefault();\n      internalOptionsRef.current?.onStart?.(event);\n      const mouseEvent = event as MouseEvent;\n      internalCallbackRef.current({ x: mouseEvent.clientX, y: mouseEvent.clientY }, event);\n    };\n\n    const onTouchStart = (event: RightClickEvent) => {\n      event.preventDefault();\n      internalOptionsRef.current?.onStart?.(event);\n      const touchEvent = event as TouchEvent;\n      internalCallbackRef.current(\n        { x: touchEvent.touches[0].clientX, y: touchEvent.touches[0].clientY },\n        event\n      );\n    };\n\n    const onTouchEnd = (event: RightClickEvent) => {\n      event.preventDefault();\n      internalOptionsRef.current?.onEnd?.(event);\n    };\n\n    element.addEventListener('contextmenu', onContextMenu as EventListener);\n\n    element.addEventListener('touchstart', onTouchStart as EventListener);\n    element.addEventListener('touchend', onTouchEnd as EventListener);\n\n    return () => {\n      element.removeEventListener('contextmenu', onContextMenu as EventListener);\n\n      element.removeEventListener('touchstart', onTouchStart as EventListener);\n      element.removeEventListener('touchend', onTouchEnd as EventListener);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return;\n  return internalRef;\n}) as UseRightClick;\n"],"names":["useRightClick","params","target","isTarget","callback","options","internalRef","useRefState","internalCallbackRef","useRef","internalOptionsRef","useEffect","element","onContextMenu","event","mouseEvent","onTouchStart","touchEvent","onTouchEnd"],"mappings":";;;AAuDO,MAAMA,KAAiB,IAAIC,MAAuB;AACvD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAYF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAIzCI,IAAWH,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GAExCK,IAAcC,EAAA,GACdC,IAAsBC,EAAOL,CAAQ;AAC3C,EAAAI,EAAoB,UAAUJ;AAC9B,QAAMM,IAAqBD,EAAOJ,CAAO;AA4CzC,MA3CAK,EAAmB,UAAUL,GAE7BM,EAAU,MAAM;AACd,QAAI,CAACT,KAAU,CAACI,EAAY,MAAO;AAEnC,UAAMM,IAAUV,IAASC,EAAS,WAAWD,CAAM,IAAII,EAAY;AACnE,QAAI,CAACM,EAAS;AAEd,UAAMC,IAAgB,CAACC,MAA2B;AAChD,MAAAA,EAAM,eAAA,GACNJ,EAAmB,SAAS,UAAUI,CAAK;AAC3C,YAAMC,IAAaD;AACnB,MAAAN,EAAoB,QAAQ,EAAE,GAAGO,EAAW,SAAS,GAAGA,EAAW,QAAA,GAAWD,CAAK;AAAA,IAAA,GAG/EE,IAAe,CAACF,MAA2B;AAC/C,MAAAA,EAAM,eAAA,GACNJ,EAAmB,SAAS,UAAUI,CAAK;AAC3C,YAAMG,IAAaH;AACnB,MAAAN,EAAoB;AAAA,QAClB,EAAE,GAAGS,EAAW,QAAQ,CAAC,EAAE,SAAS,GAAGA,EAAW,QAAQ,CAAC,EAAE,QAAA;AAAA,QAC7DH;AAAA,MAAA;AAAA,IACF,GAGII,IAAa,CAACJ,MAA2B;AAC7C,MAAAA,EAAM,eAAA,GACNJ,EAAmB,SAAS,QAAQI,CAAK;AAAA,IAAA;AAG3C,WAAAF,EAAQ,iBAAiB,eAAeC,CAA8B,GAEtED,EAAQ,iBAAiB,cAAcI,CAA6B,GACpEJ,EAAQ,iBAAiB,YAAYM,CAA2B,GAEzD,MAAM;AACX,MAAAN,EAAQ,oBAAoB,eAAeC,CAA8B,GAEzED,EAAQ,oBAAoB,cAAcI,CAA6B,GACvEJ,EAAQ,oBAAoB,YAAYM,CAA2B;AAAA,IAAA;AAAA,EACrE,GACC,CAAChB,KAAUC,EAAS,cAAcD,CAAM,GAAGI,EAAY,KAAK,CAAC,GAE5D,CAAAJ;AACJ,WAAOI;AACT;"}
+{"version":3,"file":"useRightClick.mjs","names":[],"sources":["../../../../src/hooks/useRightClick/useRightClick.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\nexport type RightClickEvent = MouseEvent | TouchEvent;\nexport interface RightClickPositions {\n  x: number;\n  y: number;\n}\n\nexport interface UseRightClickOptions {\n  // * The callback function to be invoked on right click end\n  onEnd?: (event: RightClickEvent) => void;\n  // * The callback function to be invoked on right click start\n  onStart?: (event: RightClickEvent) => void;\n}\n\nexport interface UseRightClick {\n  (target: HookTarget, callback: (event: Event) => void, options?: UseRightClickOptions): void;\n\n  <Target extends Element>(\n    callback: (positions: RightClickPositions, event: Event) => void,\n    options?: UseRightClickOptions,\n    target?: never\n  ): StateRef<Target>;\n}\n\n/**\n * @name useRightClick\n * @description - Hook that handles right-click events and long press on mobile devices\n * @category Elements\n * @usage low\n *\n * @overload\n * @param {HookTarget} target The target element for right-click handling\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {void}\n *\n * @example\n * useRightClick(ref, () => console.log('clicked'));\n *\n * @overload\n * @template Target The target element\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {StateRef<Target>} Ref to attach to the element\n *\n * @example\n * const ref = useRightClick(() => console.log('clicked'));\n */\nexport const useRightClick = ((...params: any[]): any => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const callback = (target ? params[1] : params[0]) as (\n    positions: RightClickPositions,\n    event: RightClickEvent\n  ) => void;\n  const options = (target ? params[2] : params[1]) as UseRightClickOptions;\n\n  const internalRef = useRefState<Element>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const onContextMenu = (event: RightClickEvent) => {\n      event.preventDefault();\n      internalOptionsRef.current?.onStart?.(event);\n      const mouseEvent = event as MouseEvent;\n      internalCallbackRef.current({ x: mouseEvent.clientX, y: mouseEvent.clientY }, event);\n    };\n\n    const onTouchStart = (event: RightClickEvent) => {\n      event.preventDefault();\n      internalOptionsRef.current?.onStart?.(event);\n      const touchEvent = event as TouchEvent;\n      internalCallbackRef.current(\n        { x: touchEvent.touches[0].clientX, y: touchEvent.touches[0].clientY },\n        event\n      );\n    };\n\n    const onTouchEnd = (event: RightClickEvent) => {\n      event.preventDefault();\n      internalOptionsRef.current?.onEnd?.(event);\n    };\n\n    element.addEventListener('contextmenu', onContextMenu as EventListener);\n\n    element.addEventListener('touchstart', onTouchStart as EventListener);\n    element.addEventListener('touchend', onTouchEnd as EventListener);\n\n    return () => {\n      element.removeEventListener('contextmenu', onContextMenu as EventListener);\n\n      element.removeEventListener('touchstart', onTouchStart as EventListener);\n      element.removeEventListener('touchend', onTouchEnd as EventListener);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state]);\n\n  if (target) return;\n  return internalRef;\n}) as UseRightClick;\n"],"mappings":";;;;AAuDA,IAAa,MAAkB,GAAG,MAAuB;CACvD,IAAM,IAAU,EAAS,EAAO,GAAG,GAAG,EAAO,KAAK,KAAA,GAC5C,IAAY,IAAS,EAAO,KAAK,EAAO,IAIxC,IAAW,IAAS,EAAO,KAAK,EAAO,IAEvC,IAAc,GAAsB,EACpC,IAAsB,EAAO,EAAS;AAC5C,GAAoB,UAAU;CAC9B,IAAM,IAAqB,EAAO,EAAQ;AAC1C,OAAmB,UAAU,GAE7B,QAAgB;AACd,MAAI,CAAC,KAAU,CAAC,EAAY,MAAO;EAEnC,IAAM,IAAU,IAAS,EAAS,WAAW,EAAO,GAAG,EAAY;AACnE,MAAI,CAAC,EAAS;EAEd,IAAM,KAAiB,MAA2B;AAEhD,GADA,EAAM,gBAAgB,EACtB,EAAmB,SAAS,UAAU,EAAM;GAC5C,IAAM,IAAa;AACnB,KAAoB,QAAQ;IAAE,GAAG,EAAW;IAAS,GAAG,EAAW;IAAS,EAAE,EAAM;KAGhF,KAAgB,MAA2B;AAE/C,GADA,EAAM,gBAAgB,EACtB,EAAmB,SAAS,UAAU,EAAM;GAC5C,IAAM,IAAa;AACnB,KAAoB,QAClB;IAAE,GAAG,EAAW,QAAQ,GAAG;IAAS,GAAG,EAAW,QAAQ,GAAG;IAAS,EACtE,EACD;KAGG,KAAc,MAA2B;AAE7C,GADA,EAAM,gBAAgB,EACtB,EAAmB,SAAS,QAAQ,EAAM;;AAQ5C,SALA,EAAQ,iBAAiB,eAAe,EAA+B,EAEvE,EAAQ,iBAAiB,cAAc,EAA8B,EACrE,EAAQ,iBAAiB,YAAY,EAA4B,QAEpD;AAIX,GAHA,EAAQ,oBAAoB,eAAe,EAA+B,EAE1E,EAAQ,oBAAoB,cAAc,EAA8B,EACxE,EAAQ,oBAAoB,YAAY,EAA4B;;IAErE,CAAC,KAAU,EAAS,cAAc,EAAO,EAAE,EAAY,MAAM,CAAC,EAE7D,GACJ,QAAO"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"useScript.mjs","sources":["../../../../src/hooks/useScript/useScript.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/** The use script status */\nexport type UseScriptStatus = 'error' | 'loading' | 'ready' | 'unknown';\nexport const SCRIPT_STATUS_ATTRIBUTE_NAME = 'script-status';\n\n/** The use script options extends from attributes script tag */\nexport interface UseScriptOptions extends ComponentProps<'script'> {\n  /** Whether to remove the script on unmount */\n  removeOnUnmount?: boolean;\n}\n\n/**\n * @name useScript\n * @description - Hook that manages a script with onLoad, onError, and removeOnUnmount functionalities\n * @category Elements\n * @usage low\n *\n * @param {string} src The source of the script\n * @param {UseScriptOptions} [options] The options of the script extends from attributes script tag\n * @param {boolean} [options.removeOnUnmount=true] Whether to remove the script on unmount\n * @param {boolean} [options.async=true] Whether to load the script asynchronously\n * @returns {UseScriptStatus} The status of the script\n *\n * @example\n * const status = useScript('https://example.com/script.js');\n */\nexport const useScript = (src: string, options: UseScriptOptions = {}) => {\n  const [status, setStatus] = useState<UseScriptStatus>(() => {\n    const script = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n    const scriptStatus = script?.getAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME) as UseScriptStatus;\n    if (scriptStatus) return scriptStatus;\n    if (script) return 'unknown';\n\n    return 'loading';\n  });\n  const { removeOnUnmount = true, async = true } = options;\n\n  useEffect(() => {\n    const existedScript = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n    const scriptStatus = existedScript?.getAttribute(\n      SCRIPT_STATUS_ATTRIBUTE_NAME\n    ) as UseScriptStatus;\n    if (scriptStatus) return setStatus(scriptStatus);\n    if (existedScript) return setStatus('unknown');\n\n    const script = document.createElement('script');\n    script.src = src;\n    script.async = async;\n\n    for (const [key, value] of Object.entries(options)) {\n      script.setAttribute(key, String(value));\n    }\n\n    script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'loading');\n    document.body.appendChild(script);\n\n    const onLoad = () => {\n      script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'ready');\n      setStatus('ready');\n    };\n\n    const onError = () => {\n      script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'error');\n      setStatus('error');\n    };\n\n    script.addEventListener('load', onLoad);\n    script.addEventListener('error', onError);\n\n    return () => {\n      if (removeOnUnmount) script.remove();\n      script.removeEventListener('load', onLoad);\n      script.removeEventListener('error', onError);\n    };\n  }, [src, removeOnUnmount]);\n\n  return status;\n};\n"],"names":["SCRIPT_STATUS_ATTRIBUTE_NAME","useScript","src","options","status","setStatus","useState","script","scriptStatus","removeOnUnmount","async","useEffect","existedScript","key","value","onLoad","onError"],"mappings":";AAMO,MAAMA,IAA+B,iBAuB/BC,IAAY,CAACC,GAAaC,IAA4B,OAAO;AACxE,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAA0B,MAAM;AAC1D,UAAMC,IAAS,SAAS,cAAc,eAAeL,CAAG,IAAI,GACtDM,IAAeD,GAAQ,aAAaP,CAA4B;AACtE,WAAIQ,MACAD,IAAe,YAEZ;AAAA,EAAA,CACR,GACK,EAAE,iBAAAE,IAAkB,IAAM,OAAAC,IAAQ,OAASP;AAEjD,SAAAQ,EAAU,MAAM;AACd,UAAMC,IAAgB,SAAS,cAAc,eAAeV,CAAG,IAAI,GAC7DM,IAAeI,GAAe;AAAA,MAClCZ;AAAA,IAAA;AAEF,QAAIQ,EAAc,QAAOH,EAAUG,CAAY;AAC/C,QAAII,EAAe,QAAOP,EAAU,SAAS;AAE7C,UAAME,IAAS,SAAS,cAAc,QAAQ;AAC9C,IAAAA,EAAO,MAAML,GACbK,EAAO,QAAQG;AAEf,eAAW,CAACG,GAAKC,CAAK,KAAK,OAAO,QAAQX,CAAO;AAC/C,MAAAI,EAAO,aAAaM,GAAK,OAAOC,CAAK,CAAC;AAGxC,IAAAP,EAAO,aAAaP,GAA8B,SAAS,GAC3D,SAAS,KAAK,YAAYO,CAAM;AAEhC,UAAMQ,IAAS,MAAM;AACnB,MAAAR,EAAO,aAAaP,GAA8B,OAAO,GACzDK,EAAU,OAAO;AAAA,IAAA,GAGbW,IAAU,MAAM;AACpB,MAAAT,EAAO,aAAaP,GAA8B,OAAO,GACzDK,EAAU,OAAO;AAAA,IAAA;AAGnB,WAAAE,EAAO,iBAAiB,QAAQQ,CAAM,GACtCR,EAAO,iBAAiB,SAASS,CAAO,GAEjC,MAAM;AACX,MAAIP,OAAwB,OAAA,GAC5BF,EAAO,oBAAoB,QAAQQ,CAAM,GACzCR,EAAO,oBAAoB,SAASS,CAAO;AAAA,IAAA;AAAA,EAC7C,GACC,CAACd,GAAKO,CAAe,CAAC,GAElBL;AACT;"}
+{"version":3,"file":"useScript.mjs","names":[],"sources":["../../../../src/hooks/useScript/useScript.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/** The use script status */\nexport type UseScriptStatus = 'error' | 'loading' | 'ready' | 'unknown';\nexport const SCRIPT_STATUS_ATTRIBUTE_NAME = 'script-status';\n\n/** The use script options extends from attributes script tag */\nexport interface UseScriptOptions extends ComponentProps<'script'> {\n  /** Whether to remove the script on unmount */\n  removeOnUnmount?: boolean;\n}\n\n/**\n * @name useScript\n * @description - Hook that manages a script with onLoad, onError, and removeOnUnmount functionalities\n * @category Elements\n * @usage low\n *\n * @param {string} src The source of the script\n * @param {UseScriptOptions} [options] The options of the script extends from attributes script tag\n * @param {boolean} [options.removeOnUnmount=true] Whether to remove the script on unmount\n * @param {boolean} [options.async=true] Whether to load the script asynchronously\n * @returns {UseScriptStatus} The status of the script\n *\n * @example\n * const status = useScript('https://example.com/script.js');\n */\nexport const useScript = (src: string, options: UseScriptOptions = {}) => {\n  const [status, setStatus] = useState<UseScriptStatus>(() => {\n    const script = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n    const scriptStatus = script?.getAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME) as UseScriptStatus;\n    if (scriptStatus) return scriptStatus;\n    if (script) return 'unknown';\n\n    return 'loading';\n  });\n  const { removeOnUnmount = true, async = true } = options;\n\n  useEffect(() => {\n    const existedScript = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n    const scriptStatus = existedScript?.getAttribute(\n      SCRIPT_STATUS_ATTRIBUTE_NAME\n    ) as UseScriptStatus;\n    if (scriptStatus) return setStatus(scriptStatus);\n    if (existedScript) return setStatus('unknown');\n\n    const script = document.createElement('script');\n    script.src = src;\n    script.async = async;\n\n    for (const [key, value] of Object.entries(options)) {\n      script.setAttribute(key, String(value));\n    }\n\n    script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'loading');\n    document.body.appendChild(script);\n\n    const onLoad = () => {\n      script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'ready');\n      setStatus('ready');\n    };\n\n    const onError = () => {\n      script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'error');\n      setStatus('error');\n    };\n\n    script.addEventListener('load', onLoad);\n    script.addEventListener('error', onError);\n\n    return () => {\n      if (removeOnUnmount) script.remove();\n      script.removeEventListener('load', onLoad);\n      script.removeEventListener('error', onError);\n    };\n  }, [src, removeOnUnmount]);\n\n  return status;\n};\n"],"mappings":";;AAMA,IAAa,IAA+B,iBAuB/B,KAAa,GAAa,IAA4B,EAAE,KAAK;CACxE,IAAM,CAAC,GAAQ,KAAa,QAAgC;EAC1D,IAAM,IAAS,SAAS,cAAc,eAAe,EAAI,IAAI;AAK7D,SAJqB,GAAQ,aAAa,EAA6B,KAEnE,IAAe,YAEZ;GACP,EACI,EAAE,qBAAkB,IAAM,WAAQ,OAAS;AAyCjD,QAvCA,QAAgB;EACd,IAAM,IAAgB,SAAS,cAAc,eAAe,EAAI,IAAI,EAC9D,IAAe,GAAe,aAClC,EACD;AACD,MAAI,EAAc,QAAO,EAAU,EAAa;AAChD,MAAI,EAAe,QAAO,EAAU,UAAU;EAE9C,IAAM,IAAS,SAAS,cAAc,SAAS;AAE/C,EADA,EAAO,MAAM,GACb,EAAO,QAAQ;AAEf,OAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,EAAQ,CAChD,GAAO,aAAa,GAAK,OAAO,EAAM,CAAC;AAIzC,EADA,EAAO,aAAa,GAA8B,UAAU,EAC5D,SAAS,KAAK,YAAY,EAAO;EAEjC,IAAM,UAAe;AAEnB,GADA,EAAO,aAAa,GAA8B,QAAQ,EAC1D,EAAU,QAAQ;KAGd,UAAgB;AAEpB,GADA,EAAO,aAAa,GAA8B,QAAQ,EAC1D,EAAU,QAAQ;;AAMpB,SAHA,EAAO,iBAAiB,QAAQ,EAAO,EACvC,EAAO,iBAAiB,SAAS,EAAQ,QAE5B;AAGX,GAFI,KAAiB,EAAO,QAAQ,EACpC,EAAO,oBAAoB,QAAQ,EAAO,EAC1C,EAAO,oBAAoB,SAAS,EAAQ;;IAE7C,CAAC,GAAK,EAAgB,CAAC,EAEnB"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"useScroll.mjs","sources":["../../../../src/hooks/useScroll/useScroll.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';\nimport { useRerender } from '../useRerender/useRerender';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n}\n\nexport interface UseScrollCallbackParams {\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n}\n\n/** The scroll into view params type */\nexport interface ScrollIntoViewParams {\n  behavior?: ScrollBehavior;\n  block?: ScrollLogicalPosition;\n  inline?: ScrollLogicalPosition;\n}\n/** The scroll to params type */\nexport interface ScrollToParams {\n  behavior?: ScrollBehavior;\n  x: number;\n  y: number;\n}\n\n/** The use scroll return type */\nexport interface UseScrollReturn {\n  /** The latest scroll value snapshot */\n  snapshot: UseScrollCallbackParams;\n  /** Function to scroll element into view */\n  scrollIntoView: (params?: ScrollIntoViewParams) => void;\n  /** Function to scroll element to a specific position */\n  scrollTo: (params?: ScrollToParams) => void;\n  /** Function to enable subscriptions and rerender on next updates */\n  watch: () => UseScrollCallbackParams;\n}\n\nexport interface UseScroll {\n  (\n    target?: HookTarget,\n    callback?: (params: UseScrollCallbackParams, event: Event) => void\n  ): UseScrollReturn;\n\n  (target: HookTarget, options?: UseScrollOptions): UseScrollReturn;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): UseScrollReturn & { ref: StateRef<Target> };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): UseScrollReturn & {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n * @usage low\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} [target=window] The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'function'\n        ? { ...params[2], onScroll: params[1] }\n        : params[1]\n      : typeof params[0] === 'object'\n        ? params[0]\n        : typeof params[0] === 'function'\n          ? { ...params[1], onScroll: params[0] }\n          : undefined\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  const elementRef = useRef<Element>(null);\n  const snapshotRef = useRef<UseScrollCallbackParams>({\n    x: 0,\n    y: 0,\n    directions: {\n      left: false,\n      right: false,\n      top: false,\n      bottom: false\n    },\n    arrived: {\n      left: true,\n      right: false,\n      top: true,\n      bottom: false\n    }\n  });\n  const watchingRef = useRef(false);\n  const rerender = useRerender();\n  internalOptionsRef.current = options;\n\n  const watch = () => {\n    watchingRef.current = true;\n    return snapshotRef.current;\n  };\n  const updateValue = (value: UseScrollCallbackParams) => {\n    snapshotRef.current = value;\n    if (watchingRef.current) rerender();\n  };\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element =\n      ((target ? isTarget.getElement(target) : internalRef.current) as Element) ?? window;\n\n    elementRef.current = element;\n\n    const onScrollEnd = (event: Event) => {\n      internalOptionsRef.current?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'row-reverse';\n\n      const updatedValue: UseScrollCallbackParams = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < snapshotRef.current.x,\n          right: scrollLeft > snapshotRef.current.x,\n          top: scrollTop < snapshotRef.current.y,\n          bottom: scrollTop > snapshotRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      updateValue(updatedValue);\n      internalOptionsRef.current?.onScroll?.(updatedValue, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state]);\n\n  const scrollIntoView = (params?: {\n    behavior?: ScrollBehavior;\n    block?: ScrollLogicalPosition;\n    inline?: ScrollLogicalPosition;\n  }) => {\n    if (!elementRef.current) return;\n\n    const { behavior, block, inline } = params ?? {};\n\n    elementRef.current.scrollIntoView({\n      behavior,\n      block,\n      inline\n    });\n  };\n\n  const scrollTo = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n    if (!elementRef.current) return;\n    const { x, y, behavior } = params ?? {};\n\n    elementRef.current.scrollTo({ left: x, top: y, behavior });\n  };\n\n  if (target) return { scrollIntoView, scrollTo, snapshot: snapshotRef.current, watch };\n  return {\n    ref: internalRef,\n    snapshot: snapshotRef.current,\n    watch,\n    scrollIntoView,\n    scrollTo\n  };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","elementRef","snapshotRef","watchingRef","rerender","useRerender","watch","updateValue","value","useEffect","element","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse","updatedValue","scrollIntoView","behavior","block","inline","scrollTo","x","y"],"mappings":"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"}
+{"version":3,"file":"useScroll.mjs","names":[],"sources":["../../../../src/hooks/useScroll/useScroll.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';\nimport { useRerender } from '../useRerender/useRerender';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n}\n\nexport interface UseScrollCallbackParams {\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n}\n\n/** The scroll into view params type */\nexport interface ScrollIntoViewParams {\n  behavior?: ScrollBehavior;\n  block?: ScrollLogicalPosition;\n  inline?: ScrollLogicalPosition;\n}\n/** The scroll to params type */\nexport interface ScrollToParams {\n  behavior?: ScrollBehavior;\n  x: number;\n  y: number;\n}\n\n/** The use scroll return type */\nexport interface UseScrollReturn {\n  /** The latest scroll value snapshot */\n  snapshot: UseScrollCallbackParams;\n  /** Function to scroll element into view */\n  scrollIntoView: (params?: ScrollIntoViewParams) => void;\n  /** Function to scroll element to a specific position */\n  scrollTo: (params?: ScrollToParams) => void;\n  /** Function to enable subscriptions and rerender on next updates */\n  watch: () => UseScrollCallbackParams;\n}\n\nexport interface UseScroll {\n  (\n    target?: HookTarget,\n    callback?: (params: UseScrollCallbackParams, event: Event) => void\n  ): UseScrollReturn;\n\n  (target: HookTarget, options?: UseScrollOptions): UseScrollReturn;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): UseScrollReturn & { ref: StateRef<Target> };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): UseScrollReturn & {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n * @usage low\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} [target=window] The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'function'\n        ? { ...params[2], onScroll: params[1] }\n        : params[1]\n      : typeof params[0] === 'object'\n        ? params[0]\n        : typeof params[0] === 'function'\n          ? { ...params[1], onScroll: params[0] }\n          : undefined\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  const elementRef = useRef<Element>(null);\n  const snapshotRef = useRef<UseScrollCallbackParams>({\n    x: 0,\n    y: 0,\n    directions: {\n      left: false,\n      right: false,\n      top: false,\n      bottom: false\n    },\n    arrived: {\n      left: true,\n      right: false,\n      top: true,\n      bottom: false\n    }\n  });\n  const watchingRef = useRef(false);\n  const rerender = useRerender();\n  internalOptionsRef.current = options;\n\n  const watch = () => {\n    watchingRef.current = true;\n    return snapshotRef.current;\n  };\n  const updateValue = (value: UseScrollCallbackParams) => {\n    snapshotRef.current = value;\n    if (watchingRef.current) rerender();\n  };\n\n  useEffect(() => {\n    const element =\n      ((target ? isTarget.getElement(target) : internalRef.current) as Element) ?? window;\n\n    elementRef.current = element;\n\n    const onScrollEnd = (event: Event) => {\n      internalOptionsRef.current?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'row-reverse';\n\n      const updatedValue: UseScrollCallbackParams = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < snapshotRef.current.x,\n          right: scrollLeft > snapshotRef.current.x,\n          top: scrollTop < snapshotRef.current.y,\n          bottom: scrollTop > snapshotRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      updateValue(updatedValue);\n      internalOptionsRef.current?.onScroll?.(updatedValue, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target && isTarget.getRawElement(target), internalRef.state]);\n\n  const scrollIntoView = (params?: {\n    behavior?: ScrollBehavior;\n    block?: ScrollLogicalPosition;\n    inline?: ScrollLogicalPosition;\n  }) => {\n    if (!elementRef.current) return;\n\n    const { behavior, block, inline } = params ?? {};\n\n    elementRef.current.scrollIntoView({\n      behavior,\n      block,\n      inline\n    });\n  };\n\n  const scrollTo = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n    if (!elementRef.current) return;\n    const { x, y, behavior } = params ?? {};\n\n    elementRef.current.scrollTo({ left: x, top: y, behavior });\n  };\n\n  if (target) return { scrollIntoView, scrollTo, snapshot: snapshotRef.current, watch };\n  return {\n    ref: internalRef,\n    snapshot: snapshotRef.current,\n    watch,\n    scrollIntoView,\n    scrollTo\n  };\n}) as UseScroll;\n"],"mappings":"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"}