npm - @siberiacancode/reactuse - Versions diffs - 0.2.24 → 0.2.26 - Mend

@siberiacancode/reactuse 0.2.24 → 0.2.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (281) hide show

package/dist/esm/hooks/usePointerLock/usePointerLock.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePointerLock.mjs","sources":["../../../../src/hooks/usePointerLock/usePointerLock.ts"],"sourcesContent":["import type { MouseEvent } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/** The use pointer lock return type /\ninterface UsePointerLockReturn {\n /* The pointer lock element /\n element?: Element;\n /* Whether the pointer lock is supported /\n supported: boolean;\n /* Lock the pointer lock /\n lock: (event: MouseEvent) => void;\n /* Unlock the pointer lock /\n unlock: () => boolean;\n}\n\n/\n @name usePointerLock\n * @description - Hook that provides reactive pointer lock\n * @category ~~Sensors~~\n \n @browserapi pointerLockElement https://developer.mozilla.org/en-US/docs/Web/API/Document/pointerLockElement\n \n @returns {UsePointerLockReturn} An object containing the pointer lock element and functions to interact with the pointer lock\n \n @example\n * const { supported, lock, unlock, element } = usePointerLock();\n */\nexport const usePointerLock = (): UsePointerLockReturn => {\n const supported = typeof document !== 'undefined' && 'pointerLockElement' in document;\n const [element, setElement] = useState<Element>();\n\n useEffect(() => {\n if (!supported) return;\n\n const handlePointerLockChange = () => {\n if (!supported) return;\n\n const currentElement = document.pointerLockElement ?? element;\n\n if (currentElement && currentElement === element) {\n setElement(document.pointerLockElement as Element);\n }\n };\n const handlePointerLockError = () => {\n if (!supported) return;\n\n const currentElement = document.pointerLockElement ?? element;\n\n if (currentElement && currentElement === element) {\n const action = document.pointerLockElement ? 'release' : 'acquire';\n\n throw new Error(`Failed to ${action} pointer lock.`);\n }\n };\n\n document.addEventListener('pointerlockchange', handlePointerLockChange);\n document.addEventListener('pointerlockerror', handlePointerLockError);\n\n return () => {\n document.removeEventListener('pointerlockchange', handlePointerLockChange);\n document.removeEventListener('pointerlockerror', handlePointerLockError);\n };\n }, []);\n\n const lock = (event: MouseEvent) => {\n if (!supported) return false;\n\n if (event instanceof Event) return false;\n\n event.currentTarget.requestPointerLock();\n\n setElement(event.currentTarget);\n return true;\n };\n\n const unlock = () => {\n if (!supported) return false;\n\n if (!element) return false;\n\n document.exitPointerLock();\n setElement(undefined);\n\n return true;\n };\n\n return {\n supported,\n element,\n lock,\n unlock\n };\n};\n"],"names":["usePointerLock","supported","element","setElement","useState","useEffect","handlePointerLockChange","currentElement","handlePointerLockError","action","event"],"mappings":";AA4BO,MAAMA,IAAiB,MAA4B;AACxD,QAAMC,IAAY,OAAO,WAAa,OAAe,wBAAwB,UACvE,CAACC,GAASC,CAAU,IAAIC,EAAA;AAE9B,SAAAC,EAAU,MAAM;AACd,QAAI,CAACJ,EAAW;AAEhB,UAAMK,IAA0B,MAAM;AACpC,UAAI,CAACL,EAAW;AAEhB,YAAMM,IAAiB,SAAS,sBAAsBL;AAEtD,MAAIK,KAAkBA,MAAmBL,KACvCC,EAAW,SAAS,kBAA6B;AAAA,IACnD,GAEIK,IAAyB,MAAM;AACnC,UAAI,CAACP,EAAW;AAEhB,YAAMM,IAAiB,SAAS,sBAAsBL;AAEtD,UAAIK,KAAkBA,MAAmBL,GAAS;AAChD,cAAMO,IAAS,SAAS,qBAAqB,YAAY;AAEzD,cAAM,IAAI,MAAM,aAAaA,CAAM,gBAAgB;AAAA,MAAA;AAAA,IACrD;AAGF,oBAAS,iBAAiB,qBAAqBH,CAAuB,GACtE,SAAS,iBAAiB,oBAAoBE,CAAsB,GAE7D,MAAM;AACX,eAAS,oBAAoB,qBAAqBF,CAAuB,GACzE,SAAS,oBAAoB,oBAAoBE,CAAsB;AAAA,IAAA;AAAA,EACzE,GACC,EAAE,GAwBE;AAAA,IACL,WAAAP;AAAA,IACA,SAAAC;AAAA,IACA,MAzBW,CAACQ,MACR,CAACT,KAEDS,aAAiB,QAAc,MAEnCA,EAAM,cAAc,mBAAA,GAEpBP,EAAWO,EAAM,aAAa,GACvB;AAAA,IAkBP,QAfa,MACT,CAACT,KAED,CAACC,IAAgB,MAErB,SAAS,gBAAA,GACTC,EAAW,MAAS,GAEb;AAAA,EAOP;AAEJ;"}
1	+ {"version":3,"file":"usePointerLock.mjs","sources":["../../../../src/hooks/usePointerLock/usePointerLock.ts"],"sourcesContent":["import type { MouseEvent } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/** The use pointer lock return type /\ninterface UsePointerLockReturn {\n /* The pointer lock element /\n element?: Element;\n /* Whether the pointer lock is supported /\n supported: boolean;\n /* Lock the pointer lock /\n lock: (event: MouseEvent) => void;\n /* Unlock the pointer lock /\n unlock: () => boolean;\n}\n\n/\n @name usePointerLock\n * @description - Hook that provides reactive pointer lock\n * @category Browser\n \n @browserapi pointerLockElement https://developer.mozilla.org/en-US/docs/Web/API/Document/pointerLockElement\n \n @returns {UsePointerLockReturn} An object containing the pointer lock element and functions to interact with the pointer lock\n \n @example\n * const { supported, lock, unlock, element } = usePointerLock();\n */\nexport const usePointerLock = (): UsePointerLockReturn => {\n const supported = typeof document !== 'undefined' && 'pointerLockElement' in document;\n const [element, setElement] = useState<Element>();\n\n useEffect(() => {\n if (!supported) return;\n\n const handlePointerLockChange = () => {\n if (!supported) return;\n\n const currentElement = document.pointerLockElement ?? element;\n\n if (currentElement && currentElement === element) {\n setElement(document.pointerLockElement as Element);\n }\n };\n const handlePointerLockError = () => {\n if (!supported) return;\n\n const currentElement = document.pointerLockElement ?? element;\n\n if (currentElement && currentElement === element) {\n const action = document.pointerLockElement ? 'release' : 'acquire';\n\n throw new Error(`Failed to ${action} pointer lock.`);\n }\n };\n\n document.addEventListener('pointerlockchange', handlePointerLockChange);\n document.addEventListener('pointerlockerror', handlePointerLockError);\n\n return () => {\n document.removeEventListener('pointerlockchange', handlePointerLockChange);\n document.removeEventListener('pointerlockerror', handlePointerLockError);\n };\n }, []);\n\n const lock = (event: MouseEvent) => {\n if (!supported) return false;\n\n if (event instanceof Event) return false;\n\n event.currentTarget.requestPointerLock();\n\n setElement(event.currentTarget);\n return true;\n };\n\n const unlock = () => {\n if (!supported) return false;\n\n if (!element) return false;\n\n document.exitPointerLock();\n setElement(undefined);\n\n return true;\n };\n\n return {\n supported,\n element,\n lock,\n unlock\n };\n};\n"],"names":["usePointerLock","supported","element","setElement","useState","useEffect","handlePointerLockChange","currentElement","handlePointerLockError","action","event"],"mappings":";AA4BO,MAAMA,IAAiB,MAA4B;AACxD,QAAMC,IAAY,OAAO,WAAa,OAAe,wBAAwB,UACvE,CAACC,GAASC,CAAU,IAAIC,EAAA;AAE9B,SAAAC,EAAU,MAAM;AACd,QAAI,CAACJ,EAAW;AAEhB,UAAMK,IAA0B,MAAM;AACpC,UAAI,CAACL,EAAW;AAEhB,YAAMM,IAAiB,SAAS,sBAAsBL;AAEtD,MAAIK,KAAkBA,MAAmBL,KACvCC,EAAW,SAAS,kBAA6B;AAAA,IACnD,GAEIK,IAAyB,MAAM;AACnC,UAAI,CAACP,EAAW;AAEhB,YAAMM,IAAiB,SAAS,sBAAsBL;AAEtD,UAAIK,KAAkBA,MAAmBL,GAAS;AAChD,cAAMO,IAAS,SAAS,qBAAqB,YAAY;AAEzD,cAAM,IAAI,MAAM,aAAaA,CAAM,gBAAgB;AAAA,MAAA;AAAA,IACrD;AAGF,oBAAS,iBAAiB,qBAAqBH,CAAuB,GACtE,SAAS,iBAAiB,oBAAoBE,CAAsB,GAE7D,MAAM;AACX,eAAS,oBAAoB,qBAAqBF,CAAuB,GACzE,SAAS,oBAAoB,oBAAoBE,CAAsB;AAAA,IAAA;AAAA,EACzE,GACC,EAAE,GAwBE;AAAA,IACL,WAAAP;AAAA,IACA,SAAAC;AAAA,IACA,MAzBW,CAACQ,MACR,CAACT,KAEDS,aAAiB,QAAc,MAEnCA,EAAM,cAAc,mBAAA,GAEpBP,EAAWO,EAAM,aAAa,GACvB;AAAA,IAkBP,QAfa,MACT,CAACT,KAED,CAACC,IAAgB,MAErB,SAAS,gBAAA,GACTC,EAAW,MAAS,GAEb;AAAA,EAOP;AAEJ;"}

package/dist/esm/hooks/usePreferredColorScheme/usePreferredColorScheme.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredColorScheme.mjs","sources":["../../../../src/hooks/usePreferredColorScheme/usePreferredColorScheme.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/** The use preferred color scheme return type /\nexport type UsePreferredColorSchemeReturn = 'dark' \| 'light' \| 'no-preference';\n\n/\n @name usePreferredColorScheme\n * @description - Hook that returns user preferred color scheme\n * @category ~~Browser~~\n \n @returns {UsePreferredColorSchemeReturn} String of preferred color scheme\n \n @example\n * const colorScheme = usePreferredColorScheme();\n */\nexport const usePreferredColorScheme = (): UsePreferredColorSchemeReturn => {\n const isLight = useMediaQuery('(prefers-color-scheme: light)');\n const isDark = useMediaQuery('(prefers-color-scheme: dark)');\n\n if (isLight) return 'light';\n if (isDark) return 'dark';\n return 'no-preference';\n};\n"],"names":["usePreferredColorScheme","isLight","useMediaQuery","isDark"],"mappings":";AAeO,MAAMA,IAA0B,MAAqC;AAC1E,QAAMC,IAAUC,EAAc,+BAA+B,GACvDC,IAASD,EAAc,8BAA8B;AAE3D,SAAID,IAAgB,UAChBE,IAAe,SACZ;AACT;"}
1	+ {"version":3,"file":"usePreferredColorScheme.mjs","sources":["../../../../src/hooks/usePreferredColorScheme/usePreferredColorScheme.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/** The use preferred color scheme return type /\nexport type UsePreferredColorSchemeReturn = 'dark' \| 'light' \| 'no-preference';\n\n/\n @name usePreferredColorScheme\n * @description - Hook that returns user preferred color scheme\n * @category User\n \n @returns {UsePreferredColorSchemeReturn} String of preferred color scheme\n \n @example\n * const colorScheme = usePreferredColorScheme();\n */\nexport const usePreferredColorScheme = (): UsePreferredColorSchemeReturn => {\n const isLight = useMediaQuery('(prefers-color-scheme: light)');\n const isDark = useMediaQuery('(prefers-color-scheme: dark)');\n\n if (isLight) return 'light';\n if (isDark) return 'dark';\n return 'no-preference';\n};\n"],"names":["usePreferredColorScheme","isLight","useMediaQuery","isDark"],"mappings":";AAeO,MAAMA,IAA0B,MAAqC;AAC1E,QAAMC,IAAUC,EAAc,+BAA+B,GACvDC,IAASD,EAAc,8BAA8B;AAE3D,SAAID,IAAgB,UAChBE,IAAe,SACZ;AACT;"}

package/dist/esm/hooks/usePreferredContrast/usePreferredContrast.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredContrast.mjs","sources":["../../../../src/hooks/usePreferredContrast/usePreferredContrast.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/** The use preferred contrast return type /\nexport type UsePreferredContrastReturn = 'custom' \| 'less' \| 'more' \| 'no-preference';\n\n/\n @name usePreferredContrast\n * @description - Hook that returns the contrast preference\n * @category ~~Browser~~\n \n @returns {UsePreferredContrastReturn} The contrast preference\n \n @example\n * const contrast = usePreferredContrast();\n */\nexport const usePreferredContrast = (): UsePreferredContrastReturn => {\n const more = useMediaQuery('(prefers-contrast: more)');\n const less = useMediaQuery('(prefers-contrast: less)');\n const custom = useMediaQuery('(prefers-contrast: custom)');\n return more ? 'more' : less ? 'less' : custom ? 'custom' : 'no-preference';\n};\n"],"names":["usePreferredContrast","more","useMediaQuery","less","custom"],"mappings":";AAeO,MAAMA,IAAuB,MAAkC;AACpE,QAAMC,IAAOC,EAAc,0BAA0B,GAC/CC,IAAOD,EAAc,0BAA0B,GAC/CE,IAASF,EAAc,4BAA4B;AACzD,SAAOD,IAAO,SAASE,IAAO,SAASC,IAAS,WAAW;AAC7D;"}
1	+ {"version":3,"file":"usePreferredContrast.mjs","sources":["../../../../src/hooks/usePreferredContrast/usePreferredContrast.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/** The use preferred contrast return type /\nexport type UsePreferredContrastReturn = 'custom' \| 'less' \| 'more' \| 'no-preference';\n\n/\n @name usePreferredContrast\n * @description - Hook that returns the contrast preference\n * @category User\n \n @returns {UsePreferredContrastReturn} The contrast preference\n \n @example\n * const contrast = usePreferredContrast();\n */\nexport const usePreferredContrast = (): UsePreferredContrastReturn => {\n const more = useMediaQuery('(prefers-contrast: more)');\n const less = useMediaQuery('(prefers-contrast: less)');\n const custom = useMediaQuery('(prefers-contrast: custom)');\n return more ? 'more' : less ? 'less' : custom ? 'custom' : 'no-preference';\n};\n"],"names":["usePreferredContrast","more","useMediaQuery","less","custom"],"mappings":";AAeO,MAAMA,IAAuB,MAAkC;AACpE,QAAMC,IAAOC,EAAc,0BAA0B,GAC/CC,IAAOD,EAAc,0BAA0B,GAC/CE,IAASF,EAAc,4BAA4B;AACzD,SAAOD,IAAO,SAASE,IAAO,SAASC,IAAS,WAAW;AAC7D;"}

package/dist/esm/hooks/usePreferredDark/usePreferredDark.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredDark.mjs","sources":["../../../../src/hooks/usePreferredDark/usePreferredDark.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/*\n @name usePreferredDark\n * @description - Hook that returns if the user prefers dark mode\n * @category ~~Browser~~\n \n @example\n * const isDark = usePreferredDark();\n */\nexport const usePreferredDark = () => useMediaQuery('(prefers-color-scheme: dark)');\n"],"names":["usePreferredDark","useMediaQuery"],"mappings":";AAUO,MAAMA,IAAmB,MAAMC,EAAc,8BAA8B;"}
1	+ {"version":3,"file":"usePreferredDark.mjs","sources":["../../../../src/hooks/usePreferredDark/usePreferredDark.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/*\n @name usePreferredDark\n * @description - Hook that returns if the user prefers dark mode\n * @category User\n \n @example\n * const isDark = usePreferredDark();\n */\nexport const usePreferredDark = () => useMediaQuery('(prefers-color-scheme: dark)');\n"],"names":["usePreferredDark","useMediaQuery"],"mappings":";AAUO,MAAMA,IAAmB,MAAMC,EAAc,8BAA8B;"}

package/dist/esm/hooks/usePreferredLanguages/usePreferredLanguages.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredLanguages.mjs","sources":["../../../../src/hooks/usePreferredLanguages/usePreferredLanguages.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nconst getSnapshot = () => window.navigator.languages;\nconst getServerSnapshot = () => [] as const;\nconst subscribe = (callback: () => void) => {\n window.addEventListener('languagechange', callback);\n return () => {\n window.removeEventListener('languagechange', callback);\n };\n};\n\n/*\n @name usePreferredLanguages\n * @description Hook that returns a browser preferred languages from navigator\n * @category ~~Browser~~\n \n @browserapi navigator.languages https://developer.mozilla.org/en-US/docs/Web/API/Navigator/languages\n \n @returns {readonly string[]} An array of strings representing the user's preferred languages\n \n @example\n * const languages = usePreferredLanguages();\n */\nexport const usePreferredLanguages = () =>\n useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n"],"names":["getSnapshot","getServerSnapshot","subscribe","callback","usePreferredLanguages","useSyncExternalStore"],"mappings":";AAEA,MAAMA,IAAc,MAAM,OAAO,UAAU,WACrCC,IAAoB,MAAM,CAAA,GAC1BC,IAAY,CAACC,OACjB,OAAO,iBAAiB,kBAAkBA,CAAQ,GAC3C,MAAM;AACX,SAAO,oBAAoB,kBAAkBA,CAAQ;AAAA,IAgB5CC,IAAwB,MACnCC,EAAqBH,GAAWF,GAAaC,CAAiB;"}
1	+ {"version":3,"file":"usePreferredLanguages.mjs","sources":["../../../../src/hooks/usePreferredLanguages/usePreferredLanguages.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nconst getSnapshot = () => window.navigator.languages;\nconst getServerSnapshot = () => [] as const;\nconst subscribe = (callback: () => void) => {\n window.addEventListener('languagechange', callback);\n return () => {\n window.removeEventListener('languagechange', callback);\n };\n};\n\n/*\n @name usePreferredLanguages\n * @description Hook that returns a browser preferred languages from navigator\n * @category User\n \n @browserapi navigator.languages https://developer.mozilla.org/en-US/docs/Web/API/Navigator/languages\n \n @returns {readonly string[]} An array of strings representing the user's preferred languages\n \n @example\n * const languages = usePreferredLanguages();\n */\nexport const usePreferredLanguages = () =>\n useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n"],"names":["getSnapshot","getServerSnapshot","subscribe","callback","usePreferredLanguages","useSyncExternalStore"],"mappings":";AAEA,MAAMA,IAAc,MAAM,OAAO,UAAU,WACrCC,IAAoB,MAAM,CAAA,GAC1BC,IAAY,CAACC,OACjB,OAAO,iBAAiB,kBAAkBA,CAAQ,GAC3C,MAAM;AACX,SAAO,oBAAoB,kBAAkBA,CAAQ;AAAA,IAgB5CC,IAAwB,MACnCC,EAAqBH,GAAWF,GAAaC,CAAiB;"}

package/dist/esm/hooks/usePreferredReducedMotion/usePreferredReducedMotion.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredReducedMotion.mjs","sources":["../../../../src/hooks/usePreferredReducedMotion/usePreferredReducedMotion.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/** The use preferred reduced motion return type /\nexport type UsePreferredReducedMotionReturn = 'no-preference' \| 'reduce';\n\n/\n @name usePreferredReducedMotion\n * @description - Hook that returns the reduced motion preference\n * @category ~~Browser~~\n \n @returns {UsePreferredReducedMotionReturn} The reduced motion preference\n \n @example\n * const reduced = usePreferredReducedMotion();\n */\nexport const usePreferredReducedMotion = (): UsePreferredReducedMotionReturn => {\n const reduced = useMediaQuery('(prefers-reduced-motion: reduce)');\n return reduced ? 'reduce' : 'no-preference';\n};\n"],"names":["usePreferredReducedMotion","useMediaQuery"],"mappings":";AAeO,MAAMA,IAA4B,MACvBC,EAAc,kCAAkC,IAC/C,WAAW;"}
1	+ {"version":3,"file":"usePreferredReducedMotion.mjs","sources":["../../../../src/hooks/usePreferredReducedMotion/usePreferredReducedMotion.ts"],"sourcesContent":["import { useMediaQuery } from '../useMediaQuery/useMediaQuery';\n\n/** The use preferred reduced motion return type /\nexport type UsePreferredReducedMotionReturn = 'no-preference' \| 'reduce';\n\n/\n @name usePreferredReducedMotion\n * @description - Hook that returns the reduced motion preference\n * @category User\n \n @returns {UsePreferredReducedMotionReturn} The reduced motion preference\n \n @example\n * const reduced = usePreferredReducedMotion();\n */\nexport const usePreferredReducedMotion = (): UsePreferredReducedMotionReturn => {\n const reduced = useMediaQuery('(prefers-reduced-motion: reduce)');\n return reduced ? 'reduce' : 'no-preference';\n};\n"],"names":["usePreferredReducedMotion","useMediaQuery"],"mappings":";AAeO,MAAMA,IAA4B,MACvBC,EAAc,kCAAkC,IAC/C,WAAW;"}

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

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

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useRaf.mjs","sources":["../../../../src/hooks/useRaf/useRaf.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/* The use raf params type /\nexport interface UseRafParams {\n /* The delta between each frame in milliseconds /\n delta: number;\n /* The timestamp of the current frame in milliseconds /\n timestamp: DOMHighResTimeStamp;\n}\n\n/ The use raf type /\nexport type UseRafCallback = (params: UseRafParams) => void;\n\n/ The use raf options type /\nexport interface UseRafOptions {\n /* The delay between each frame in milliseconds /\n delay?: number;\n /* Whether the callback should be enabled /\n enabled?: boolean;\n}\n\n/ The use raf return type /\nexport interface UseRafReturn {\n /* Whether the callback is active /\n active: boolean;\n /* Function to pause the callback /\n pause: () => void;\n /* Function to resume the callback /\n resume: () => void;\n}\n\n/\n @name useRaf\n * @description - Hook that defines the logic for raf callback\n * @category ~~Utilities~~\n \n @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\n \n @param {UseRafCallback} callback The callback to execute\n * @param {number} [options.delay] The delay between each frame in milliseconds\n * @param {boolean} [options.enabled=true] Whether the callback should be enabled\n * @returns {UseRafCallbackReturn} An object of raf callback functions\n \n @example\n * useRaf(() => console.log('callback'));\n */\nexport const useRaf = (callback: UseRafCallback, options?: UseRafOptions): UseRafReturn => {\n const rafIdRef = useRef<number \| null>(null);\n const previousFrameTimestampRef = useRef(0);\n const [active, setActive] = useState(false);\n const enabled = options?.enabled ?? true;\n\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n\n const loop = (timestamp: DOMHighResTimeStamp) => {\n const delta = timestamp - previousFrameTimestampRef.current;\n\n if (options?.delay && delta < options?.delay) {\n rafIdRef.current = window.requestAnimationFrame(loop);\n return;\n }\n\n previousFrameTimestampRef.current = timestamp;\n internalCallbackRef.current({ delta, timestamp });\n rafIdRef.current = window.requestAnimationFrame(loop);\n };\n\n const resume = () => {\n if (active) return;\n setActive(true);\n previousFrameTimestampRef.current = 0;\n rafIdRef.current = window.requestAnimationFrame(loop);\n };\n\n function pause() {\n if (!rafIdRef.current) return;\n\n setActive(false);\n window.cancelAnimationFrame(rafIdRef.current);\n rafIdRef.current = null;\n }\n\n useEffect(() => {\n if (!enabled) return;\n resume();\n\n return pause;\n }, [enabled, options?.delay]);\n\n return {\n active,\n pause,\n resume\n };\n};\n"],"names":["useRaf","callback","options","rafIdRef","useRef","previousFrameTimestampRef","active","setActive","useState","enabled","internalCallbackRef","loop","timestamp","delta","resume","pause","useEffect"],"mappings":";AA8CO,MAAMA,IAAS,CAACC,GAA0BC,MAA0C;AACzF,QAAMC,IAAWC,EAAsB,IAAI,GACrCC,IAA4BD,EAAO,CAAC,GACpC,CAACE,GAAQC,CAAS,IAAIC,EAAS,EAAK,GACpCC,IAAUP,GAAS,WAAW,IAE9BQ,IAAsBN,EAAOH,CAAQ;AAC3C,EAAAS,EAAoB,UAAUT;AAE9B,QAAMU,IAAO,CAACC,MAAmC;AAC/C,UAAMC,IAAQD,IAAYP,EAA0B;AAEpD,QAAIH,GAAS,SAASW,IAAQX,GAAS,OAAO;AAC5C,MAAAC,EAAS,UAAU,OAAO,sBAAsBQ,CAAI;AACpD;AAAA,IAAA;AAGF,IAAAN,EAA0B,UAAUO,GACpCF,EAAoB,QAAQ,EAAE,OAAAG,GAAO,WAAAD,EAAA,CAAW,GAChDT,EAAS,UAAU,OAAO,sBAAsBQ,CAAI;AAAA,EAAA,GAGhDG,IAAS,MAAM;AACnB,IAAIR,MACJC,EAAU,EAAI,GACdF,EAA0B,UAAU,GACpCF,EAAS,UAAU,OAAO,sBAAsBQ,CAAI;AAAA,EAAA;AAGtD,WAASI,IAAQ;AACf,IAAKZ,EAAS,YAEdI,EAAU,EAAK,GACf,OAAO,qBAAqBJ,EAAS,OAAO,GAC5CA,EAAS,UAAU;AAAA,EAAA;AAGrB,SAAAa,EAAU,MAAM;AACd,QAAKP;AACL,aAAAK,EAAA,GAEOC;AAAA,EAAA,GACN,CAACN,GAASP,GAAS,KAAK,CAAC,GAErB;AAAA,IACL,QAAAI;AAAA,IACA,OAAAS;AAAA,IACA,QAAAD;AAAA,EAAA;AAEJ;"}
1	+ {"version":3,"file":"useRaf.mjs","sources":["../../../../src/hooks/useRaf/useRaf.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/* The use raf params type /\nexport interface UseRafParams {\n /* The delta between each frame in milliseconds /\n delta: number;\n /* The timestamp of the current frame in milliseconds /\n timestamp: DOMHighResTimeStamp;\n}\n\n/ The use raf type /\nexport type UseRafCallback = (params: UseRafParams) => void;\n\n/ The use raf options type /\nexport interface UseRafOptions {\n /* The delay between each frame in milliseconds /\n delay?: number;\n /* Whether the callback should be enabled /\n enabled?: boolean;\n}\n\n/ The use raf return type /\nexport interface UseRafReturn {\n /* Whether the callback is active /\n active: boolean;\n /* Function to pause the callback /\n pause: () => void;\n /* Function to resume the callback /\n resume: () => void;\n}\n\n/\n @name useRaf\n * @description - Hook that defines the logic for raf callback\n * @category Browser\n \n @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\n \n @param {UseRafCallback} callback The callback to execute\n * @param {number} [options.delay] The delay between each frame in milliseconds\n * @param {boolean} [options.enabled=true] Whether the callback should be enabled\n * @returns {UseRafCallbackReturn} An object of raf callback functions\n \n @example\n * useRaf(() => console.log('callback'));\n */\nexport const useRaf = (callback: UseRafCallback, options?: UseRafOptions): UseRafReturn => {\n const rafIdRef = useRef<number \| null>(null);\n const previousFrameTimestampRef = useRef(0);\n const [active, setActive] = useState(false);\n const enabled = options?.enabled ?? true;\n\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n\n const loop = (timestamp: DOMHighResTimeStamp) => {\n const delta = timestamp - previousFrameTimestampRef.current;\n\n if (options?.delay && delta < options?.delay) {\n rafIdRef.current = window.requestAnimationFrame(loop);\n return;\n }\n\n previousFrameTimestampRef.current = timestamp;\n internalCallbackRef.current({ delta, timestamp });\n rafIdRef.current = window.requestAnimationFrame(loop);\n };\n\n const resume = () => {\n if (active) return;\n setActive(true);\n previousFrameTimestampRef.current = 0;\n rafIdRef.current = window.requestAnimationFrame(loop);\n };\n\n function pause() {\n if (!rafIdRef.current) return;\n\n setActive(false);\n window.cancelAnimationFrame(rafIdRef.current);\n rafIdRef.current = null;\n }\n\n useEffect(() => {\n if (!enabled) return;\n resume();\n\n return pause;\n }, [enabled, options?.delay]);\n\n return {\n active,\n pause,\n resume\n };\n};\n"],"names":["useRaf","callback","options","rafIdRef","useRef","previousFrameTimestampRef","active","setActive","useState","enabled","internalCallbackRef","loop","timestamp","delta","resume","pause","useEffect"],"mappings":";AA8CO,MAAMA,IAAS,CAACC,GAA0BC,MAA0C;AACzF,QAAMC,IAAWC,EAAsB,IAAI,GACrCC,IAA4BD,EAAO,CAAC,GACpC,CAACE,GAAQC,CAAS,IAAIC,EAAS,EAAK,GACpCC,IAAUP,GAAS,WAAW,IAE9BQ,IAAsBN,EAAOH,CAAQ;AAC3C,EAAAS,EAAoB,UAAUT;AAE9B,QAAMU,IAAO,CAACC,MAAmC;AAC/C,UAAMC,IAAQD,IAAYP,EAA0B;AAEpD,QAAIH,GAAS,SAASW,IAAQX,GAAS,OAAO;AAC5C,MAAAC,EAAS,UAAU,OAAO,sBAAsBQ,CAAI;AACpD;AAAA,IAAA;AAGF,IAAAN,EAA0B,UAAUO,GACpCF,EAAoB,QAAQ,EAAE,OAAAG,GAAO,WAAAD,EAAA,CAAW,GAChDT,EAAS,UAAU,OAAO,sBAAsBQ,CAAI;AAAA,EAAA,GAGhDG,IAAS,MAAM;AACnB,IAAIR,MACJC,EAAU,EAAI,GACdF,EAA0B,UAAU,GACpCF,EAAS,UAAU,OAAO,sBAAsBQ,CAAI;AAAA,EAAA;AAGtD,WAASI,IAAQ;AACf,IAAKZ,EAAS,YAEdI,EAAU,EAAK,GACf,OAAO,qBAAqBJ,EAAS,OAAO,GAC5CA,EAAS,UAAU;AAAA,EAAA;AAGrB,SAAAa,EAAU,MAAM;AACd,QAAKP;AACL,aAAAK,EAAA,GAEOC;AAAA,EAAA,GACN,CAACN,GAASP,GAAS,KAAK,CAAC,GAErB;AAAA,IACL,QAAAI;AAAA,IACA,OAAAS;AAAA,IACA,QAAAD;AAAA,EAAA;AAEJ;"}

package/dist/esm/hooks/{useRafValue/useRafValue.mjs → useRafState/useRafState.mjs} RENAMED Viewed

@@ -7,6 +7,6 @@ const f = (t) => {
   return m(() => cancelAnimationFrame(e.current)), [n, a];
 };
 export {
-  f as useRafValue
+  f as useRafState
 };
-//# sourceMappingURL=useRafValue.mjs.map
+//# sourceMappingURL=useRafState.mjs.map

package/dist/esm/hooks/useRafState/useRafState.mjs.map ADDED Viewed

@@ -0,0 +1 @@

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

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

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

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useRenderInfo.mjs","sources":["../../../../src/hooks/useRenderInfo/useRenderInfo.ts"],"sourcesContent":["import { useRef } from 'react';\n\nexport interface UseRenderInfoReturn {\n component: string;\n renders: number;\n sinceLast: number;\n timestamp: number \| null;\n}\n\n/*\n @name useRenderInfo\n * @description - Hook for getting information about component rerender\n * @category ~~Lifecycle~~\n \n @param {string} [name='Unknown'] Component name\n * @param {boolean} [log=true] Toggle logging\n * @returns {UseRenderInfoReturn} An object containing rerender information\n \n @example\n * const rerenderInfo = useRenderInfo('Component');\n */\nexport const useRenderInfo = (name: string = 'Unknown', log: boolean = true) => {\n const renderInfoRef = useRef<UseRenderInfoReturn>({\n component: name,\n renders: 0,\n timestamp: Date.now(),\n sinceLast: 0\n });\n const now = Date.now();\n\n renderInfoRef.current.renders += 1;\n renderInfoRef.current.sinceLast = renderInfoRef.current.timestamp\n ? now - renderInfoRef.current.timestamp\n : 0;\n renderInfoRef.current.timestamp = now;\n\n if (log) {\n console.group(`${name} info, render number: ${renderInfoRef.current.renders}`);\n console.log(`Timestamp: ${renderInfoRef.current.timestamp}`);\n console.log(`Since last render: ${renderInfoRef.current.sinceLast}`);\n console.log(`Renders: ${renderInfoRef.current.renders}`);\n console.dir(renderInfoRef.current);\n console.groupEnd();\n }\n\n return renderInfoRef.current;\n};\n"],"names":["useRenderInfo","name","log","renderInfoRef","useRef","now"],"mappings":";~~AAqBO~~,MAAMA,IAAgB,CAACC,IAAe,WAAWC,IAAe,OAAS;AAC9E,QAAMC,IAAgBC,EAA4B;AAAA,IAChD,WAAWH;AAAA,IACX,SAAS;AAAA,IACT,WAAW,KAAK,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;"}
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 \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":";AA0BO,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;"}

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

	@@ -1 +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 ~~Lifecycle~~\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":";AAeO,MAAMA,IAAc,MAAyBC,EAAW,OAAO,CAAA,IAAK,CAAA,CAAE,EAAE,CAAC;"}
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 \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":";AAeO,MAAMA,IAAc,MAAyBC,EAAW,OAAO,CAAA,IAAK,CAAA,CAAE,EAAE,CAAC;"}

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

	@@ -1 +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 { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The resize observer options type /\nexport interface UseResizeObserverOptions extends ResizeObserverOptions {\n /* The enabled state /\n enabled?: boolean;\n /* The resize observer callback /\n onChange?: (entries: ResizeObserverEntry[], observer: ResizeObserver) => void;\n}\n\n/* The resize observer return type /\nexport interface UseResizeObserverReturn {\n /* The resize observer entries /\n entries: ResizeObserverEntry[];\n}\n\nexport interface UseResizeObserver {\n (target: HookTarget, options?: UseResizeObserverOptions): UseResizeObserverReturn;\n\n <Target extends Element>(\n options?: UseResizeObserverOptions,\n target?: never\n ): UseResizeObserverReturn & { ref: StateRef<Target> };\n}\n\n/\n @name useResizeObserver\n * @description - Hook that gives you resize observer state\n * @category ~~Browser~~\n \n @browserapi ResizeObserver https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver\n \n @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The IntersectionObserver options\n * @param {boolean} [options.box] The IntersectionObserver options\n * @param {(entries: ResizeObserverEntry[], observer: ResizeObserver) => void} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} An object containing the resize observer state\n \n @example\n * const { ref, entries } = useResizeObserver();\n \n @overload\n * @template Target The target element\n * @param {HookTarget} target The target element to observe\n * @param {boolean} [options.enabled=true] The IntersectionObserver options\n * @param {boolean} [options.box] The IntersectionObserver options\n * @param {(entries: ResizeObserverEntry[], observer: ResizeObserver) => void} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n \n @example\n * const { entries } = useResizeObserver(ref);\n */\nexport const useResizeObserver = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (target ? params[1] : params[0]) as UseResizeObserverOptions \| undefined;\n const enabled = options?.enabled ?? true;\n\n const [entries, setEntries] = useState<ResizeObserverEntry[]>([]);\n\n const internalRef = useRefState<Element>();\n const internalOnChangeRef = useRef<UseResizeObserverOptions['onChange']>(options?.onChange);\n internalOnChangeRef.current = options?.onChange;\n\n useEffect(() => {\n if (!enabled \|\| (!target && !internalRef.state)) return;\n\n const element = target ? getElement(target) : internalRef.current;\n if (!element) return;\n\n const observer = new ResizeObserver((entries) => {\n setEntries(entries);\n internalOnChangeRef.current?.(entries, observer);\n });\n observer.observe(element as Element, options);\n\n return () => {\n observer.disconnect();\n };\n }, [target, internalRef.state, options?.box, enabled]);\n\n if (target) return { entries };\n return {\n ref: internalRef,\n entries\n };\n}) as UseResizeObserver;\n"],"names":["useResizeObserver","params","target","isTarget","options","enabled","entries","setEntries","useState","internalRef","useRefState","internalOnChangeRef","useRef","useEffect","element","getElement","observer"],"mappings":";;;;AA6DO,MAAMA,IAAqB,IAAIC,MAAkB;AACtD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,IAAUD,GAAS,WAAW,IAE9B,CAACE,GAASC,CAAU,IAAIC,EAAgC,CAAA,CAAE,GAE1DC,IAAcC,EAAA,GACdC,IAAsBC,EAA6CR,GAAS,QAAQ;AAoB1F,SAnBAO,EAAoB,UAAUP,GAAS,UAEvCS,EAAU,MAAM;AACd,QAAI,CAACR,KAAY,CAACH,KAAU,CAACO,EAAY,MAAQ;AAEjD,UAAMK,IAAUZ,IAASa,EAAWb,CAAM,IAAIO,EAAY;AAC1D,QAAI,CAACK,EAAS;AAEd,UAAME,IAAW,IAAI,eAAe,CAACV,MAAY;AAC/C,MAAAC,EAAWD,CAAO,GAClBK,EAAoB,UAAUL,GAASU,CAAQ;AAAA,IAAA,CAChD;AACD,WAAAA,EAAS,QAAQF,GAAoBV,CAAO,GAErC,MAAM;AACX,MAAAY,EAAS,WAAA;AAAA,IAAW;AAAA,EACtB,GACC,CAACd,GAAQO,EAAY,OAAOL,GAAS,KAAKC,CAAO,CAAC,GAEjDH,IAAe,EAAE,SAAAI,EAAA,IACd;AAAA,IACL,KAAKG;AAAA,IACL,SAAAH;AAAA,EAAA;AAEJ;"}
1	+ {"version":3,"file":"useResizeObserver.mjs","sources":["../../../../src/hooks/useResizeObserver/useResizeObserver.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The resize observer options type /\nexport interface UseResizeObserverOptions extends ResizeObserverOptions {\n /* The enabled state /\n enabled?: boolean;\n /* The resize observer callback /\n onChange?: (entries: ResizeObserverEntry[], observer: ResizeObserver) => void;\n}\n\n/* The resize observer return type /\nexport interface UseResizeObserverReturn {\n /* The resize observer entries /\n entries: ResizeObserverEntry[];\n}\n\nexport interface UseResizeObserver {\n (target: HookTarget, options?: UseResizeObserverOptions): UseResizeObserverReturn;\n\n <Target extends Element>(\n options?: UseResizeObserverOptions,\n target?: never\n ): UseResizeObserverReturn & { ref: StateRef<Target> };\n}\n\n/\n @name useResizeObserver\n * @description - Hook that gives you resize observer state\n * @category Sensors\n \n @browserapi ResizeObserver https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver\n \n @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The IntersectionObserver options\n * @param {boolean} [options.box] The IntersectionObserver options\n * @param {(entries: ResizeObserverEntry[], observer: ResizeObserver) => void} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} An object containing the resize observer state\n \n @example\n * const { ref, entries } = useResizeObserver();\n \n @overload\n * @template Target The target element\n * @param {HookTarget} target The target element to observe\n * @param {boolean} [options.enabled=true] The IntersectionObserver options\n * @param {boolean} [options.box] The IntersectionObserver options\n * @param {(entries: ResizeObserverEntry[], observer: ResizeObserver) => void} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n \n @example\n * const { entries } = useResizeObserver(ref);\n */\nexport const useResizeObserver = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (target ? params[1] : params[0]) as UseResizeObserverOptions \| undefined;\n const enabled = options?.enabled ?? true;\n\n const [entries, setEntries] = useState<ResizeObserverEntry[]>([]);\n\n const internalRef = useRefState<Element>();\n const internalOnChangeRef = useRef<UseResizeObserverOptions['onChange']>(options?.onChange);\n internalOnChangeRef.current = options?.onChange;\n\n useEffect(() => {\n if (!enabled \|\| (!target && !internalRef.state)) return;\n\n const element = target ? getElement(target) : internalRef.current;\n if (!element) return;\n\n const observer = new ResizeObserver((entries) => {\n setEntries(entries);\n internalOnChangeRef.current?.(entries, observer);\n });\n observer.observe(element as Element, options);\n\n return () => {\n observer.disconnect();\n };\n }, [target, internalRef.state, options?.box, enabled]);\n\n if (target) return { entries };\n return {\n ref: internalRef,\n entries\n };\n}) as UseResizeObserver;\n"],"names":["useResizeObserver","params","target","isTarget","options","enabled","entries","setEntries","useState","internalRef","useRefState","internalOnChangeRef","useRef","useEffect","element","getElement","observer"],"mappings":";;;;AA6DO,MAAMA,IAAqB,IAAIC,MAAkB;AACtD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IAAWF,IAASD,EAAO,CAAC,IAAIA,EAAO,CAAC,GACxCI,IAAUD,GAAS,WAAW,IAE9B,CAACE,GAASC,CAAU,IAAIC,EAAgC,CAAA,CAAE,GAE1DC,IAAcC,EAAA,GACdC,IAAsBC,EAA6CR,GAAS,QAAQ;AAoB1F,SAnBAO,EAAoB,UAAUP,GAAS,UAEvCS,EAAU,MAAM;AACd,QAAI,CAACR,KAAY,CAACH,KAAU,CAACO,EAAY,MAAQ;AAEjD,UAAMK,IAAUZ,IAASa,EAAWb,CAAM,IAAIO,EAAY;AAC1D,QAAI,CAACK,EAAS;AAEd,UAAME,IAAW,IAAI,eAAe,CAACV,MAAY;AAC/C,MAAAC,EAAWD,CAAO,GAClBK,EAAoB,UAAUL,GAASU,CAAQ;AAAA,IAAA,CAChD;AACD,WAAAA,EAAS,QAAQF,GAAoBV,CAAO,GAErC,MAAM;AACX,MAAAY,EAAS,WAAA;AAAA,IAAW;AAAA,EACtB,GACC,CAACd,GAAQO,EAAY,OAAOL,GAAS,KAAKC,CAAO,CAAC,GAEjDH,IAAe,EAAE,SAAAI,EAAA,IACd;AAAA,IACL,KAAKG;AAAA,IACL,SAAAH;AAAA,EAAA;AAEJ;"}

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

	@@ -1 +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 ~~Browser~~\n \n @param {string} src The source of the script\n * @param {UseScriptOptions} [options] The options of the script extends from attributes script tag\n * @param {boolean} [options.removeOnUnmount=true] Whether to remove the script on unmount\n * @param {boolean} [options.async=true] Whether to load the script asynchronously\n * @returns {UseScriptStatus} The status of the script\n \n @example\n * const status = useScript('https://example.com/script.js');\n */\nexport const useScript = (src: string, options: UseScriptOptions = {}) => {\n const [status, setStatus] = useState<UseScriptStatus>(() => {\n const script = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n const scriptStatus = script?.getAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME) as UseScriptStatus;\n if (scriptStatus) return scriptStatus;\n if (script) return 'unknown';\n\n return 'loading';\n });\n const { removeOnUnmount = true, async = true } = options;\n\n useEffect(() => {\n const existedScript = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n const scriptStatus = existedScript?.getAttribute(\n SCRIPT_STATUS_ATTRIBUTE_NAME\n ) as UseScriptStatus;\n if (scriptStatus) return setStatus(scriptStatus);\n if (existedScript) return setStatus('unknown');\n\n const script = document.createElement('script');\n script.src = src;\n script.async = async;\n\n for (const [key, value] of Object.entries(options)) {\n script.setAttribute(key, String(value));\n }\n\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'loading');\n document.body.appendChild(script);\n\n const onLoad = () => {\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'ready');\n setStatus('ready');\n };\n\n const onError = () => {\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'error');\n setStatus('error');\n };\n\n script.addEventListener('load', onLoad);\n script.addEventListener('error', onError);\n\n return () => {\n if (removeOnUnmount) script.remove();\n script.removeEventListener('load', onLoad);\n script.removeEventListener('error', onError);\n };\n }, [src, removeOnUnmount]);\n\n return status;\n};\n"],"names":["SCRIPT_STATUS_ATTRIBUTE_NAME","useScript","src","options","status","setStatus","useState","script","scriptStatus","removeOnUnmount","async","useEffect","existedScript","key","value","onLoad","onError"],"mappings":";AAMO,MAAMA,IAA+B,iBAsB/BC,IAAY,CAACC,GAAaC,IAA4B,OAAO;AACxE,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAA0B,MAAM;AAC1D,UAAMC,IAAS,SAAS,cAAc,eAAeL,CAAG,IAAI,GACtDM,IAAeD,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;"}
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 \n @param {string} src The source of the script\n * @param {UseScriptOptions} [options] The options of the script extends from attributes script tag\n * @param {boolean} [options.removeOnUnmount=true] Whether to remove the script on unmount\n * @param {boolean} [options.async=true] Whether to load the script asynchronously\n * @returns {UseScriptStatus} The status of the script\n \n @example\n * const status = useScript('https://example.com/script.js');\n */\nexport const useScript = (src: string, options: UseScriptOptions = {}) => {\n const [status, setStatus] = useState<UseScriptStatus>(() => {\n const script = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n const scriptStatus = script?.getAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME) as UseScriptStatus;\n if (scriptStatus) return scriptStatus;\n if (script) return 'unknown';\n\n return 'loading';\n });\n const { removeOnUnmount = true, async = true } = options;\n\n useEffect(() => {\n const existedScript = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n const scriptStatus = existedScript?.getAttribute(\n SCRIPT_STATUS_ATTRIBUTE_NAME\n ) as UseScriptStatus;\n if (scriptStatus) return setStatus(scriptStatus);\n if (existedScript) return setStatus('unknown');\n\n const script = document.createElement('script');\n script.src = src;\n script.async = async;\n\n for (const [key, value] of Object.entries(options)) {\n script.setAttribute(key, String(value));\n }\n\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'loading');\n document.body.appendChild(script);\n\n const onLoad = () => {\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'ready');\n setStatus('ready');\n };\n\n const onError = () => {\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'error');\n setStatus('error');\n };\n\n script.addEventListener('load', onLoad);\n script.addEventListener('error', onError);\n\n return () => {\n if (removeOnUnmount) script.remove();\n script.removeEventListener('load', onLoad);\n script.removeEventListener('error', onError);\n };\n }, [src, removeOnUnmount]);\n\n return status;\n};\n"],"names":["SCRIPT_STATUS_ATTRIBUTE_NAME","useScript","src","options","status","setStatus","useState","script","scriptStatus","removeOnUnmount","async","useEffect","existedScript","key","value","onLoad","onError"],"mappings":";AAMO,MAAMA,IAA+B,iBAsB/BC,IAAY,CAACC,GAAaC,IAA4B,OAAO;AACxE,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAA0B,MAAM;AAC1D,UAAMC,IAAS,SAAS,cAAc,eAAeL,CAAG,IAAI,GACtDM,IAAeD,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;"}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useScroll.mjs","sources":["../../../../src/hooks/useScroll/useScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\r\n\r\nimport type { HookTarget } from '@/utils/helpers';\r\n\r\nimport { getElement, isTarget } from '@/utils/helpers';\r\n\r\nimport type { StateRef } from '../useRefState/useRefState';\r\n\r\nimport { useRefState } from '../useRefState/useRefState';\r\n\r\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\r\n\r\nexport interface UseScrollOptions {\r\n /** The on scroll callback /\r\n onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\r\n\r\n /* The on end scroll callback /\r\n onStop?: (event: Event) => void;\r\n\r\n /* Offset arrived states by x pixels. /\r\n offset?: {\r\n left?: number;\r\n right?: number;\r\n top?: number;\r\n bottom?: number;\r\n };\r\n}\r\n\r\nexport interface UseScrollCallbackParams {\r\n /* The element x position /\r\n x: number;\r\n /* The element y position /\r\n y: number;\r\n /* State of scroll arrived /\r\n arrived: {\r\n left: boolean;\r\n right: boolean;\r\n top: boolean;\r\n bottom: boolean;\r\n };\r\n /* State of scroll direction /\r\n directions: {\r\n left: boolean;\r\n right: boolean;\r\n top: boolean;\r\n bottom: boolean;\r\n };\r\n}\r\n\r\nexport interface UseScroll {\r\n (target: HookTarget, callback?: (params: UseScrollCallbackParams, event: Event) => void): boolean;\r\n\r\n (target: HookTarget, options?: UseScrollOptions): boolean;\r\n\r\n <Target extends Element>(\r\n callback?: (params: UseScrollCallbackParams, event: Event) => void,\r\n target?: never\r\n ): {\r\n ref: StateRef<Target>;\r\n scrolling: boolean;\r\n };\r\n\r\n <Target extends Element>(\r\n options?: UseScrollOptions,\r\n target?: never\r\n ): {\r\n ref: StateRef<Target>;\r\n scrolling: boolean;\r\n };\r\n}\r\n\r\n/\r\n @name useScroll\r\n * @description - Hook that allows you to control scroll a element\r\n * @category Sensors\r\n \r\n @overload\r\n * @template Target The target element\r\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\r\n * @param {number} [options.offset.left=0] The left offset for arrived states\r\n * @param {number} [options.offset.right=0] The right offset for arrived states\r\n * @param {number} [options.offset.top=0] The top offset for arrived states\r\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\r\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\r\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\r\n * @returns {boolean} The state of scrolling\r\n \r\n @example\r\n * const scrolling = useScroll(ref, options);\r\n \r\n @overload\r\n * @template Target The target element\r\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\r\n * @returns {boolean} The state of scrolling\r\n \r\n @example\r\n * const scrolling = useScroll(ref, () => console.log('callback'));\r\n \r\n @overload\r\n * @template Target The target element\r\n * @param {Target} target The target element to scroll\r\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\r\n * @param {number} [options.offset.left=0] The left offset for arrived states\r\n * @param {number} [options.offset.right=0] The right offset for arrived states\r\n * @param {number} [options.offset.top=0] The top offset for arrived states\r\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\r\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\r\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\r\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\r\n \r\n @example\r\n * const { ref, scrolling } = useScroll(options);\r\n \r\n @overload\r\n * @template Target The target element\r\n * @param {Target} target The target element to scroll\r\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\r\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\r\n \r\n @example\r\n * const { ref, scrolling } = useScroll(() => console.log('callback'));\r\n /\r\nexport const useScroll = ((...params: any[]) => {\r\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\r\n const options = (\r\n target\r\n ? typeof params[1] === 'object'\r\n ? params[1]\r\n : { onScroll: params[1] }\r\n : typeof params[0] === 'object'\r\n ? params[0]\r\n : { onScroll: params[0] }\r\n ) as UseScrollOptions \| undefined;\r\n\r\n const internalRef = useRefState<Element>();\r\n const internalOptionsRef = useRef(options);\r\n internalOptionsRef.current = options;\r\n\r\n const [scrolling, setScrolling] = useState(false);\r\n const scrollPositionRef = useRef({ x: 0, y: 0 });\r\n\r\n useEffect(() => {\r\n if (!target && !internalRef.state) return;\r\n const element = (target ? getElement(target) : internalRef.current) as Element;\r\n\r\n if (!element) return;\r\n\r\n const onScrollEnd = (event: Event) => {\r\n setScrolling(false);\r\n options?.onStop?.(event);\r\n };\r\n\r\n const onScroll = (event: Event) => {\r\n setScrolling(true);\r\n const target = (\r\n event.target === document ? (event.target as Document).documentElement : event.target\r\n ) as HTMLElement;\r\n\r\n const { display, flexDirection, direction } = target.style;\r\n const directionMultiplier = direction === 'rtl' ? -1 : 1;\r\n\r\n const scrollLeft = target.scrollLeft;\r\n let scrollTop = target.scrollTop;\r\n if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\r\n\r\n const offset = internalOptionsRef.current?.offset;\r\n const left = scrollLeft directionMultiplier <= (offset?.left ?? 0);\r\n const right =\r\n scrollLeft * directionMultiplier + target.clientWidth >=\r\n target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\r\n const top = scrollTop <= (offset?.top ?? 0);\r\n const bottom =\r\n scrollTop + target.clientHeight >=\r\n target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\r\n\r\n const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\r\n const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\r\n\r\n const params = {\r\n x: scrollLeft,\r\n y: scrollTop,\r\n directions: {\r\n left: scrollLeft < scrollPositionRef.current.x,\r\n right: scrollLeft > scrollPositionRef.current.x,\r\n top: scrollTop < scrollPositionRef.current.y,\r\n bottom: scrollTop > scrollPositionRef.current.y\r\n },\r\n arrived: {\r\n left: isRowReverse ? right : left,\r\n right: isRowReverse ? left : right,\r\n top: isColumnReverse ? bottom : top,\r\n bottom: isColumnReverse ? top : bottom\r\n }\r\n };\r\n\r\n scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\r\n internalOptionsRef.current?.onScroll?.(params, event);\r\n };\r\n\r\n element.addEventListener('scroll', onScroll);\r\n element.addEventListener('scrollend', onScrollEnd);\r\n\r\n return () => {\r\n element.removeEventListener('scroll', onScroll);\r\n element.removeEventListener('scrollend', onScrollEnd);\r\n };\r\n }, [target, internalRef.state]);\r\n\r\n if (target) return scrolling;\r\n return {\r\n ref: internalRef,\r\n scrolling\r\n };\r\n}) as UseScroll;\r\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse"],"mappings":";;;;AAUA,MAAMA,IAAiC,GAgH1BC,IAAa,IAAIC,MAAkB;AAC9C,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,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,IAAcC,EAAA,GACdC,IAAqBC,EAAOJ,CAAO;AACzC,EAAAG,EAAmB,UAAUH;AAE7B,QAAM,CAACK,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1CC,IAAoBJ,EAAO,EAAE,GAAG,GAAG,GAAG,GAAG;AAqE/C,SAnEAK,EAAU,MAAM;AACd,QAAI,CAACX,KAAU,CAACG,EAAY,MAAO;AACnC,UAAMS,IAAWZ,IAASa,EAAWb,CAAM,IAAIG,EAAY;AAE3D,QAAI,CAACS,EAAS;AAEd,UAAME,IAAc,CAACC,MAAiB;AACpC,MAAAP,EAAa,EAAK,GAClBN,GAAS,SAASa,CAAK;AAAA,IAAA,GAGnBC,IAAW,CAACD,MAAiB;AACjC,MAAAP,EAAa,EAAI;AACjB,YAAMR,IACJe,EAAM,WAAW,WAAYA,EAAM,OAAoB,kBAAkBA,EAAM,QAG3E,EAAE,SAAAE,GAAS,eAAAC,GAAe,WAAAC,EAAA,IAAcnB,EAAO,OAC/CoB,IAAsBD,MAAc,QAAQ,KAAK,GAEjDE,IAAarB,EAAO;AAC1B,UAAIsB,IAAYtB,EAAO;AACvB,MAAIA,aAAkB,YAAY,CAACsB,MAAWA,IAAY,OAAO,SAAS,KAAK;AAE/E,YAAMC,IAASlB,EAAmB,SAAS,QACrCmB,IAAOH,IAAaD,MAAwBG,GAAQ,QAAQ,IAC5DE,IACJJ,IAAaD,IAAsBpB,EAAO,eAC1CA,EAAO,eAAeuB,GAAQ,SAAS,KAAK1B,GACxC6B,IAAMJ,MAAcC,GAAQ,OAAO,IACnCI,IACJL,IAAYtB,EAAO,gBACnBA,EAAO,gBAAgBuB,GAAQ,UAAU,KAAK1B,GAE1C+B,IAAkBX,MAAY,UAAUC,MAAkB,kBAC1DW,IAAeZ,MAAY,UAAUC,MAAkB,kBAEvDnB,IAAS;AAAA,QACb,GAAGsB;AAAA,QACH,GAAGC;AAAA,QACH,YAAY;AAAA,UACV,MAAMD,IAAaX,EAAkB,QAAQ;AAAA,UAC7C,OAAOW,IAAaX,EAAkB,QAAQ;AAAA,UAC9C,KAAKY,IAAYZ,EAAkB,QAAQ;AAAA,UAC3C,QAAQY,IAAYZ,EAAkB,QAAQ;AAAA,QAAA;AAAA,QAEhD,SAAS;AAAA,UACP,MAAMmB,IAAeJ,IAAQD;AAAA,UAC7B,OAAOK,IAAeL,IAAOC;AAAA,UAC7B,KAAKG,IAAkBD,IAASD;AAAA,UAChC,QAAQE,IAAkBF,IAAMC;AAAA,QAAA;AAAA,MAClC;AAGF,MAAAjB,EAAkB,UAAU,EAAE,GAAGW,GAAY,GAAGC,EAAA,GAChDjB,EAAmB,SAAS,WAAWN,GAAQgB,CAAK;AAAA,IAAA;AAGtD,WAAAH,EAAQ,iBAAiB,UAAUI,CAAQ,GAC3CJ,EAAQ,iBAAiB,aAAaE,CAAW,GAE1C,MAAM;AACX,MAAAF,EAAQ,oBAAoB,UAAUI,CAAQ,GAC9CJ,EAAQ,oBAAoB,aAAaE,CAAW;AAAA,IAAA;AAAA,EACtD,GACC,CAACd,GAAQG,EAAY,KAAK,CAAC,GAE1BH,IAAeO,IACZ;AAAA,IACL,KAAKJ;AAAA,IACL,WAAAI;AAAA,EAAA;AAEJ;"}
1	+ {"version":3,"file":"useScroll.mjs","sources":["../../../../src/hooks/useScroll/useScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n /** The on scroll callback /\n onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n /* The on end scroll callback /\n onStop?: (event: Event) => void;\n\n /* Offset arrived states by x pixels. /\n offset?: {\n left?: number;\n right?: number;\n top?: number;\n bottom?: number;\n };\n}\n\nexport interface UseScrollCallbackParams {\n /* The element x position /\n x: number;\n /* The element y position /\n y: number;\n /* State of scroll arrived /\n arrived: {\n left: boolean;\n right: boolean;\n top: boolean;\n bottom: boolean;\n };\n /* State of scroll direction /\n directions: {\n left: boolean;\n right: boolean;\n top: boolean;\n bottom: boolean;\n };\n}\n\nexport interface UseScroll {\n (target: HookTarget, callback?: (params: UseScrollCallbackParams, event: Event) => void): boolean;\n\n (target: HookTarget, options?: UseScrollOptions): boolean;\n\n <Target extends Element>(\n callback?: (params: UseScrollCallbackParams, event: Event) => void,\n target?: never\n ): {\n ref: StateRef<Target>;\n scrolling: boolean;\n };\n\n <Target extends Element>(\n options?: UseScrollOptions,\n target?: never\n ): {\n ref: StateRef<Target>;\n scrolling: boolean;\n };\n}\n\n/\n @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n \n @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0] The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {boolean} The state of scrolling\n \n @example\n * const scrolling = useScroll(ref, options);\n \n @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {boolean} The state of scrolling\n \n @example\n * const scrolling = useScroll(ref, () => console.log('callback'));\n \n @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0] The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n \n @example\n * const { ref, scrolling } = useScroll(options);\n \n @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n \n @example\n * const { ref, scrolling } = useScroll(() => console.log('callback'));\n /\nexport const useScroll = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (\n target\n ? typeof params[1] === 'object'\n ? params[1]\n : { onScroll: params[1] }\n : typeof params[0] === 'object'\n ? params[0]\n : { onScroll: params[0] }\n ) as UseScrollOptions \| undefined;\n\n const internalRef = useRefState<Element>();\n const internalOptionsRef = useRef(options);\n internalOptionsRef.current = options;\n\n const [scrolling, setScrolling] = useState(false);\n const scrollPositionRef = useRef({ x: 0, y: 0 });\n\n useEffect(() => {\n if (!target && !internalRef.state) return;\n const element = (target ? getElement(target) : internalRef.current) as Element;\n\n if (!element) return;\n\n const onScrollEnd = (event: Event) => {\n setScrolling(false);\n options?.onStop?.(event);\n };\n\n const onScroll = (event: Event) => {\n setScrolling(true);\n const target = (\n event.target === document ? (event.target as Document).documentElement : event.target\n ) as HTMLElement;\n\n const { display, flexDirection, direction } = target.style;\n const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n const scrollLeft = target.scrollLeft;\n let scrollTop = target.scrollTop;\n if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n const offset = internalOptionsRef.current?.offset;\n const left = scrollLeft directionMultiplier <= (offset?.left ?? 0);\n const right =\n scrollLeft * directionMultiplier + target.clientWidth >=\n target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n const top = scrollTop <= (offset?.top ?? 0);\n const bottom =\n scrollTop + target.clientHeight >=\n target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\n\n const params = {\n x: scrollLeft,\n y: scrollTop,\n directions: {\n left: scrollLeft < scrollPositionRef.current.x,\n right: scrollLeft > scrollPositionRef.current.x,\n top: scrollTop < scrollPositionRef.current.y,\n bottom: scrollTop > scrollPositionRef.current.y\n },\n arrived: {\n left: isRowReverse ? right : left,\n right: isRowReverse ? left : right,\n top: isColumnReverse ? bottom : top,\n bottom: isColumnReverse ? top : bottom\n }\n };\n\n scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\n internalOptionsRef.current?.onScroll?.(params, event);\n };\n\n element.addEventListener('scroll', onScroll);\n element.addEventListener('scrollend', onScrollEnd);\n\n return () => {\n element.removeEventListener('scroll', onScroll);\n element.removeEventListener('scrollend', onScrollEnd);\n };\n }, [target, internalRef.state]);\n\n if (target) return scrolling;\n return {\n ref: internalRef,\n scrolling\n };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse"],"mappings":";;;;AAUA,MAAMA,IAAiC,GAgH1BC,IAAa,IAAIC,MAAkB;AAC9C,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,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,IAAcC,EAAA,GACdC,IAAqBC,EAAOJ,CAAO;AACzC,EAAAG,EAAmB,UAAUH;AAE7B,QAAM,CAACK,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1CC,IAAoBJ,EAAO,EAAE,GAAG,GAAG,GAAG,GAAG;AAqE/C,SAnEAK,EAAU,MAAM;AACd,QAAI,CAACX,KAAU,CAACG,EAAY,MAAO;AACnC,UAAMS,IAAWZ,IAASa,EAAWb,CAAM,IAAIG,EAAY;AAE3D,QAAI,CAACS,EAAS;AAEd,UAAME,IAAc,CAACC,MAAiB;AACpC,MAAAP,EAAa,EAAK,GAClBN,GAAS,SAASa,CAAK;AAAA,IAAA,GAGnBC,IAAW,CAACD,MAAiB;AACjC,MAAAP,EAAa,EAAI;AACjB,YAAMR,IACJe,EAAM,WAAW,WAAYA,EAAM,OAAoB,kBAAkBA,EAAM,QAG3E,EAAE,SAAAE,GAAS,eAAAC,GAAe,WAAAC,EAAA,IAAcnB,EAAO,OAC/CoB,IAAsBD,MAAc,QAAQ,KAAK,GAEjDE,IAAarB,EAAO;AAC1B,UAAIsB,IAAYtB,EAAO;AACvB,MAAIA,aAAkB,YAAY,CAACsB,MAAWA,IAAY,OAAO,SAAS,KAAK;AAE/E,YAAMC,IAASlB,EAAmB,SAAS,QACrCmB,IAAOH,IAAaD,MAAwBG,GAAQ,QAAQ,IAC5DE,IACJJ,IAAaD,IAAsBpB,EAAO,eAC1CA,EAAO,eAAeuB,GAAQ,SAAS,KAAK1B,GACxC6B,IAAMJ,MAAcC,GAAQ,OAAO,IACnCI,IACJL,IAAYtB,EAAO,gBACnBA,EAAO,gBAAgBuB,GAAQ,UAAU,KAAK1B,GAE1C+B,IAAkBX,MAAY,UAAUC,MAAkB,kBAC1DW,IAAeZ,MAAY,UAAUC,MAAkB,kBAEvDnB,IAAS;AAAA,QACb,GAAGsB;AAAA,QACH,GAAGC;AAAA,QACH,YAAY;AAAA,UACV,MAAMD,IAAaX,EAAkB,QAAQ;AAAA,UAC7C,OAAOW,IAAaX,EAAkB,QAAQ;AAAA,UAC9C,KAAKY,IAAYZ,EAAkB,QAAQ;AAAA,UAC3C,QAAQY,IAAYZ,EAAkB,QAAQ;AAAA,QAAA;AAAA,QAEhD,SAAS;AAAA,UACP,MAAMmB,IAAeJ,IAAQD;AAAA,UAC7B,OAAOK,IAAeL,IAAOC;AAAA,UAC7B,KAAKG,IAAkBD,IAASD;AAAA,UAChC,QAAQE,IAAkBF,IAAMC;AAAA,QAAA;AAAA,MAClC;AAGF,MAAAjB,EAAkB,UAAU,EAAE,GAAGW,GAAY,GAAGC,EAAA,GAChDjB,EAAmB,SAAS,WAAWN,GAAQgB,CAAK;AAAA,IAAA;AAGtD,WAAAH,EAAQ,iBAAiB,UAAUI,CAAQ,GAC3CJ,EAAQ,iBAAiB,aAAaE,CAAW,GAE1C,MAAM;AACX,MAAAF,EAAQ,oBAAoB,UAAUI,CAAQ,GAC9CJ,EAAQ,oBAAoB,aAAaE,CAAW;AAAA,IAAA;AAAA,EACtD,GACC,CAACd,GAAQG,EAAY,KAAK,CAAC,GAE1BH,IAAeO,IACZ;AAAA,IACL,KAAKJ;AAAA,IACL,WAAAI;AAAA,EAAA;AAEJ;"}

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

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

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

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

package/dist/esm/hooks/useSpeechRecognition/useSpeechRecognition.mjs CHANGED Viewed

@@ -29,10 +29,20 @@ const f = () => window?.SpeechRecognition ?? window?.webkitSpeechRecognition, q
   });
   T(() => () => s.stop(), []);
   const g = () => s.start(), p = () => s.stop();
-  return { supported: i, transcript: A, recognition: s, final: k, listening: a, error: F, start: g, stop: p, toggle: (r = !a) => {
-    if (r) return g();
-    p();
-  } };
+  return {
+    supported: i,
+    transcript: A,
+    recognition: s,
+    final: k,
+    listening: a,
+    error: F,
+    start: g,
+    stop: p,
+    toggle: (r = !a) => {
+      if (r) return g();
+      p();
+    }
+  };
 };
 export {
   f as getSpeechRecognition,

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useSpeechRecognition.mjs","sources":["../../../../src/hooks/useSpeechRecognition/useSpeechRecognition.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech recognition hook options type /\ninterface UseSpeechRecognitionOptions {\n /* If true, recognition continues even after pauses in speech. Default is false /\n continuous?: SpeechRecognition['continuous'];\n /* A list of grammar rules /\n grammars?: SpeechRecognition['grammars'];\n /* If true, interim (non-final) results are provided as the user speaks /\n interimResults?: SpeechRecognition['interimResults'];\n /* The language in which recognition should occur. Must be a valid BCP 47 language tag (e.g., \"en-US\", \"ru-RU\") /\n language?: SpeechRecognition['lang'];\n /* The maximum number of alternative transcripts returned for a given recognition result. Must be a positive integer /\n maxAlternatives?: SpeechRecognition['maxAlternatives'];\n /* Callback invoked when speech recognition ends /\n onEnd?: () => void;\n /* Callback invoked when an error occurs during recognition /\n onError?: (error: SpeechRecognitionErrorEvent) => void;\n /* Callback invoked when recognition produces a result /\n onResult?: (event: SpeechRecognitionEvent) => void;\n /* Callback invoked when speech recognition starts /\n onStart?: () => void;\n}\n\n/* The return type of the useSpeechRecognition hook. /\ninterface UseSpeechRecognitionReturn {\n /* The error state /\n error: SpeechRecognitionErrorEvent \| null;\n /* The final transcript /\n final: boolean;\n /* Whether the hook is currently listening for speech /\n listening: boolean;\n /* The speech recognition instance /\n recognition: SpeechRecognition;\n /* Whether the current browser supports the Web Speech API /\n supported: boolean;\n /* The current transcript /\n transcript: string;\n /* Begins speech recognition /\n start: () => void;\n /* Ends speech recognition, finalizing results /\n stop: () => void;\n /* Toggles the listening state /\n toggle: (value?: boolean) => void;\n}\n\nexport const getSpeechRecognition = () =>\n window?.SpeechRecognition ?? window?.webkitSpeechRecognition;\n\n/\n @name useSpeechRecognition\n * @description - Hook that provides a streamlined interface for incorporating speech-to-text functionality\n * @category ~~Sensors~~\n \n @browserapi window.SpeechRecognition https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition\n \n @param {boolean} [options.continuous=false] Whether recognition should continue after pauses\n * @param {boolean} [options.interimResults=false] Whether interim results should be provided\n * @param {string} [options.language=\"en-US\"] The language for recognition, as a valid BCP 47 tag\n * @param {number} [options.maxAlternatives=1] The maximum number of alternative transcripts to return\n * @param {SpeechGrammarList} [options.grammars] A list of grammar rules\n * @param {() => void} [options.onStart] Callback invoked when speech recognition starts\n * @param {() => void} [options.onEnd] Callback invoked when speech recognition ends\n * @param {(error: SpeechRecognitionErrorEvent) => void} [options.onError] Callback invoked when an error occurs during recognition\n * @param {(event: SpeechRecognitionEvent) => void} [options.onResult] Callback invoked when recognition produces a result\n * @returns {UseSpeechRecognitionReturn} An object containing the speech recognition functionality\n \n @example\n * const { supported, value, recognition, listening, error, start, stop, toggle } = useSpeechRecognition();\n */\nexport const useSpeechRecognition = (\n options: UseSpeechRecognitionOptions = {}\n): UseSpeechRecognitionReturn => {\n const supported = typeof window !== 'undefined' && !!getSpeechRecognition();\n\n const {\n continuous = false,\n interimResults = false,\n language = 'en-US',\n grammars,\n maxAlternatives = 1,\n onStart,\n onEnd,\n onError,\n onResult\n } = options;\n\n const [listening, setListening] = useState(false);\n const [transcript, setTranscript] = useState('');\n const [final, setFinal] = useState(false);\n const [error, setError] = useState<SpeechRecognitionErrorEvent \| null>(null);\n const [recognition] = useState<SpeechRecognition>(() => {\n if (!supported) return {} as SpeechRecognition;\n\n const SpeechRecognition = getSpeechRecognition();\n const speechRecognition = new SpeechRecognition();\n\n speechRecognition.continuous = continuous;\n if (grammars) speechRecognition.grammars = grammars;\n speechRecognition.interimResults = interimResults;\n speechRecognition.lang = language;\n speechRecognition.maxAlternatives = maxAlternatives;\n\n speechRecognition.onstart = () => {\n setListening(true);\n setFinal(false);\n onStart?.();\n };\n speechRecognition.onend = () => {\n setListening(false);\n onEnd?.();\n };\n speechRecognition.onerror = (event) => {\n setError(event);\n setListening(false);\n onError?.(event);\n };\n speechRecognition.onresult = (event) => {\n console.log('onresult', event);\n const currentResult = event.results[event.resultIndex];\n const { transcript } = currentResult[0];\n\n setTranscript(transcript);\n setError(null);\n onResult?.(event);\n };\n speechRecognition.onend = () => {\n setListening(false);\n speechRecognition.lang = language;\n };\n\n return speechRecognition;\n });\n\n useEffect(() => () => recognition.stop(), []);\n\n const start = () => recognition.start();\n const stop = () => recognition.stop();\n\n const toggle = (value = !listening) => {\n if (value) return start();\n stop();\n };\n\n return { supported, transcript, recognition, final, listening, error, start, stop, toggle };\n};\n"],"names":["getSpeechRecognition","useSpeechRecognition","options","supported","continuous","interimResults","language","grammars","maxAlternatives","onStart","onEnd","onError","onResult","listening","setListening","useState","transcript","setTranscript","final","setFinal","error","setError","recognition","SpeechRecognition","speechRecognition","event","currentResult","useEffect","start","stop","value"],"mappings":";AA8CO,MAAMA,IAAuB,MAClC,QAAQ,qBAAqB,QAAQ,yBAuB1BC,IAAuB,CAClCC,IAAuC,OACR;AAC/B,QAAMC,IAAY,OAAO,SAAW,OAAe,CAAC,CAACH,EAAA,GAE/C;AAAA,IACJ,YAAAI,IAAa;AAAA,IACb,gBAAAC,IAAiB;AAAA,IACjB,UAAAC,IAAW;AAAA,IACX,UAAAC;AAAA,IACA,iBAAAC,IAAkB;AAAA,IAClB,SAAAC;AAAA,IACA,OAAAC;AAAA,IACA,SAAAC;AAAA,IACA,UAAAC;AAAA,EAAA,IACEV,GAEE,CAACW,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1C,CAACC,GAAYC,CAAa,IAAIF,EAAS,EAAE,GACzC,CAACG,GAAOC,CAAQ,IAAIJ,EAAS,EAAK,GAClC,CAACK,GAAOC,CAAQ,IAAIN,EAA6C,IAAI,GACrE,CAACO,CAAW,IAAIP,EAA4B,MAAM;AACtD,QAAI,CAACZ,EAAW,QAAO,CAAA;AAEvB,UAAMoB,IAAoBvB,EAAA,GACpBwB,IAAoB,IAAID,EAAA;AAE9B,WAAAC,EAAkB,aAAapB,GAC3BG,QAA4B,WAAWA,IAC3CiB,EAAkB,iBAAiBnB,GACnCmB,EAAkB,OAAOlB,GACzBkB,EAAkB,kBAAkBhB,GAEpCgB,EAAkB,UAAU,MAAM;AAChC,MAAAV,EAAa,EAAI,GACjBK,EAAS,EAAK,GACdV,IAAA;AAAA,IAAU,GAEZe,EAAkB,QAAQ,MAAM;AAC9B,MAAAV,EAAa,EAAK,GAClBJ,IAAA;AAAA,IAAQ,GAEVc,EAAkB,UAAU,CAACC,MAAU;AACrC,MAAAJ,EAASI,CAAK,GACdX,EAAa,EAAK,GAClBH,IAAUc,CAAK;AAAA,IAAA,GAEjBD,EAAkB,WAAW,CAACC,MAAU;AACtC,cAAQ,IAAI,YAAYA,CAAK;AAC7B,YAAMC,IAAgBD,EAAM,QAAQA,EAAM,WAAW,GAC/C,EAAE,YAAAT,MAAeU,EAAc,CAAC;AAEtC,MAAAT,EAAcD,CAAU,GACxBK,EAAS,IAAI,GACbT,IAAWa,CAAK;AAAA,IAAA,GAElBD,EAAkB,QAAQ,MAAM;AAC9B,MAAAV,EAAa,EAAK,GAClBU,EAAkB,OAAOlB;AAAA,IAAA,GAGpBkB;AAAA,EAAA,CACR;AAED,EAAAG,EAAU,MAAM,MAAML,EAAY,KAAA,GAAQ,CAAA,CAAE;AAE5C,QAAMM,IAAQ,MAAMN,EAAY,MAAA,GAC1BO,IAAO,MAAMP,EAAY,KAAA;AAO/B,SAAO,~~EAAE~~,WAAAnB,~~GAAW~~,YAAAa,~~GAAY~~,aAAAM,~~GAAa~~,OAAAJ,~~GAAO~~,WAAAL,~~GAAW~~,OAAAO,~~GAAO~~,OAAAQ,~~GAAO~~,MAAAC,~~GAAM~~,~~QALpE~~,CAACC,IAAQ,CAACjB,MAAc;AACrC,~~QAAIiB~~,UAAcF,EAAA;AAClB,~~IAAAC~~,EAAA;AAAA,~~EAAK~~,~~EAG4E~~;~~AACrF~~;"}
1	+ {"version":3,"file":"useSpeechRecognition.mjs","sources":["../../../../src/hooks/useSpeechRecognition/useSpeechRecognition.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech recognition hook options type /\ninterface UseSpeechRecognitionOptions {\n /* If true, recognition continues even after pauses in speech. Default is false /\n continuous?: SpeechRecognition['continuous'];\n /* A list of grammar rules /\n grammars?: SpeechRecognition['grammars'];\n /* If true, interim (non-final) results are provided as the user speaks /\n interimResults?: SpeechRecognition['interimResults'];\n /* The language in which recognition should occur. Must be a valid BCP 47 language tag (e.g., \"en-US\", \"ru-RU\") /\n language?: SpeechRecognition['lang'];\n /* The maximum number of alternative transcripts returned for a given recognition result. Must be a positive integer /\n maxAlternatives?: SpeechRecognition['maxAlternatives'];\n /* Callback invoked when speech recognition ends /\n onEnd?: () => void;\n /* Callback invoked when an error occurs during recognition /\n onError?: (error: SpeechRecognitionErrorEvent) => void;\n /* Callback invoked when recognition produces a result /\n onResult?: (event: SpeechRecognitionEvent) => void;\n /* Callback invoked when speech recognition starts /\n onStart?: () => void;\n}\n\n/* The return type of the useSpeechRecognition hook. /\ninterface UseSpeechRecognitionReturn {\n /* The error state /\n error: SpeechRecognitionErrorEvent \| null;\n /* The final transcript /\n final: boolean;\n /* Whether the hook is currently listening for speech /\n listening: boolean;\n /* The speech recognition instance /\n recognition: SpeechRecognition;\n /* Whether the current browser supports the Web Speech API /\n supported: boolean;\n /* The current transcript /\n transcript: string;\n /* Begins speech recognition /\n start: () => void;\n /* Ends speech recognition, finalizing results /\n stop: () => void;\n /* Toggles the listening state /\n toggle: (value?: boolean) => void;\n}\n\nexport const getSpeechRecognition = () =>\n window?.SpeechRecognition ?? window?.webkitSpeechRecognition;\n\n/\n @name useSpeechRecognition\n * @description - Hook that provides a streamlined interface for incorporating speech-to-text functionality\n * @category Browser\n \n @browserapi window.SpeechRecognition https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition\n \n @param {boolean} [options.continuous=false] Whether recognition should continue after pauses\n * @param {boolean} [options.interimResults=false] Whether interim results should be provided\n * @param {string} [options.language=\"en-US\"] The language for recognition, as a valid BCP 47 tag\n * @param {number} [options.maxAlternatives=1] The maximum number of alternative transcripts to return\n * @param {SpeechGrammarList} [options.grammars] A list of grammar rules\n * @param {() => void} [options.onStart] Callback invoked when speech recognition starts\n * @param {() => void} [options.onEnd] Callback invoked when speech recognition ends\n * @param {(error: SpeechRecognitionErrorEvent) => void} [options.onError] Callback invoked when an error occurs during recognition\n * @param {(event: SpeechRecognitionEvent) => void} [options.onResult] Callback invoked when recognition produces a result\n * @returns {UseSpeechRecognitionReturn} An object containing the speech recognition functionality\n \n @example\n * const { supported, value, recognition, listening, error, start, stop, toggle } = useSpeechRecognition();\n */\nexport const useSpeechRecognition = (\n options: UseSpeechRecognitionOptions = {}\n): UseSpeechRecognitionReturn => {\n const supported = typeof window !== 'undefined' && !!getSpeechRecognition();\n\n const {\n continuous = false,\n interimResults = false,\n language = 'en-US',\n grammars,\n maxAlternatives = 1,\n onStart,\n onEnd,\n onError,\n onResult\n } = options;\n\n const [listening, setListening] = useState(false);\n const [transcript, setTranscript] = useState('');\n const [final, setFinal] = useState(false);\n const [error, setError] = useState<SpeechRecognitionErrorEvent \| null>(null);\n const [recognition] = useState<SpeechRecognition>(() => {\n if (!supported) return {} as SpeechRecognition;\n\n const SpeechRecognition = getSpeechRecognition();\n const speechRecognition = new SpeechRecognition();\n\n speechRecognition.continuous = continuous;\n if (grammars) speechRecognition.grammars = grammars;\n speechRecognition.interimResults = interimResults;\n speechRecognition.lang = language;\n speechRecognition.maxAlternatives = maxAlternatives;\n\n speechRecognition.onstart = () => {\n setListening(true);\n setFinal(false);\n onStart?.();\n };\n speechRecognition.onend = () => {\n setListening(false);\n onEnd?.();\n };\n speechRecognition.onerror = (event) => {\n setError(event);\n setListening(false);\n onError?.(event);\n };\n speechRecognition.onresult = (event) => {\n console.log('onresult', event);\n const currentResult = event.results[event.resultIndex];\n const { transcript } = currentResult[0];\n\n setTranscript(transcript);\n setError(null);\n onResult?.(event);\n };\n speechRecognition.onend = () => {\n setListening(false);\n speechRecognition.lang = language;\n };\n\n return speechRecognition;\n });\n\n useEffect(() => () => recognition.stop(), []);\n\n const start = () => recognition.start();\n const stop = () => recognition.stop();\n\n const toggle = (value = !listening) => {\n if (value) return start();\n stop();\n };\n\n return {\n supported,\n transcript,\n recognition,\n final,\n listening,\n error,\n start,\n stop,\n toggle\n };\n};\n"],"names":["getSpeechRecognition","useSpeechRecognition","options","supported","continuous","interimResults","language","grammars","maxAlternatives","onStart","onEnd","onError","onResult","listening","setListening","useState","transcript","setTranscript","final","setFinal","error","setError","recognition","SpeechRecognition","speechRecognition","event","currentResult","useEffect","start","stop","value"],"mappings":";AA8CO,MAAMA,IAAuB,MAClC,QAAQ,qBAAqB,QAAQ,yBAuB1BC,IAAuB,CAClCC,IAAuC,OACR;AAC/B,QAAMC,IAAY,OAAO,SAAW,OAAe,CAAC,CAACH,EAAA,GAE/C;AAAA,IACJ,YAAAI,IAAa;AAAA,IACb,gBAAAC,IAAiB;AAAA,IACjB,UAAAC,IAAW;AAAA,IACX,UAAAC;AAAA,IACA,iBAAAC,IAAkB;AAAA,IAClB,SAAAC;AAAA,IACA,OAAAC;AAAA,IACA,SAAAC;AAAA,IACA,UAAAC;AAAA,EAAA,IACEV,GAEE,CAACW,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1C,CAACC,GAAYC,CAAa,IAAIF,EAAS,EAAE,GACzC,CAACG,GAAOC,CAAQ,IAAIJ,EAAS,EAAK,GAClC,CAACK,GAAOC,CAAQ,IAAIN,EAA6C,IAAI,GACrE,CAACO,CAAW,IAAIP,EAA4B,MAAM;AACtD,QAAI,CAACZ,EAAW,QAAO,CAAA;AAEvB,UAAMoB,IAAoBvB,EAAA,GACpBwB,IAAoB,IAAID,EAAA;AAE9B,WAAAC,EAAkB,aAAapB,GAC3BG,QAA4B,WAAWA,IAC3CiB,EAAkB,iBAAiBnB,GACnCmB,EAAkB,OAAOlB,GACzBkB,EAAkB,kBAAkBhB,GAEpCgB,EAAkB,UAAU,MAAM;AAChC,MAAAV,EAAa,EAAI,GACjBK,EAAS,EAAK,GACdV,IAAA;AAAA,IAAU,GAEZe,EAAkB,QAAQ,MAAM;AAC9B,MAAAV,EAAa,EAAK,GAClBJ,IAAA;AAAA,IAAQ,GAEVc,EAAkB,UAAU,CAACC,MAAU;AACrC,MAAAJ,EAASI,CAAK,GACdX,EAAa,EAAK,GAClBH,IAAUc,CAAK;AAAA,IAAA,GAEjBD,EAAkB,WAAW,CAACC,MAAU;AACtC,cAAQ,IAAI,YAAYA,CAAK;AAC7B,YAAMC,IAAgBD,EAAM,QAAQA,EAAM,WAAW,GAC/C,EAAE,YAAAT,MAAeU,EAAc,CAAC;AAEtC,MAAAT,EAAcD,CAAU,GACxBK,EAAS,IAAI,GACbT,IAAWa,CAAK;AAAA,IAAA,GAElBD,EAAkB,QAAQ,MAAM;AAC9B,MAAAV,EAAa,EAAK,GAClBU,EAAkB,OAAOlB;AAAA,IAAA,GAGpBkB;AAAA,EAAA,CACR;AAED,EAAAG,EAAU,MAAM,MAAML,EAAY,KAAA,GAAQ,CAAA,CAAE;AAE5C,QAAMM,IAAQ,MAAMN,EAAY,MAAA,GAC1BO,IAAO,MAAMP,EAAY,KAAA;AAO/B,SAAO;AAAA,IACL,WAAAnB;AAAA,IACA,YAAAa;AAAA,IACA,aAAAM;AAAA,IACA,OAAAJ;AAAA,IACA,WAAAL;AAAA,IACA,OAAAO;AAAA,IACA,OAAAQ;AAAA,IACA,MAAAC;AAAA,IACA,QAda,CAACC,IAAQ,CAACjB,MAAc;AACrC,UAAIiB,UAAcF,EAAA;AAClB,MAAAC,EAAA;AAAA,IAAK;AAAA,EAYL;AAEJ;"}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useSpeechSynthesis.mjs","sources":["../../../../src/hooks/useSpeechSynthesis/useSpeechSynthesis.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** The use speech synthesis status type /\nexport type UseSpeechSynthesisStatus = 'end' \| 'init' \| 'pause' \| 'play';\n\n/* The use speech synthesis options type /\nexport interface UseSpeechSynthesisOptions {\n /* Language for SpeechSynthesis /\n lang?: string;\n /* Gets and sets the pitch at which the utterance will be spoken at. /\n pitch?: number;\n /* Gets and sets the speed at which the utterance will be spoken at. /\n rate?: number;\n /* The text to be spoken /\n text?: string;\n /* Gets and sets the voice that will be used to speak the utterance. /\n voice?: SpeechSynthesisVoice \| null;\n /* Gets and sets the volume that the utterance will be spoken at. /\n volume?: number;\n}\n\n/* The use speech synthesis return type /\nexport interface UseSpeechSynthesisReturn {\n /* Any error that occurred during speech synthesis. /\n error: SpeechSynthesisErrorEvent \| undefined;\n /* Indicates if speech is currently playing. /\n playing: boolean;\n /* The current status of speech synthesis. /\n status: UseSpeechSynthesisStatus;\n /* Indicates if the SpeechSynthesis API is supported in the current environment. /\n supported: boolean;\n /* The SpeechSynthesisUtterance instance. /\n utterance: SpeechSynthesisUtterance \| null;\n /* Function to pause speech synthesis. /\n pause: () => void;\n /* Function to resume speech synthesis. /\n resume: () => void;\n /* Function to start speech synthesis. /\n speak: () => void;\n /* Function to stop speech synthesis. /\n stop: () => void;\n /* Function to toggle between play and pause. /\n toggle: (value?: boolean) => void;\n}\n\n/\n @name useSpeechSynthesis\n * @description - Hook that provides speech synthesis functionality\n * @category ~~Sensors~~\n \n @browserapi SpeechSynthesis https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis\n \n @params {string} [options.text] - The text to be spoken\n * @params {string} [options.lang] - The language to be spoken\n * @params {number} [options.pitch] - The pitch to be spoken\n * @params {number} [options.rate] - The rate to be spoken\n * @params {SpeechSynthesisVoice} [options.voice] - The voice to be spoken\n * @params {number} [options.volume] - The volume to be spoken\n * @returns {UseSpeechSynthesisReturn} An object containing the speech synthesis state and control methods\n \n @example\n * const { supported, playing, status, utterance, error, stop, toggle, speak, resume, pause } = useSpeechSynthesis();\n */\nexport const useSpeechSynthesis = (\n options: UseSpeechSynthesisOptions = {}\n): UseSpeechSynthesisReturn => {\n const supported = typeof window !== 'undefined' && 'speechSynthesis' in window;\n\n const { text = '', lang = 'en-US', pitch = 1, rate = 1, voice = null, volume = 1 } = options;\n\n const [playing, setPlaying] = useState(false);\n const [status, setStatus] = useState<UseSpeechSynthesisStatus>('init');\n const [error, setError] = useState<SpeechSynthesisErrorEvent>();\n const speechSynthesisUtteranceRef = useRef<SpeechSynthesisUtterance \| null>(null);\n\n const bindSpeechSynthesisUtterance = (speechSynthesisUtterance: SpeechSynthesisUtterance) => {\n speechSynthesisUtterance.lang = lang;\n speechSynthesisUtterance.pitch = pitch;\n speechSynthesisUtterance.rate = rate;\n speechSynthesisUtterance.volume = volume;\n speechSynthesisUtterance.voice = voice;\n\n speechSynthesisUtterance.onstart = () => {\n setPlaying(true);\n setStatus('play');\n };\n\n speechSynthesisUtterance.onpause = () => {\n setPlaying(false);\n setStatus('pause');\n };\n\n speechSynthesisUtterance.onresume = () => {\n setPlaying(true);\n setStatus('play');\n };\n\n speechSynthesisUtterance.onend = () => {\n setPlaying(false);\n setStatus('end');\n };\n\n speechSynthesisUtterance.onerror = (event) => {\n setPlaying(false);\n setError(event);\n };\n };\n\n useEffect(() => {\n if (!supported) return;\n\n const speechSynthesisUtterance = new SpeechSynthesisUtterance(text);\n bindSpeechSynthesisUtterance(speechSynthesisUtterance);\n speechSynthesisUtteranceRef.current = speechSynthesisUtterance;\n\n return () => {\n window.speechSynthesis?.cancel();\n };\n }, [text, lang, pitch, rate, voice, volume]);\n\n const speak = (text?: string) => {\n if (!supported) return;\n\n if (text) {\n speechSynthesisUtteranceRef.current = new SpeechSynthesisUtterance(text);\n bindSpeechSynthesisUtterance(speechSynthesisUtteranceRef.current);\n }\n\n window.speechSynthesis?.cancel();\n if (speechSynthesisUtteranceRef.current)\n window.speechSynthesis?.speak(speechSynthesisUtteranceRef.current);\n };\n\n const stop = () => {\n if (!supported) return;\n\n window.speechSynthesis?.cancel();\n setPlaying(false);\n };\n\n const toggle = (value = !playing) => {\n if (!supported) return;\n\n if (value) {\n window.speechSynthesis?.resume();\n } else {\n window.speechSynthesis?.pause();\n }\n setPlaying(value);\n };\n\n const resume = () => {\n setPlaying(true);\n window.speechSynthesis?.resume();\n };\n\n const pause = () => {\n setPlaying(false);\n window.speechSynthesis?.pause();\n };\n\n return {\n supported,\n playing,\n status,\n utterance: speechSynthesisUtteranceRef.current,\n error,\n\n stop,\n toggle,\n speak,\n resume,\n pause\n };\n};\n"],"names":["useSpeechSynthesis","options","supported","text","lang","pitch","rate","voice","volume","playing","setPlaying","useState","status","setStatus","error","setError","speechSynthesisUtteranceRef","useRef","bindSpeechSynthesisUtterance","speechSynthesisUtterance","event","useEffect","speak","stop","toggle","value","resume","pause"],"mappings":";AA+DO,MAAMA,IAAqB,CAChCC,IAAqC,OACR;AAC7B,QAAMC,IAAY,OAAO,SAAW,OAAe,qBAAqB,QAElE,EAAE,MAAAC,IAAO,IAAI,MAAAC,IAAO,SAAS,OAAAC,IAAQ,GAAG,MAAAC,IAAO,GAAG,OAAAC,IAAQ,MAAM,QAAAC,IAAS,MAAMP,GAE/E,CAACQ,GAASC,CAAU,IAAIC,EAAS,EAAK,GACtC,CAACC,GAAQC,CAAS,IAAIF,EAAmC,MAAM,GAC/D,CAACG,GAAOC,CAAQ,IAAIJ,EAAA,GACpBK,IAA8BC,EAAwC,IAAI,GAE1EC,IAA+B,CAACC,MAAuD;AAC3F,IAAAA,EAAyB,OAAOf,GAChCe,EAAyB,QAAQd,GACjCc,EAAyB,OAAOb,GAChCa,EAAyB,SAASX,GAClCW,EAAyB,QAAQZ,GAEjCY,EAAyB,UAAU,MAAM;AACvC,MAAAT,EAAW,EAAI,GACfG,EAAU,MAAM;AAAA,IAAA,GAGlBM,EAAyB,UAAU,MAAM;AACvC,MAAAT,EAAW,EAAK,GAChBG,EAAU,OAAO;AAAA,IAAA,GAGnBM,EAAyB,WAAW,MAAM;AACxC,MAAAT,EAAW,EAAI,GACfG,EAAU,MAAM;AAAA,IAAA,GAGlBM,EAAyB,QAAQ,MAAM;AACrC,MAAAT,EAAW,EAAK,GAChBG,EAAU,KAAK;AAAA,IAAA,GAGjBM,EAAyB,UAAU,CAACC,MAAU;AAC5C,MAAAV,EAAW,EAAK,GAChBK,EAASK,CAAK;AAAA,IAAA;AAAA,EAChB;AAGF,EAAAC,EAAU,MAAM;AACd,QAAI,CAACnB,EAAW;AAEhB,UAAMiB,IAA2B,IAAI,yBAAyBhB,CAAI;AAClE,WAAAe,EAA6BC,CAAwB,GACrDH,EAA4B,UAAUG,GAE/B,MAAM;AACX,aAAO,iBAAiB,OAAA;AAAA,IAAO;AAAA,EACjC,GACC,CAAChB,GAAMC,GAAMC,GAAOC,GAAMC,GAAOC,CAAM,CAAC;AAE3C,QAAMc,IAAQ,CAACnB,MAAkB;AAC/B,IAAKD,MAEDC,MACFa,EAA4B,UAAU,IAAI,yBAAyBb,CAAI,GACvEe,EAA6BF,EAA4B,OAAO,IAGlE,OAAO,iBAAiB,OAAA,GACpBA,EAA4B,WAC9B,OAAO,iBAAiB,MAAMA,EAA4B,OAAO;AAAA,EAAA,GAG/DO,IAAO,MAAM;AACjB,IAAKrB,MAEL,OAAO,iBAAiB,OAAA,GACxBQ,EAAW,EAAK;AAAA,EAAA,GAGZc,IAAS,CAACC,IAAQ,CAAChB,MAAY;AACnC,IAAKP,MAEDuB,IACF,OAAO,iBAAiB,OAAA,IAExB,OAAO,iBAAiB,MAAA,GAE1Bf,EAAWe,CAAK;AAAA,EAAA,GAGZC,IAAS,MAAM;AACnB,IAAAhB,EAAW,EAAI,GACf,OAAO,iBAAiB,OAAA;AAAA,EAAO,GAG3BiB,IAAQ,MAAM;AAClB,IAAAjB,EAAW,EAAK,GAChB,OAAO,iBAAiB,MAAA;AAAA,EAAM;AAGhC,SAAO;AAAA,IACL,WAAAR;AAAA,IACA,SAAAO;AAAA,IACA,QAAAG;AAAA,IACA,WAAWI,EAA4B;AAAA,IACvC,OAAAF;AAAA,IAEA,MAAAS;AAAA,IACA,QAAAC;AAAA,IACA,OAAAF;AAAA,IACA,QAAAI;AAAA,IACA,OAAAC;AAAA,EAAA;AAEJ;"}
1	+ {"version":3,"file":"useSpeechSynthesis.mjs","sources":["../../../../src/hooks/useSpeechSynthesis/useSpeechSynthesis.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** The use speech synthesis status type /\nexport type UseSpeechSynthesisStatus = 'end' \| 'init' \| 'pause' \| 'play';\n\n/* The use speech synthesis options type /\nexport interface UseSpeechSynthesisOptions {\n /* Language for SpeechSynthesis /\n lang?: string;\n /* Gets and sets the pitch at which the utterance will be spoken at. /\n pitch?: number;\n /* Gets and sets the speed at which the utterance will be spoken at. /\n rate?: number;\n /* The text to be spoken /\n text?: string;\n /* Gets and sets the voice that will be used to speak the utterance. /\n voice?: SpeechSynthesisVoice \| null;\n /* Gets and sets the volume that the utterance will be spoken at. /\n volume?: number;\n}\n\n/* The use speech synthesis return type /\nexport interface UseSpeechSynthesisReturn {\n /* Any error that occurred during speech synthesis. /\n error: SpeechSynthesisErrorEvent \| undefined;\n /* Indicates if speech is currently playing. /\n playing: boolean;\n /* The current status of speech synthesis. /\n status: UseSpeechSynthesisStatus;\n /* Indicates if the SpeechSynthesis API is supported in the current environment. /\n supported: boolean;\n /* The SpeechSynthesisUtterance instance. /\n utterance: SpeechSynthesisUtterance \| null;\n /* Function to pause speech synthesis. /\n pause: () => void;\n /* Function to resume speech synthesis. /\n resume: () => void;\n /* Function to start speech synthesis. /\n speak: () => void;\n /* Function to stop speech synthesis. /\n stop: () => void;\n /* Function to toggle between play and pause. /\n toggle: (value?: boolean) => void;\n}\n\n/\n @name useSpeechSynthesis\n * @description - Hook that provides speech synthesis functionality\n * @category Browser\n \n @browserapi SpeechSynthesis https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis\n \n @params {string} [options.text] - The text to be spoken\n * @params {string} [options.lang] - The language to be spoken\n * @params {number} [options.pitch] - The pitch to be spoken\n * @params {number} [options.rate] - The rate to be spoken\n * @params {SpeechSynthesisVoice} [options.voice] - The voice to be spoken\n * @params {number} [options.volume] - The volume to be spoken\n * @returns {UseSpeechSynthesisReturn} An object containing the speech synthesis state and control methods\n \n @example\n * const { supported, playing, status, utterance, error, stop, toggle, speak, resume, pause } = useSpeechSynthesis();\n */\nexport const useSpeechSynthesis = (\n options: UseSpeechSynthesisOptions = {}\n): UseSpeechSynthesisReturn => {\n const supported = typeof window !== 'undefined' && 'speechSynthesis' in window;\n\n const { text = '', lang = 'en-US', pitch = 1, rate = 1, voice = null, volume = 1 } = options;\n\n const [playing, setPlaying] = useState(false);\n const [status, setStatus] = useState<UseSpeechSynthesisStatus>('init');\n const [error, setError] = useState<SpeechSynthesisErrorEvent>();\n const speechSynthesisUtteranceRef = useRef<SpeechSynthesisUtterance \| null>(null);\n\n const bindSpeechSynthesisUtterance = (speechSynthesisUtterance: SpeechSynthesisUtterance) => {\n speechSynthesisUtterance.lang = lang;\n speechSynthesisUtterance.pitch = pitch;\n speechSynthesisUtterance.rate = rate;\n speechSynthesisUtterance.volume = volume;\n speechSynthesisUtterance.voice = voice;\n\n speechSynthesisUtterance.onstart = () => {\n setPlaying(true);\n setStatus('play');\n };\n\n speechSynthesisUtterance.onpause = () => {\n setPlaying(false);\n setStatus('pause');\n };\n\n speechSynthesisUtterance.onresume = () => {\n setPlaying(true);\n setStatus('play');\n };\n\n speechSynthesisUtterance.onend = () => {\n setPlaying(false);\n setStatus('end');\n };\n\n speechSynthesisUtterance.onerror = (event) => {\n setPlaying(false);\n setError(event);\n };\n };\n\n useEffect(() => {\n if (!supported) return;\n\n const speechSynthesisUtterance = new SpeechSynthesisUtterance(text);\n bindSpeechSynthesisUtterance(speechSynthesisUtterance);\n speechSynthesisUtteranceRef.current = speechSynthesisUtterance;\n\n return () => {\n window.speechSynthesis?.cancel();\n };\n }, [text, lang, pitch, rate, voice, volume]);\n\n const speak = (text?: string) => {\n if (!supported) return;\n\n if (text) {\n speechSynthesisUtteranceRef.current = new SpeechSynthesisUtterance(text);\n bindSpeechSynthesisUtterance(speechSynthesisUtteranceRef.current);\n }\n\n window.speechSynthesis?.cancel();\n if (speechSynthesisUtteranceRef.current)\n window.speechSynthesis?.speak(speechSynthesisUtteranceRef.current);\n };\n\n const stop = () => {\n if (!supported) return;\n\n window.speechSynthesis?.cancel();\n setPlaying(false);\n };\n\n const toggle = (value = !playing) => {\n if (!supported) return;\n\n if (value) {\n window.speechSynthesis?.resume();\n } else {\n window.speechSynthesis?.pause();\n }\n setPlaying(value);\n };\n\n const resume = () => {\n setPlaying(true);\n window.speechSynthesis?.resume();\n };\n\n const pause = () => {\n setPlaying(false);\n window.speechSynthesis?.pause();\n };\n\n return {\n supported,\n playing,\n status,\n utterance: speechSynthesisUtteranceRef.current,\n error,\n\n stop,\n toggle,\n speak,\n resume,\n pause\n };\n};\n"],"names":["useSpeechSynthesis","options","supported","text","lang","pitch","rate","voice","volume","playing","setPlaying","useState","status","setStatus","error","setError","speechSynthesisUtteranceRef","useRef","bindSpeechSynthesisUtterance","speechSynthesisUtterance","event","useEffect","speak","stop","toggle","value","resume","pause"],"mappings":";AA+DO,MAAMA,IAAqB,CAChCC,IAAqC,OACR;AAC7B,QAAMC,IAAY,OAAO,SAAW,OAAe,qBAAqB,QAElE,EAAE,MAAAC,IAAO,IAAI,MAAAC,IAAO,SAAS,OAAAC,IAAQ,GAAG,MAAAC,IAAO,GAAG,OAAAC,IAAQ,MAAM,QAAAC,IAAS,MAAMP,GAE/E,CAACQ,GAASC,CAAU,IAAIC,EAAS,EAAK,GACtC,CAACC,GAAQC,CAAS,IAAIF,EAAmC,MAAM,GAC/D,CAACG,GAAOC,CAAQ,IAAIJ,EAAA,GACpBK,IAA8BC,EAAwC,IAAI,GAE1EC,IAA+B,CAACC,MAAuD;AAC3F,IAAAA,EAAyB,OAAOf,GAChCe,EAAyB,QAAQd,GACjCc,EAAyB,OAAOb,GAChCa,EAAyB,SAASX,GAClCW,EAAyB,QAAQZ,GAEjCY,EAAyB,UAAU,MAAM;AACvC,MAAAT,EAAW,EAAI,GACfG,EAAU,MAAM;AAAA,IAAA,GAGlBM,EAAyB,UAAU,MAAM;AACvC,MAAAT,EAAW,EAAK,GAChBG,EAAU,OAAO;AAAA,IAAA,GAGnBM,EAAyB,WAAW,MAAM;AACxC,MAAAT,EAAW,EAAI,GACfG,EAAU,MAAM;AAAA,IAAA,GAGlBM,EAAyB,QAAQ,MAAM;AACrC,MAAAT,EAAW,EAAK,GAChBG,EAAU,KAAK;AAAA,IAAA,GAGjBM,EAAyB,UAAU,CAACC,MAAU;AAC5C,MAAAV,EAAW,EAAK,GAChBK,EAASK,CAAK;AAAA,IAAA;AAAA,EAChB;AAGF,EAAAC,EAAU,MAAM;AACd,QAAI,CAACnB,EAAW;AAEhB,UAAMiB,IAA2B,IAAI,yBAAyBhB,CAAI;AAClE,WAAAe,EAA6BC,CAAwB,GACrDH,EAA4B,UAAUG,GAE/B,MAAM;AACX,aAAO,iBAAiB,OAAA;AAAA,IAAO;AAAA,EACjC,GACC,CAAChB,GAAMC,GAAMC,GAAOC,GAAMC,GAAOC,CAAM,CAAC;AAE3C,QAAMc,IAAQ,CAACnB,MAAkB;AAC/B,IAAKD,MAEDC,MACFa,EAA4B,UAAU,IAAI,yBAAyBb,CAAI,GACvEe,EAA6BF,EAA4B,OAAO,IAGlE,OAAO,iBAAiB,OAAA,GACpBA,EAA4B,WAC9B,OAAO,iBAAiB,MAAMA,EAA4B,OAAO;AAAA,EAAA,GAG/DO,IAAO,MAAM;AACjB,IAAKrB,MAEL,OAAO,iBAAiB,OAAA,GACxBQ,EAAW,EAAK;AAAA,EAAA,GAGZc,IAAS,CAACC,IAAQ,CAAChB,MAAY;AACnC,IAAKP,MAEDuB,IACF,OAAO,iBAAiB,OAAA,IAExB,OAAO,iBAAiB,MAAA,GAE1Bf,EAAWe,CAAK;AAAA,EAAA,GAGZC,IAAS,MAAM;AACnB,IAAAhB,EAAW,EAAI,GACf,OAAO,iBAAiB,OAAA;AAAA,EAAO,GAG3BiB,IAAQ,MAAM;AAClB,IAAAjB,EAAW,EAAK,GAChB,OAAO,iBAAiB,MAAA;AAAA,EAAM;AAGhC,SAAO;AAAA,IACL,WAAAR;AAAA,IACA,SAAAO;AAAA,IACA,QAAAG;AAAA,IACA,WAAWI,EAA4B;AAAA,IACvC,OAAAF;AAAA,IAEA,MAAAS;AAAA,IACA,QAAAC;AAAA,IACA,OAAAF;AAAA,IACA,QAAAI;AAAA,IACA,OAAAC;AAAA,EAAA;AAEJ;"}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useStateHistory.mjs","sources":["../../../../src/hooks/useStateHistory/useStateHistory.ts"],"sourcesContent":["import { useReducer } from 'react';\n\n/** The use state history hook return type /\ninterface UseStateHistoryReturn<Value> {\n /* True if a redo operation can be performed /\n canRedo: boolean;\n /* True if an undo operation can be performed /\n canUndo: boolean;\n /* All history values /\n history: Value[];\n /* Current index in history /\n index: number;\n /* Current value /\n value: Value;\n /* Go back specified number of steps in history (default: 1) /\n back: (steps?: number) => void;\n /* Go forward specified number of steps in history (default: 1) /\n forward: (steps?: number) => void;\n /* Redo the last change /\n redo: () => void;\n /* Reset history to initial state /\n reset: () => void;\n /* Set a new value /\n set: (value: Value) => void;\n /* Undo the last change /\n undo: () => void;\n}\n\nexport type StateHistoryAction<Value> =\n \| { type: 'BACK'; payload: { steps: number } }\n \| { type: 'FORWARD'; payload: { steps: number } }\n \| { type: 'REDO' }\n \| { type: 'RESET'; payload: { initialValue: Value; capacity: number } }\n \| { type: 'SET'; payload: { value: Value; capacity: number } }\n \| { type: 'UNDO' };\n\nexport interface StateHistory<Value> {\n currentIndex: number;\n history: Value[];\n redoStack: Value[][];\n undoStack: Value[][];\n}\n\nexport const stateHistoryReducer = <Value>(\n state: StateHistory<Value>,\n action: StateHistoryAction<Value>\n): StateHistory<Value> => {\n switch (action.type) {\n case 'SET': {\n const { value, capacity } = action.payload;\n\n const newHistory = [...state.history.slice(0, state.currentIndex + 1), value];\n if (newHistory.length > capacity) {\n newHistory.shift();\n }\n\n const newUndoStack = [state.history, ...state.undoStack];\n if (newUndoStack.length > capacity) {\n newUndoStack.pop();\n }\n\n return {\n history: newHistory,\n currentIndex: newHistory.length - 1,\n undoStack: newUndoStack,\n redoStack: []\n };\n }\n\n case 'UNDO': {\n if (state.undoStack.length === 0) return state;\n\n return {\n history: state.undoStack[0],\n currentIndex: state.undoStack[0].length - 1,\n undoStack: state.undoStack.slice(1),\n redoStack: [state.history, ...state.redoStack]\n };\n }\n\n case 'REDO': {\n if (state.redoStack.length === 0) return state;\n\n return {\n history: state.redoStack[0],\n currentIndex: state.redoStack[0].length - 1,\n undoStack: [state.history, ...state.undoStack],\n redoStack: state.redoStack.slice(1)\n };\n }\n\n case 'BACK': {\n const { steps } = action.payload;\n return {\n ...state,\n currentIndex: Math.max(0, state.currentIndex - steps)\n };\n }\n\n case 'FORWARD': {\n const { steps } = action.payload;\n return {\n ...state,\n currentIndex: Math.min(state.currentIndex + steps, state.history.length - 1)\n };\n }\n\n case 'RESET': {\n const { initialValue, capacity } = action.payload;\n if (state.history.length === 1) return state;\n\n const newUndoStack = [state.history, ...state.undoStack];\n if (newUndoStack.length > capacity) {\n newUndoStack.pop();\n }\n\n return {\n history: [initialValue],\n currentIndex: 0,\n undoStack: newUndoStack,\n redoStack: []\n };\n }\n\n default:\n throw new Error('Unsupported action type');\n }\n};\n\n/\n @name useStateHistory\n * @description - Hook that manages state with history functionality\n * @category ~~Utilities~~\n \n @param {Value} initialValue - The initial value to start the history with\n * @param {number} [capacity=10] - Maximum number of history entries and undo actions to keep\n * @returns {UseStateHistoryReturn<Value>} Object containing current value, history array and control methods\n \n @example\n * const { value, history, index, set, back, forward, reset, undo, redo, canUndo, canRedo } = useStateHistory(0);\n */\nexport const useStateHistory = <Value>(\n initialValue: Value,\n capacity = 10\n): UseStateHistoryReturn<Value> => {\n const [state, dispatch] = useReducer(stateHistoryReducer<Value>, {\n history: [initialValue],\n currentIndex: 0,\n undoStack: [],\n redoStack: []\n });\n\n const value = state.history[state.currentIndex];\n const canUndo = state.undoStack.length > 0;\n const canRedo = state.redoStack.length > 0;\n\n const set = (value: Value) =>\n dispatch({\n type: 'SET',\n payload: { value, capacity }\n });\n\n const undo = () => dispatch({ type: 'UNDO' });\n\n const redo = () => dispatch({ type: 'REDO' });\n\n const back = (steps = 1) => dispatch({ type: 'BACK', payload: { steps } });\n\n const forward = (steps = 1) => dispatch({ type: 'FORWARD', payload: { steps } });\n\n const reset = () => dispatch({ type: 'RESET', payload: { initialValue, capacity } });\n\n return {\n history: state.history,\n value,\n set,\n index: state.currentIndex,\n back,\n forward,\n reset,\n undo,\n redo,\n canUndo,\n canRedo\n };\n};\n"],"names":["stateHistoryReducer","state","action","value","capacity","newHistory","newUndoStack","steps","initialValue","useStateHistory","dispatch","useReducer","canUndo","canRedo","set","undo","redo","back","forward","reset"],"mappings":"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"}
1	+ {"version":3,"file":"useStateHistory.mjs","sources":["../../../../src/hooks/useStateHistory/useStateHistory.ts"],"sourcesContent":["import { useReducer } from 'react';\n\n/** The use state history hook return type /\ninterface UseStateHistoryReturn<Value> {\n /* True if a redo operation can be performed /\n canRedo: boolean;\n /* True if an undo operation can be performed /\n canUndo: boolean;\n /* All history values /\n history: Value[];\n /* Current index in history /\n index: number;\n /* Current value /\n value: Value;\n /* Go back specified number of steps in history (default: 1) /\n back: (steps?: number) => void;\n /* Go forward specified number of steps in history (default: 1) /\n forward: (steps?: number) => void;\n /* Redo the last change /\n redo: () => void;\n /* Reset history to initial state /\n reset: () => void;\n /* Set a new value /\n set: (value: Value) => void;\n /* Undo the last change /\n undo: () => void;\n}\n\nexport type StateHistoryAction<Value> =\n \| { type: 'BACK'; payload: { steps: number } }\n \| { type: 'FORWARD'; payload: { steps: number } }\n \| { type: 'REDO' }\n \| { type: 'RESET'; payload: { initialValue: Value; capacity: number } }\n \| { type: 'SET'; payload: { value: Value; capacity: number } }\n \| { type: 'UNDO' };\n\nexport interface StateHistory<Value> {\n currentIndex: number;\n history: Value[];\n redoStack: Value[][];\n undoStack: Value[][];\n}\n\nexport const stateHistoryReducer = <Value>(\n state: StateHistory<Value>,\n action: StateHistoryAction<Value>\n): StateHistory<Value> => {\n switch (action.type) {\n case 'SET': {\n const { value, capacity } = action.payload;\n\n const newHistory = [...state.history.slice(0, state.currentIndex + 1), value];\n if (newHistory.length > capacity) {\n newHistory.shift();\n }\n\n const newUndoStack = [state.history, ...state.undoStack];\n if (newUndoStack.length > capacity) {\n newUndoStack.pop();\n }\n\n return {\n history: newHistory,\n currentIndex: newHistory.length - 1,\n undoStack: newUndoStack,\n redoStack: []\n };\n }\n\n case 'UNDO': {\n if (state.undoStack.length === 0) return state;\n\n return {\n history: state.undoStack[0],\n currentIndex: state.undoStack[0].length - 1,\n undoStack: state.undoStack.slice(1),\n redoStack: [state.history, ...state.redoStack]\n };\n }\n\n case 'REDO': {\n if (state.redoStack.length === 0) return state;\n\n return {\n history: state.redoStack[0],\n currentIndex: state.redoStack[0].length - 1,\n undoStack: [state.history, ...state.undoStack],\n redoStack: state.redoStack.slice(1)\n };\n }\n\n case 'BACK': {\n const { steps } = action.payload;\n return {\n ...state,\n currentIndex: Math.max(0, state.currentIndex - steps)\n };\n }\n\n case 'FORWARD': {\n const { steps } = action.payload;\n return {\n ...state,\n currentIndex: Math.min(state.currentIndex + steps, state.history.length - 1)\n };\n }\n\n case 'RESET': {\n const { initialValue, capacity } = action.payload;\n if (state.history.length === 1) return state;\n\n const newUndoStack = [state.history, ...state.undoStack];\n if (newUndoStack.length > capacity) {\n newUndoStack.pop();\n }\n\n return {\n history: [initialValue],\n currentIndex: 0,\n undoStack: newUndoStack,\n redoStack: []\n };\n }\n\n default:\n throw new Error('Unsupported action type');\n }\n};\n\n/\n @name useStateHistory\n * @description - Hook that manages state with history functionality\n * @category State\n \n @param {Value} initialValue - The initial value to start the history with\n * @param {number} [capacity=10] - Maximum number of history entries and undo actions to keep\n * @returns {UseStateHistoryReturn<Value>} Object containing current value, history array and control methods\n \n @example\n * const { value, history, index, set, back, forward, reset, undo, redo, canUndo, canRedo } = useStateHistory(0);\n */\nexport const useStateHistory = <Value>(\n initialValue: Value,\n capacity = 10\n): UseStateHistoryReturn<Value> => {\n const [state, dispatch] = useReducer(stateHistoryReducer<Value>, {\n history: [initialValue],\n currentIndex: 0,\n undoStack: [],\n redoStack: []\n });\n\n const value = state.history[state.currentIndex];\n const canUndo = state.undoStack.length > 0;\n const canRedo = state.redoStack.length > 0;\n\n const set = (value: Value) =>\n dispatch({\n type: 'SET',\n payload: { value, capacity }\n });\n\n const undo = () => dispatch({ type: 'UNDO' });\n\n const redo = () => dispatch({ type: 'REDO' });\n\n const back = (steps = 1) => dispatch({ type: 'BACK', payload: { steps } });\n\n const forward = (steps = 1) => dispatch({ type: 'FORWARD', payload: { steps } });\n\n const reset = () => dispatch({ type: 'RESET', payload: { initialValue, capacity } });\n\n return {\n history: state.history,\n value,\n set,\n index: state.currentIndex,\n back,\n forward,\n reset,\n undo,\n redo,\n canUndo,\n canRedo\n };\n};\n"],"names":["stateHistoryReducer","state","action","value","capacity","newHistory","newUndoStack","steps","initialValue","useStateHistory","dispatch","useReducer","canUndo","canRedo","set","undo","redo","back","forward","reset"],"mappings":"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"}

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

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

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

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