npm - @siberiacancode/reactuse - Versions diffs - 0.2.29 → 0.2.30 - Mend

@siberiacancode/reactuse 0.2.29 → 0.2.30

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 (530) hide show

package/dist/cjs/hooks/usePostMessage/usePostMessage.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePostMessage.cjs","sources":["../../../../src/hooks/usePostMessage/usePostMessage.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nexport type UsePostMessageReturn<Message> = (message: Message) => void;\n\n/*\n @name usePostMessage\n * @description - Hook that allows you to receive messages from other origins\n * @category Browser\n \n @overload\n * @template Message The message data type\n * @param {string \| string[]} origin The origin of the message\n * @param {(message: Message) => Message} callback callback to get received message\n * @returns {(message: Message) => void} An object containing the current message\n \n @example\n * const postMessage = usePostMessage();\n /\nexport const usePostMessage = <Message>(\n origin: string \| '' \| string[],\n callback: (message: Message, event: MessageEvent<Message>) => void\n): UsePostMessageReturn<Message> => {\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n\n useEffect(() => {\n const onMessage = (event: MessageEvent<Message>) => {\n if (\n (Array.isArray(origin) && (!origin.includes(event.origin) \|\| !origin.includes(''))) \|\|\n (event.origin !== origin && origin !== '')\n )\n return;\n\n internalCallbackRef.current(event.data as Message, event);\n };\n\n window.addEventListener('message', onMessage);\n return () => window.removeEventListener('message', onMessage);\n }, []);\n\n const postMessage = (message: Message) => {\n if (Array.isArray(origin)) {\n origin.forEach((origin) => window.postMessage(message, origin));\n return;\n }\n\n window.postMessage(message, origin);\n };\n\n return postMessage;\n};\n"],"names":["usePostMessage","origin","callback","internalCallbackRef","useRef","useEffect","onMessage","event","message"],"mappings":"~~yGAkBaA~~,EAAiB,CAC5BC,EACAC,IACkC,CAClC,MAAMC,EAAsBC,EAAAA,OAAOF,CAAQ,EAC3C,OAAAC,EAAoB,QAAUD,EAE9BG,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAaC,GAAiC,CAE/C,MAAM,QAAQN,CAAM,IAAM,CAACA,EAAO,SAASM,EAAM,MAAM,GAAK,CAACN,EAAO,SAAS,GAAG,IAChFM,EAAM,SAAWN,GAAUA,IAAW,KAIzCE,EAAoB,QAAQI,EAAM,KAAiBA,CAAK,CAAA,EAG1D,cAAO,iBAAiB,UAAWD,CAAS,EACrC,IAAM,OAAO,oBAAoB,UAAWA,CAAS,CAAA,EAC3D,EAAE,EAEgBE,GAAqB,CACxC,GAAI,MAAM,QAAQP,CAAM,EAAG,CACzBA,EAAO,QAASA,GAAW,OAAO,YAAYO,EAASP,CAAM,CAAC,EAC9D,MAAA,CAGF,OAAO,YAAYO,EAASP,CAAM,CAAA,CAItC"}
1	+ {"version":3,"file":"usePostMessage.cjs","sources":["../../../../src/hooks/usePostMessage/usePostMessage.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nexport type UsePostMessageReturn<Message> = (message: Message) => void;\n\n/*\n @name usePostMessage\n * @description - Hook that allows you to receive messages from other origins\n * @category Browser\n * @usage low\n \n @overload\n * @template Message The message data type\n * @param {string \| string[]} origin The origin of the message\n * @param {(message: Message) => Message} callback callback to get received message\n * @returns {(message: Message) => void} An object containing the current message\n \n @example\n * const postMessage = usePostMessage();\n /\nexport const usePostMessage = <Message>(\n origin: string \| '' \| string[],\n callback: (message: Message, event: MessageEvent<Message>) => void\n): UsePostMessageReturn<Message> => {\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n\n useEffect(() => {\n const onMessage = (event: MessageEvent<Message>) => {\n if (\n (Array.isArray(origin) && (!origin.includes(event.origin) \|\| !origin.includes(''))) \|\|\n (event.origin !== origin && origin !== '')\n )\n return;\n\n internalCallbackRef.current(event.data as Message, event);\n };\n\n window.addEventListener('message', onMessage);\n return () => window.removeEventListener('message', onMessage);\n }, []);\n\n const postMessage = (message: Message) => {\n if (Array.isArray(origin)) {\n origin.forEach((origin) => window.postMessage(message, origin));\n return;\n }\n\n window.postMessage(message, origin);\n };\n\n return postMessage;\n};\n"],"names":["usePostMessage","origin","callback","internalCallbackRef","useRef","useEffect","onMessage","event","message"],"mappings":"yGAmBaA,EAAiB,CAC5BC,EACAC,IACkC,CAClC,MAAMC,EAAsBC,EAAAA,OAAOF,CAAQ,EAC3C,OAAAC,EAAoB,QAAUD,EAE9BG,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAaC,GAAiC,CAE/C,MAAM,QAAQN,CAAM,IAAM,CAACA,EAAO,SAASM,EAAM,MAAM,GAAK,CAACN,EAAO,SAAS,GAAG,IAChFM,EAAM,SAAWN,GAAUA,IAAW,KAIzCE,EAAoB,QAAQI,EAAM,KAAiBA,CAAK,CAAA,EAG1D,cAAO,iBAAiB,UAAWD,CAAS,EACrC,IAAM,OAAO,oBAAoB,UAAWA,CAAS,CAAA,EAC3D,EAAE,EAEgBE,GAAqB,CACxC,GAAI,MAAM,QAAQP,CAAM,EAAG,CACzBA,EAAO,QAASA,GAAW,OAAO,YAAYO,EAASP,CAAM,CAAC,EAC9D,MAAA,CAGF,OAAO,YAAYO,EAASP,CAAM,CAAA,CAItC"}

package/dist/cjs/hooks/usePreferredColorScheme/usePreferredColorScheme.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredColorScheme.cjs","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":"~~sIAeaA~~,EAA0B,IAAqC,CAC1E,MAAMC,EAAUC,EAAAA,cAAc,+BAA+B,EACvDC,EAASD,EAAAA,cAAc,8BAA8B,EAE3D,OAAID,EAAgB,QAChBE,EAAe,OACZ,eACT"}
1	+ {"version":3,"file":"usePreferredColorScheme.cjs","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 * @usage medium\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":"sIAgBaA,EAA0B,IAAqC,CAC1E,MAAMC,EAAUC,EAAAA,cAAc,+BAA+B,EACvDC,EAASD,EAAAA,cAAc,8BAA8B,EAE3D,OAAID,EAAgB,QAChBE,EAAe,OACZ,eACT"}

package/dist/cjs/hooks/usePreferredContrast/usePreferredContrast.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredContrast.cjs","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":"~~sIAeaA~~,EAAuB,IAAkC,CACpE,MAAMC,EAAOC,EAAAA,cAAc,0BAA0B,EAC/CC,EAAOD,EAAAA,cAAc,0BAA0B,EAC/CE,EAASF,EAAAA,cAAc,4BAA4B,EACzD,OAAOD,EAAO,OAASE,EAAO,OAASC,EAAS,SAAW,eAC7D"}
1	+ {"version":3,"file":"usePreferredContrast.cjs","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 * @usage medium\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":"sIAgBaA,EAAuB,IAAkC,CACpE,MAAMC,EAAOC,EAAAA,cAAc,0BAA0B,EAC/CC,EAAOD,EAAAA,cAAc,0BAA0B,EAC/CE,EAASF,EAAAA,cAAc,4BAA4B,EACzD,OAAOD,EAAO,OAASE,EAAO,OAASC,EAAS,SAAW,eAC7D"}

package/dist/cjs/hooks/usePreferredDark/usePreferredDark.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredDark.cjs","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":"~~sIAUaA~~,EAAmB,IAAMC,EAAAA,cAAc,8BAA8B"}
1	+ {"version":3,"file":"usePreferredDark.cjs","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 * @usage medium\n \n @example\n * const isDark = usePreferredDark();\n */\nexport const usePreferredDark = () => useMediaQuery('(prefers-color-scheme: dark)');\n"],"names":["usePreferredDark","useMediaQuery"],"mappings":"sIAWaA,EAAmB,IAAMC,EAAAA,cAAc,8BAA8B"}

package/dist/cjs/hooks/usePreferredLanguages/usePreferredLanguages.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredLanguages.cjs","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":"yGAEMA,EAAc,IAAM,OAAO,UAAU,UACrCC,EAAoB,IAAM,CAAA,EAC1BC,EAAaC,IACjB,OAAO,iBAAiB,iBAAkBA,CAAQ,EAC3C,IAAM,CACX,OAAO,oBAAoB,iBAAkBA,CAAQ,CAAA,~~GAgB5CC~~,EAAwB,IACnCC,EAAAA,qBAAqBH,EAAWF,EAAaC,CAAiB"}
1	+ {"version":3,"file":"usePreferredLanguages.cjs","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 * @usage medium\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":"yGAEMA,EAAc,IAAM,OAAO,UAAU,UACrCC,EAAoB,IAAM,CAAA,EAC1BC,EAAaC,IACjB,OAAO,iBAAiB,iBAAkBA,CAAQ,EAC3C,IAAM,CACX,OAAO,oBAAoB,iBAAkBA,CAAQ,CAAA,GAiB5CC,EAAwB,IACnCC,EAAAA,qBAAqBH,EAAWF,EAAaC,CAAiB"}

package/dist/cjs/hooks/usePreferredReducedMotion/usePreferredReducedMotion.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePreferredReducedMotion.cjs","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":"~~sIAeaA~~,EAA4B,IACvBC,EAAAA,cAAc,kCAAkC,EAC/C,SAAW"}
1	+ {"version":3,"file":"usePreferredReducedMotion.cjs","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 * @usage low\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":"sIAgBaA,EAA4B,IACvBC,EAAAA,cAAc,kCAAkC,EAC/C,SAAW"}

package/dist/cjs/hooks/usePrevious/usePrevious.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usePrevious.cjs","sources":["../../../../src/hooks/usePrevious/usePrevious.ts"],"sourcesContent":["import { useRef } from 'react';\n\nexport interface UsePreviousOptions<Value> {\n equality: (a: Value, b: Value) => boolean;\n}\n\n/*\n @name usePrevious\n * @description - Hook that returns the previous value\n * @category Utilities\n \n @template Value The type of the value\n * @param {Value} value The value to get the previous value\n * @param {(a: Value, b: Value) => boolean} [options.equality] The custom equality function to determine if the value has changed\n * @returns {Value \| undefined} The previous value\n \n @example\n * const prevValue = usePrevious(value);\n */\nexport const usePrevious = <Value>(value: Value, options?: UsePreviousOptions<Value>) => {\n const currentRef = useRef<Value>(value);\n const previousRef = useRef<Value>(undefined);\n\n const equality = options?.equality ?? Object.is;\n\n if (!equality(value, currentRef.current)) {\n previousRef.current = currentRef.current;\n currentRef.current = value;\n }\n\n return previousRef.current;\n};\n"],"names":["usePrevious","value","options","currentRef","useRef","previousRef"],"mappings":"~~yGAmBaA~~,EAAc,CAAQC,EAAcC,IAAwC,CACvF,MAAMC,EAAaC,EAAAA,OAAcH,CAAK,EAChCI,EAAcD,EAAAA,OAAc,MAAS,EAI3C,OAFiBF,GAAS,UAAY,OAAO,IAE/BD,EAAOE,EAAW,OAAO,IACrCE,EAAY,QAAUF,EAAW,QACjCA,EAAW,QAAUF,GAGhBI,EAAY,OACrB"}
1	+ {"version":3,"file":"usePrevious.cjs","sources":["../../../../src/hooks/usePrevious/usePrevious.ts"],"sourcesContent":["import { useRef } from 'react';\n\nexport interface UsePreviousOptions<Value> {\n equality: (a: Value, b: Value) => boolean;\n}\n\n/*\n @name usePrevious\n * @description - Hook that returns the previous value\n * @category Utilities\n * @usage low\n \n @template Value The type of the value\n * @param {Value} value The value to get the previous value\n * @param {(a: Value, b: Value) => boolean} [options.equality] The custom equality function to determine if the value has changed\n * @returns {Value \| undefined} The previous value\n \n @example\n * const prevValue = usePrevious(value);\n */\nexport const usePrevious = <Value>(value: Value, options?: UsePreviousOptions<Value>) => {\n const currentRef = useRef<Value>(value);\n const previousRef = useRef<Value>(undefined);\n\n const equality = options?.equality ?? Object.is;\n\n if (!equality(value, currentRef.current)) {\n previousRef.current = currentRef.current;\n currentRef.current = value;\n }\n\n return previousRef.current;\n};\n"],"names":["usePrevious","value","options","currentRef","useRef","previousRef"],"mappings":"yGAoBaA,EAAc,CAAQC,EAAcC,IAAwC,CACvF,MAAMC,EAAaC,EAAAA,OAAcH,CAAK,EAChCI,EAAcD,EAAAA,OAAc,MAAS,EAI3C,OAFiBF,GAAS,UAAY,OAAO,IAE/BD,EAAOE,EAAW,OAAO,IACrCE,EAAY,QAAUF,EAAW,QACjCA,EAAW,QAAUF,GAGhBI,EAAY,OACrB"}

package/dist/cjs/hooks/useQuery/useQuery.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useQuery.cjs","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":"~~2OAgFaA~~,EAAW,CACtBC,EACAC,IACyB,CACzB,MAAMC,EAAUD,GAAS,SAAW,GAC9BE,EAAgBC,EAAAA,OAAOH,GAAS,MAAQI,EAAAA,SAASJ,EAAQ,KAAK,EAAI,CAAC,EACnEK,EAAmBF,EAAAA,OAAO,EAAK,EAE/B,CAACG,EAAYC,CAAa,EAAIC,EAAAA,SAAS,EAAK,EAC5C,CAACC,EAAWC,CAAY,EAAIF,EAAAA,SAAS,EAAK,EAC1C,CAACG,EAASC,CAAU,EAAIJ,EAAAA,SAAS,EAAK,EACtC,CAACK,EAAcC,CAAe,EAAIN,EAAAA,SAAS,EAAK,EAChD,CAACO,EAAWC,CAAY,EAAIR,EAAAA,SAAS,CAAC,CAACR,GAAS,eAAe,EAE/D,CAACiB,EAAOC,CAAQ,EAAIV,EAAAA,SAA4B,MAAS,EACzD,CAACW,EAAMC,CAAO,EAAIZ,EAAAA,SAA2BR,GAAS,eAAe,EAErEqB,EAAqBlB,EAAAA,OAAwB,IAAI,eAAiB,EAClEmB,EAAgBnB,EAAAA,OAAuC,MAAS,EAEhEoB,EAAOvB,GAAS,MAAQ,CAAA,EAExBwB,EAAQ,IAAM,CAClBH,EAAmB,QAAQ,MAAA,EAC3BA,EAAmB,QAAU,IAAI,eAAgB,EAG7CI,EAAWC,GAA+B,CAC9CF,EAAA,EAEAjB,EAAc,EAAI,EACdmB,IAAW,SACbrB,EAAiB,QAAU,GAC3BK,EAAa,EAAI,GAEfgB,IAAW,WAAWZ,EAAgB,EAAI,EAC9Cf,EAAS,CAAE,OAAQsB,EAAmB,QAAQ,OAAQ,KAAAE,EAAM,EACzD,KAAMI,GAAa,CAClB,MAAMR,EAAOnB,GAAS,OAASA,GAAS,OAAO2B,CAAQ,EAAIA,EAC3D3B,GAAS,YAAYmB,CAAY,EACjCC,EAAQD,CAAY,EACpBH,EAAa,EAAI,EACjBE,EAAS,MAAS,EAClBN,EAAW,EAAK,EAChBL,EAAc,EAAK,EACfmB,IAAW,QAAQhB,EAAa,EAAK,EACrCgB,IAAW,WAAWZ,EAAgB,EAAK,CAAA,CAChD,EACA,MAAOG,GAAiB,CACvB,GAAIf,EAAc,QAAU,EAAG,CAC7BA,EAAc,SAAW,EACzB,MAAM0B,EACJ,OAAO5B,GAAS,YAAe,WAC3BA,GAAS,WAAWE,EAAc,QAASe,CAAK,EAChDjB,GAAS,WAEf,GAAI4B,EAAY,CACd,WAAW,IAAMH,EAAQC,CAAM,EAAGE,CAAU,EAC5C,MAAA,CAGF,OAAOH,EAAQC,CAAM,CAAA,CAEvB1B,GAAS,UAAUiB,CAAK,EACxBG,EAAQ,MAAS,EACjBJ,EAAa,EAAK,EAClBE,EAASD,CAAK,EACdL,EAAW,EAAI,EACfL,EAAc,EAAK,EACfmB,IAAW,QAAQhB,EAAa,EAAK,EACrCgB,IAAW,WAAWZ,EAAgB,EAAK,EAC/CZ,EAAc,QAAUF,GAAS,MAAQI,EAAAA,SAASJ,EAAQ,KAAK,EAAI,CAAA,CACpE,EACA,QAAQ,IAAM,CACb,GAAIA,GAAS,gBAAiB,CAC5B,MAAM6B,EAAW,YAAY,IAAM,CACjC,cAAcA,CAAQ,EACtBJ,EAAQ,SAAS,CAAA,EAChBzB,GAAS,eAAe,EAC3BsB,EAAc,QAAUO,CAAA,CAC1B,CACD,CAAA,EAGLC,OAAAA,EAAAA,SAAS,IAAM,CACR7B,GACLwB,EAAQ,MAAM,CAAA,CACf,EAEDM,EAAAA,aAAa,IAAM,CACZ9B,GACLwB,EAAQpB,EAAiB,QAAU,UAAY,MAAM,CAAA,EACpD,CAACJ,EAAS,GAAGsB,CAAI,CAAC,EAErBS,EAAAA,UAAU,IACD,IAAM,CACX,cAAcV,EAAc,OAAO,CAAA,EAEpC,CAACrB,EAASD,GAAS,gBAAiBA,GAAS,MAAO,GAAGuB,CAAI,CAAC,EAIxD,CACL,MAAAC,EACA,KAAAL,EACA,MAAAF,EACA,QANc,IAAMQ,EAAQ,SAAS,EAOrC,WAAAnB,EACA,UAAAG,EACA,QAAAE,EACA,UAAAI,EACA,aAAAF,CAAA,CAEJ"}
1	+ {"version":3,"file":"useQuery.cjs","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 * @usage high\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":"2OAiFaA,EAAW,CACtBC,EACAC,IACyB,CACzB,MAAMC,EAAUD,GAAS,SAAW,GAC9BE,EAAgBC,EAAAA,OAAOH,GAAS,MAAQI,EAAAA,SAASJ,EAAQ,KAAK,EAAI,CAAC,EACnEK,EAAmBF,EAAAA,OAAO,EAAK,EAE/B,CAACG,EAAYC,CAAa,EAAIC,EAAAA,SAAS,EAAK,EAC5C,CAACC,EAAWC,CAAY,EAAIF,EAAAA,SAAS,EAAK,EAC1C,CAACG,EAASC,CAAU,EAAIJ,EAAAA,SAAS,EAAK,EACtC,CAACK,EAAcC,CAAe,EAAIN,EAAAA,SAAS,EAAK,EAChD,CAACO,EAAWC,CAAY,EAAIR,EAAAA,SAAS,CAAC,CAACR,GAAS,eAAe,EAE/D,CAACiB,EAAOC,CAAQ,EAAIV,EAAAA,SAA4B,MAAS,EACzD,CAACW,EAAMC,CAAO,EAAIZ,EAAAA,SAA2BR,GAAS,eAAe,EAErEqB,EAAqBlB,EAAAA,OAAwB,IAAI,eAAiB,EAClEmB,EAAgBnB,EAAAA,OAAuC,MAAS,EAEhEoB,EAAOvB,GAAS,MAAQ,CAAA,EAExBwB,EAAQ,IAAM,CAClBH,EAAmB,QAAQ,MAAA,EAC3BA,EAAmB,QAAU,IAAI,eAAgB,EAG7CI,EAAWC,GAA+B,CAC9CF,EAAA,EAEAjB,EAAc,EAAI,EACdmB,IAAW,SACbrB,EAAiB,QAAU,GAC3BK,EAAa,EAAI,GAEfgB,IAAW,WAAWZ,EAAgB,EAAI,EAC9Cf,EAAS,CAAE,OAAQsB,EAAmB,QAAQ,OAAQ,KAAAE,EAAM,EACzD,KAAMI,GAAa,CAClB,MAAMR,EAAOnB,GAAS,OAASA,GAAS,OAAO2B,CAAQ,EAAIA,EAC3D3B,GAAS,YAAYmB,CAAY,EACjCC,EAAQD,CAAY,EACpBH,EAAa,EAAI,EACjBE,EAAS,MAAS,EAClBN,EAAW,EAAK,EAChBL,EAAc,EAAK,EACfmB,IAAW,QAAQhB,EAAa,EAAK,EACrCgB,IAAW,WAAWZ,EAAgB,EAAK,CAAA,CAChD,EACA,MAAOG,GAAiB,CACvB,GAAIf,EAAc,QAAU,EAAG,CAC7BA,EAAc,SAAW,EACzB,MAAM0B,EACJ,OAAO5B,GAAS,YAAe,WAC3BA,GAAS,WAAWE,EAAc,QAASe,CAAK,EAChDjB,GAAS,WAEf,GAAI4B,EAAY,CACd,WAAW,IAAMH,EAAQC,CAAM,EAAGE,CAAU,EAC5C,MAAA,CAGF,OAAOH,EAAQC,CAAM,CAAA,CAEvB1B,GAAS,UAAUiB,CAAK,EACxBG,EAAQ,MAAS,EACjBJ,EAAa,EAAK,EAClBE,EAASD,CAAK,EACdL,EAAW,EAAI,EACfL,EAAc,EAAK,EACfmB,IAAW,QAAQhB,EAAa,EAAK,EACrCgB,IAAW,WAAWZ,EAAgB,EAAK,EAC/CZ,EAAc,QAAUF,GAAS,MAAQI,EAAAA,SAASJ,EAAQ,KAAK,EAAI,CAAA,CACpE,EACA,QAAQ,IAAM,CACb,GAAIA,GAAS,gBAAiB,CAC5B,MAAM6B,EAAW,YAAY,IAAM,CACjC,cAAcA,CAAQ,EACtBJ,EAAQ,SAAS,CAAA,EAChBzB,GAAS,eAAe,EAC3BsB,EAAc,QAAUO,CAAA,CAC1B,CACD,CAAA,EAGLC,OAAAA,EAAAA,SAAS,IAAM,CACR7B,GACLwB,EAAQ,MAAM,CAAA,CACf,EAEDM,EAAAA,aAAa,IAAM,CACZ9B,GACLwB,EAAQpB,EAAiB,QAAU,UAAY,MAAM,CAAA,EACpD,CAACJ,EAAS,GAAGsB,CAAI,CAAC,EAErBS,EAAAA,UAAU,IACD,IAAM,CACX,cAAcV,EAAc,OAAO,CAAA,EAEpC,CAACrB,EAASD,GAAS,gBAAiBA,GAAS,MAAO,GAAGuB,CAAI,CAAC,EAIxD,CACL,MAAAC,EACA,KAAAL,EACA,MAAAF,EACA,QANc,IAAMQ,EAAQ,SAAS,EAOrC,WAAAnB,EACA,UAAAG,EACA,QAAAE,EACA,UAAAI,EACA,aAAAF,CAAA,CAEJ"}

package/dist/cjs/hooks/useQueue/useQueue.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useQueue.cjs","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":"~~gIAiCaA~~,EAAW,CAAQC,EAAwB,KAA8B,CACpF,KAAM,CAACC,EAAOC,CAAQ,EAAIC,EAAAA,SAASH,CAAY,EAgB/C,MAAO,CACL,IAfWI,GAAmBF,EAAUD,GAAU,CAAC,GAAGA,EAAOG,CAAO,CAAC,EAgBrE,OAda,IAAM,CACnB,IAAIC,EACJC,OAAAA,EAAAA,UAAU,IAAM,CACdJ,EAAS,CAAC,CAACK,EAAU,GAAAC,CAAI,KACvBH,EAAUE,EACHC,EACR,CAAA,CACF,EAEMH,CAAA,EAMP,MAhBY,IAAMH,EAAS,EAAE,EAiB7B,MAAOD,EAAM,CAAC,EACd,KAAMA,EAAMA,EAAM,OAAS,CAAC,EAC5B,KAAMA,EAAM,OACZ,MAAAA,CAAA,CAEJ"}
1	+ {"version":3,"file":"useQueue.cjs","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 * @usage medium\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":"gIAkCaA,EAAW,CAAQC,EAAwB,KAA8B,CACpF,KAAM,CAACC,EAAOC,CAAQ,EAAIC,EAAAA,SAASH,CAAY,EAgB/C,MAAO,CACL,IAfWI,GAAmBF,EAAUD,GAAU,CAAC,GAAGA,EAAOG,CAAO,CAAC,EAgBrE,OAda,IAAM,CACnB,IAAIC,EACJC,OAAAA,EAAAA,UAAU,IAAM,CACdJ,EAAS,CAAC,CAACK,EAAU,GAAAC,CAAI,KACvBH,EAAUE,EACHC,EACR,CAAA,CACF,EAEMH,CAAA,EAMP,MAhBY,IAAMH,EAAS,EAAE,EAiB7B,MAAOD,EAAM,CAAC,EACd,KAAMA,EAAMA,EAAM,OAAS,CAAC,EAC5B,KAAMA,EAAM,OACZ,MAAAA,CAAA,CAEJ"}

package/dist/cjs/hooks/useRaf/useRaf.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRaf.cjs","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":"~~yGA8CaA~~,EAAS,CAACC,EAA0BC,IAA0C,CACzF,MAAMC,EAAWC,EAAAA,OAAsB,IAAI,EACrCC,EAA4BD,EAAAA,OAAO,CAAC,EACpC,CAACE,EAAQC,CAAS,EAAIC,EAAAA,SAAS,EAAK,EACpCC,EAAUP,GAAS,SAAW,GAE9BQ,EAAsBN,EAAAA,OAAOH,CAAQ,EAC3CS,EAAoB,QAAUT,EAE9B,MAAMU,EAAQC,GAAmC,CAC/C,MAAMC,EAAQD,EAAYP,EAA0B,QAEpD,GAAIH,GAAS,OAASW,EAAQX,GAAS,MAAO,CAC5CC,EAAS,QAAU,OAAO,sBAAsBQ,CAAI,EACpD,MAAA,CAGFN,EAA0B,QAAUO,EACpCF,EAAoB,QAAQ,CAAE,MAAAG,EAAO,UAAAD,CAAA,CAAW,EAChDT,EAAS,QAAU,OAAO,sBAAsBQ,CAAI,CAAA,EAGhDG,EAAS,IAAM,CACfR,IACJC,EAAU,EAAI,EACdF,EAA0B,QAAU,EACpCF,EAAS,QAAU,OAAO,sBAAsBQ,CAAI,EAAA,EAGtD,SAASI,GAAQ,CACVZ,EAAS,UAEdI,EAAU,EAAK,EACf,OAAO,qBAAqBJ,EAAS,OAAO,EAC5CA,EAAS,QAAU,KAAA,CAGrBa,OAAAA,EAAAA,UAAU,IAAM,CACd,GAAKP,EACL,OAAAK,EAAA,EAEOC,CAAA,EACN,CAACN,EAASP,GAAS,KAAK,CAAC,EAErB,CACL,OAAAI,EACA,MAAAS,EACA,OAAAD,CAAA,CAEJ"}
1	+ {"version":3,"file":"useRaf.cjs","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 * @usage low\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":"yGA+CaA,EAAS,CAACC,EAA0BC,IAA0C,CACzF,MAAMC,EAAWC,EAAAA,OAAsB,IAAI,EACrCC,EAA4BD,EAAAA,OAAO,CAAC,EACpC,CAACE,EAAQC,CAAS,EAAIC,EAAAA,SAAS,EAAK,EACpCC,EAAUP,GAAS,SAAW,GAE9BQ,EAAsBN,EAAAA,OAAOH,CAAQ,EAC3CS,EAAoB,QAAUT,EAE9B,MAAMU,EAAQC,GAAmC,CAC/C,MAAMC,EAAQD,EAAYP,EAA0B,QAEpD,GAAIH,GAAS,OAASW,EAAQX,GAAS,MAAO,CAC5CC,EAAS,QAAU,OAAO,sBAAsBQ,CAAI,EACpD,MAAA,CAGFN,EAA0B,QAAUO,EACpCF,EAAoB,QAAQ,CAAE,MAAAG,EAAO,UAAAD,CAAA,CAAW,EAChDT,EAAS,QAAU,OAAO,sBAAsBQ,CAAI,CAAA,EAGhDG,EAAS,IAAM,CACfR,IACJC,EAAU,EAAI,EACdF,EAA0B,QAAU,EACpCF,EAAS,QAAU,OAAO,sBAAsBQ,CAAI,EAAA,EAGtD,SAASI,GAAQ,CACVZ,EAAS,UAEdI,EAAU,EAAK,EACf,OAAO,qBAAqBJ,EAAS,OAAO,EAC5CA,EAAS,QAAU,KAAA,CAGrBa,OAAAA,EAAAA,UAAU,IAAM,CACd,GAAKP,EACL,OAAAK,EAAA,EAEOC,CAAA,EACN,CAACN,EAASP,GAAS,KAAK,CAAC,EAErB,CACL,OAAAI,EACA,MAAAS,EACA,OAAAD,CAAA,CAEJ"}

package/dist/cjs/hooks/useRafState/useRafState.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRafState.cjs","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":"~~mJAmBaA~~,EAAsBC,GAAwC,CACzE,MAAMC,EAAWC,EAAAA,OAAO,CAAC,EACnB,CAACC,EAAOC,CAAQ,EAAIC,EAAAA,SAASL,CAAY,EAEzCM,EAAOH,GAAiB,CAC5B,qBAAqBF,EAAS,OAAO,EACrCA,EAAS,QAAU,sBAAsB,IAAMG,EAASD,CAAK,CAAC,CAAA,EAGhEI,OAAAA,EAAAA,WAAW,IAAM,qBAAqBN,EAAS,OAAO,CAAC,EAEhD,CAACE,EAAOG,CAAG,CACpB"}
1	+ {"version":3,"file":"useRafState.cjs","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 * @usage low\n \n @browserapi requestAnimationFrame https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame\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":"mJAsBaA,EAAsBC,GAAwC,CACzE,MAAMC,EAAWC,EAAAA,OAAO,CAAC,EACnB,CAACC,EAAOC,CAAQ,EAAIC,EAAAA,SAASL,CAAY,EAEzCM,EAAOH,GAAiB,CAC5B,qBAAqBF,EAAS,OAAO,EACrCA,EAAS,QAAU,sBAAsB,IAAMG,EAASD,CAAK,CAAC,CAAA,EAGhEI,OAAAA,EAAAA,WAAW,IAAM,qBAAqBN,EAAS,OAAO,CAAC,EAEhD,CAACE,EAAOG,CAAG,CACpB"}

package/dist/cjs/hooks/useRefState/useRefState.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRefState.cjs","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":"yGAQMA,EAAiB,CACrBC,EACAC,IACG,CACH,IAAIC,EAAOF,EACX,SAASG,EAAIC,EAAc,CACrBF,IAASE,IACbF,EAAOE,EACPH,EAASC,CAAI,EAAA,CAGf,cAAO,eAAeC,EAAK,UAAW,CACpC,KAAM,CACJ,OAAOD,CAAA,EAET,IAAIE,EAAc,CACZF,IAASE,IACbF,EAAOE,EACPH,EAASC,CAAI,EAAA,EAEf,aAAc,GACd,WAAY,EAAA,CACb,EAEMC,CACT,~~EAcaE~~,EAAsBL,GAAyB,CAC1D,KAAM,CAACM,EAAOL,CAAQ,EAAIM,EAAAA,SAA4BP,CAAY,EAC5D,CAACG,CAAG,EAAII,EAAAA,SAAS,IAAMR,EAAsBC,EAAcC,CAAQ,CAAC,EAC1E,OAAAE,EAAI,MAAQG,EACLH,CACT"}
1	+ {"version":3,"file":"useRefState.cjs","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 * @usage low\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":"yGAQMA,EAAiB,CACrBC,EACAC,IACG,CACH,IAAIC,EAAOF,EACX,SAASG,EAAIC,EAAc,CACrBF,IAASE,IACbF,EAAOE,EACPH,EAASC,CAAI,EAAA,CAGf,cAAO,eAAeC,EAAK,UAAW,CACpC,KAAM,CACJ,OAAOD,CAAA,EAET,IAAIE,EAAc,CACZF,IAASE,IACbF,EAAOE,EACPH,EAASC,CAAI,EAAA,EAEf,aAAc,GACd,WAAY,EAAA,CACb,EAEMC,CACT,EAeaE,EAAsBL,GAAyB,CAC1D,KAAM,CAACM,EAAOL,CAAQ,EAAIM,EAAAA,SAA4BP,CAAY,EAC5D,CAACG,CAAG,EAAII,EAAAA,SAAS,IAAMR,EAAsBC,EAAcC,CAAQ,CAAC,EAC1E,OAAAE,EAAI,MAAQG,EACLH,CACT"}

package/dist/cjs/hooks/useRenderCount/useRenderCount.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRenderCount.cjs","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":"~~yGAYaA~~,EAAiB,IAAM,CAClC,MAAMC,EAAiBC,EAAAA,OAAO,CAAC,EAE/BC,OAAAA,EAAAA,UAAU,IAAM,CACdF,EAAe,SAAW,CAAA,CAC3B,EAEMA,EAAe,OACxB"}
1	+ {"version":3,"file":"useRenderCount.cjs","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 * @usage low\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":"yGAaaA,EAAiB,IAAM,CAClC,MAAMC,EAAiBC,EAAAA,OAAO,CAAC,EAE/BC,OAAAA,EAAAA,UAAU,IAAM,CACdF,EAAe,SAAW,CAAA,CAC3B,EAEMA,EAAe,OACxB"}

package/dist/cjs/hooks/useRenderInfo/useRenderInfo.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRenderInfo.cjs","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":"~~yGA0BaA~~,EAAgB,CAACC,EAAe,UAAWC,EAAe,KAAS,CAC9E,MAAMC,EAAgBC,EAAAA,OAA4B,CAChD,UAAWH,EACX,QAAS,EACT,UAAW,KAAK,IAAA,EAChB,UAAW,CAAA,CACZ,EACKI,EAAM,KAAK,IAAA,EAEjB,OAAAF,EAAc,QAAQ,SAAW,EACjCA,EAAc,QAAQ,UAAYA,EAAc,QAAQ,UACpDE,EAAMF,EAAc,QAAQ,UAC5B,EACJA,EAAc,QAAQ,UAAYE,EAE9BH,IACF,QAAQ,MAAM,GAAGD,CAAI,yBAAyBE,EAAc,QAAQ,OAAO,EAAE,EAC7E,QAAQ,IAAI,cAAcA,EAAc,QAAQ,SAAS,EAAE,EAC3D,QAAQ,IAAI,sBAAsBA,EAAc,QAAQ,SAAS,EAAE,EACnE,QAAQ,IAAI,YAAYA,EAAc,QAAQ,OAAO,EAAE,EACvD,QAAQ,IAAIA,EAAc,OAAO,EACjC,QAAQ,SAAA,GAGHA,EAAc,OACvB"}
1	+ {"version":3,"file":"useRenderInfo.cjs","sources":["../../../../src/hooks/useRenderInfo/useRenderInfo.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/** The use render info return type /\nexport interface UseRenderInfoReturn {\n /* The name of the component /\n component: string;\n /* The number of renders /\n renders: number;\n /* The time since the last render /\n sinceLast: number;\n /* The timestamp of the render /\n timestamp: number \| null;\n}\n\n/\n @name useRenderInfo\n * @description - Hook for getting information about component rerender\n * @category Debug\n * @usage low\n \n @param {string} [name='Unknown'] Component name\n * @param {boolean} [log=true] Toggle logging\n * @returns {UseRenderInfoReturn} An object containing rerender information\n \n @example\n * const rerenderInfo = useRenderInfo('Component');\n */\nexport const useRenderInfo = (name: string = 'Unknown', log: boolean = true) => {\n const renderInfoRef = useRef<UseRenderInfoReturn>({\n component: name,\n renders: 0,\n timestamp: Date.now(),\n sinceLast: 0\n });\n const now = Date.now();\n\n renderInfoRef.current.renders += 1;\n renderInfoRef.current.sinceLast = renderInfoRef.current.timestamp\n ? now - renderInfoRef.current.timestamp\n : 0;\n renderInfoRef.current.timestamp = now;\n\n if (log) {\n console.group(`${name} info, render number: ${renderInfoRef.current.renders}`);\n console.log(`Timestamp: ${renderInfoRef.current.timestamp}`);\n console.log(`Since last render: ${renderInfoRef.current.sinceLast}`);\n console.log(`Renders: ${renderInfoRef.current.renders}`);\n console.dir(renderInfoRef.current);\n console.groupEnd();\n }\n\n return renderInfoRef.current;\n};\n"],"names":["useRenderInfo","name","log","renderInfoRef","useRef","now"],"mappings":"yGA2BaA,EAAgB,CAACC,EAAe,UAAWC,EAAe,KAAS,CAC9E,MAAMC,EAAgBC,EAAAA,OAA4B,CAChD,UAAWH,EACX,QAAS,EACT,UAAW,KAAK,IAAA,EAChB,UAAW,CAAA,CACZ,EACKI,EAAM,KAAK,IAAA,EAEjB,OAAAF,EAAc,QAAQ,SAAW,EACjCA,EAAc,QAAQ,UAAYA,EAAc,QAAQ,UACpDE,EAAMF,EAAc,QAAQ,UAC5B,EACJA,EAAc,QAAQ,UAAYE,EAE9BH,IACF,QAAQ,MAAM,GAAGD,CAAI,yBAAyBE,EAAc,QAAQ,OAAO,EAAE,EAC7E,QAAQ,IAAI,cAAcA,EAAc,QAAQ,SAAS,EAAE,EAC3D,QAAQ,IAAI,sBAAsBA,EAAc,QAAQ,SAAS,EAAE,EACnE,QAAQ,IAAI,YAAYA,EAAc,QAAQ,OAAO,EAAE,EACvD,QAAQ,IAAIA,EAAc,OAAO,EACjC,QAAQ,SAAA,GAGHA,EAAc,OACvB"}

package/dist/cjs/hooks/useRerender/useRerender.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRerender.cjs","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":"~~yGAeaA~~,EAAc,IAAyBC,EAAAA,WAAW,KAAO,CAAA,GAAK,CAAA,CAAE,EAAE,CAAC"}
1	+ {"version":3,"file":"useRerender.cjs","sources":["../../../../src/hooks/useRerender/useRerender.ts"],"sourcesContent":["import { useReducer } from 'react';\n\n/** The use rerender return type /\ntype UseRerenderReturn = () => void;\n\n/\n @name useRerender\n * @description - Hook that defines the logic to force rerender a component\n * @category Debug\n * @usage medium\n \n @returns {UseRerenderReturn} The rerender function\n \n @example\n * const rerender = useRerender();\n */\nexport const useRerender = (): UseRerenderReturn => useReducer(() => ({}), {})[1];\n"],"names":["useRerender","useReducer"],"mappings":"yGAgBaA,EAAc,IAAyBC,EAAAA,WAAW,KAAO,CAAA,GAAK,CAAA,CAAE,EAAE,CAAC"}

package/dist/cjs/hooks/useResizeObserver/useResizeObserver.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react"),g=require("../useRefState/useRefState.cjs"),l=require("../../utils/helpers/isTarget.cjs"),R=require("../../utils/helpers/getElement.cjs"),v=(...n)=>{const e=l.isTarget(n[0])?n[0]:void 0,t=e?n[1]:n[0],u=t?.enabled??!0,[c,b]=o.useState([]),r=g.useRefState(),i=o.useRef(t?.onChange);return i.current=t?.onChange,o.useEffect(()=>{if(!u||!e&&!r.state)return;const a=e?R.getElement(e):r.current;if(!a)return;const s=new ResizeObserver(f=>{b(f),i.current?.(f,s)});return s.observe(a,t),()=>{s.disconnect()}},[e,r.state,t?.box,u]),e?{entries:c}:{ref:r,entries:c}};exports.useResizeObserver=v;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),d=require("../useRefState/useRefState.cjs"),S=require("../../utils/helpers/isTarget.cjs"),y=require("../../utils/helpers/getElement.cjs"),O=(...e)=>{const t=S.isTarget(e[0])?e[0]:void 0,n=t?typeof e[1]=="object"?e[1]:{onChange:e[1]}:typeof e[0]=="object"?e[0]:{onChange:e[0]},c=n?.onChange,u=n?.enabled??!0,[i,a]=s.useState(),[b,v]=s.useState(),r=d.useRefState(),f=s.useRef(c);return f.current=c,s.useEffect(()=>{if(!u||!t&&!r.state)return;const l=t?y.getElement(t):r.current;if(!l)return;const o=new ResizeObserver(([g],R)=>{a(g),f.current?.(g,R)});return v(o),o.observe(l,n),()=>{o.disconnect()}},[t,r.state,n?.box,u]),t?{entry:i,observer:b}:{ref:r,entry:i,observer:b}};exports.useResizeObserver=O;
 //# sourceMappingURL=useResizeObserver.cjs.map

package/dist/cjs/hooks/useResizeObserver/useResizeObserver.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useResizeObserver.cjs","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":"~~mPA6DaA~~,EAAqB,IAAIC,IAAkB,CACtD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,~~OAC5CG~~,~~EAAWF~~,~~EAASD~~,EAAO,CAAC,~~EAAIA~~,EAAO,CAAC,~~EACxCI~~,~~EAAUD~~,GAAS,SAAW,GAE9B,~~CAACE~~,~~EAASC~~,~~CAAU~~,EAAIC,~~EAAAA~~,~~SAAgC~~,~~CAAA~~,~~CAAE~~,~~EAE1DC~~,EAAcC,EAAAA,YAAA,EACdC,EAAsBC,EAAAA,~~OAA6CR~~,~~GAAS~~,~~QAAQ~~,~~EAoB1F~~,~~OAnBAO,~~EAAoB,~~QAAUP~~,~~GAAS~~,~~SAEvCS,~~EAAAA,UAAU,IAAM,CACd,GAAI,~~CAACR~~,GAAY,~~CAACH~~,GAAU,~~CAACO~~,EAAY,MAAQ,OAEjD,MAAMK,~~EAAUZ~~,~~EAASa~~,EAAAA,~~WAAWb~~,CAAM,~~EAAIO~~,EAAY,QAC1D,GAAI,CAACK,EAAS,OAEd,~~MAAME~~,EAAW,IAAI,~~eAAgBV~~,~~GAAY~~,~~CAC/CC~~,~~EAAWD~~,~~CAAO~~,~~EAClBK~~,EAAoB,~~UAAUL~~,~~EAASU~~,CAAQ,CAAA,~~CAChD~~,~~EACD~~,~~OAAAA~~,EAAS,~~QAAQF~~,~~EAAoBV~~,CAAO,EAErC,IAAM,~~CACXY~~,EAAS,WAAA,CAAW,CACtB,EACC,~~CAACd~~,~~EAAQO~~,EAAY,~~MAAOL~~,GAAS,~~IAAKC~~,CAAO,CAAC,~~EAEjDH~~,EAAe,CAAE,~~QAAAI~~,CAAA,~~EACd~~,CACL,~~IAAKG~~,EACL,~~QAAAH~~,CAAA,CAEJ"}
1	+ {"version":3,"file":"useResizeObserver.cjs","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 callback type /\nexport type UseResizeObserverCallback = (\n entry: ResizeObserverEntry,\n observer: ResizeObserver\n) => void;\n\n/* The resize observer options type /\nexport interface UseResizeObserverOptions extends ResizeObserverOptions {\n /* The enabled state of the resize observer /\n enabled?: boolean;\n /* The callback to execute when resize is detected /\n onChange?: UseResizeObserverCallback;\n}\n\n/* The resize observer return type /\nexport interface UseResizeObserverReturn {\n /* The resize observer entries /\n entry: ResizeObserverEntry;\n /* The resize observer instance /\n observer?: ResizeObserver;\n}\n\nexport interface UseResizeObserver {\n <Target extends Element>(\n options?: UseResizeObserverOptions,\n target?: never\n ): UseResizeObserverReturn & { ref: StateRef<Target> };\n\n (target: HookTarget, options?: UseResizeObserverOptions): UseResizeObserverReturn;\n\n <Target extends Element>(\n callback: UseResizeObserverCallback,\n target?: never\n ): UseResizeObserverReturn & { ref: StateRef<Target> };\n\n (target: HookTarget, callback: UseResizeObserverCallback): UseResizeObserverReturn;\n}\n\n/\n @name useResizeObserver\n * @description - Hook that gives you resize observer state\n * @category Sensors\n * @usage low\n \n @browserapi ResizeObserver https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver\n \n @overload\n * @param {HookTarget} target The target element to observe\n * @param {boolean} [options.enabled=true] The enabled state of the resize observer\n * @param {ResizeObserverBoxOptions} [options.box] The box model to observe\n * @param {UseResizeObserverCallback} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n \n @example\n * const { entries, observer } = useResizeObserver(ref);\n \n @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The enabled state of the resize observer\n * @param {ResizeObserverBoxOptions} [options.box] The box model to observe\n * @param {UseResizeObserverCallback} [options.onChange] The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n \n @example\n * const { ref, entry, observer } = useResizeObserver();\n \n @overload\n * @template Target The target element\n * @param {UseResizeObserverCallback} callback The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n \n @example\n * const { ref, entry, observer } = useResizeObserver((entry) => console.log(entry));\n \n @overload\n * @param {HookTarget} target The target element to observe\n * @param {UseResizeObserverCallback} callback The callback to execute when resize is detected\n * @returns {UseResizeObserverReturn} An object containing the resize observer state\n \n @example\n * const { entry, observer } = useResizeObserver(ref, (entry) => console.log(entry));\n */\nexport const useResizeObserver = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n\n const options = (\n target\n ? typeof params[1] === 'object'\n ? params[1]\n : { onChange: params[1] }\n : typeof params[0] === 'object'\n ? params[0]\n : { onChange: params[0] }\n ) as UseResizeObserverOptions \| undefined;\n\n const callback = options?.onChange;\n const enabled = options?.enabled ?? true;\n\n const [entry, setEntry] = useState<ResizeObserverEntry>();\n const [observer, setObserver] = useState<ResizeObserver>();\n\n const internalRef = useRefState<Element>();\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n\n useEffect(() => {\n if (!enabled \|\| (!target && !internalRef.state)) return;\n\n const element = target ? getElement(target) : internalRef.current;\n if (!element) return;\n\n const observer = new ResizeObserver(([entry], observer) => {\n setEntry(entry);\n internalCallbackRef.current?.(entry, observer);\n });\n\n setObserver(observer);\n observer.observe(element as Element, options);\n\n return () => {\n observer.disconnect();\n };\n }, [target, internalRef.state, options?.box, enabled]);\n\n if (target) return { entry, observer };\n return {\n ref: internalRef,\n entry,\n observer\n };\n}) as UseResizeObserver;\n"],"names":["useResizeObserver","params","target","isTarget","options","callback","enabled","entry","setEntry","useState","observer","setObserver","internalRef","useRefState","internalCallbackRef","useRef","useEffect","element","getElement"],"mappings":"mPA4FaA,EAAqB,IAAIC,IAAkB,CACtD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAE5CG,EACJF,EACI,OAAOD,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EACtB,OAAOA,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EAGtBI,EAAWD,GAAS,SACpBE,EAAUF,GAAS,SAAW,GAE9B,CAACG,EAAOC,CAAQ,EAAIC,WAAA,EACpB,CAACC,EAAUC,CAAW,EAAIF,WAAA,EAE1BG,EAAcC,EAAAA,YAAA,EACdC,EAAsBC,EAAAA,OAAOV,CAAQ,EAsB3C,OArBAS,EAAoB,QAAUT,EAE9BW,EAAAA,UAAU,IAAM,CACd,GAAI,CAACV,GAAY,CAACJ,GAAU,CAACU,EAAY,MAAQ,OAEjD,MAAMK,EAAUf,EAASgB,EAAAA,WAAWhB,CAAM,EAAIU,EAAY,QAC1D,GAAI,CAACK,EAAS,OAEd,MAAMP,EAAW,IAAI,eAAe,CAAC,CAACH,CAAK,EAAGG,IAAa,CACzDF,EAASD,CAAK,EACdO,EAAoB,UAAUP,EAAOG,CAAQ,CAAA,CAC9C,EAED,OAAAC,EAAYD,CAAQ,EACpBA,EAAS,QAAQO,EAAoBb,CAAO,EAErC,IAAM,CACXM,EAAS,WAAA,CAAW,CACtB,EACC,CAACR,EAAQU,EAAY,MAAOR,GAAS,IAAKE,CAAO,CAAC,EAEjDJ,EAAe,CAAE,MAAAK,EAAO,SAAAG,CAAA,EACrB,CACL,IAAKE,EACL,MAAAL,EACA,SAAAG,CAAA,CAEJ"}

package/dist/cjs/hooks/useRightClick/useRightClick.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useRightClick.cjs","sources":["../../../../src/hooks/useRightClick/useRightClick.ts"],"sourcesContent":["import { useEffect, useRef } 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\nexport type RightClickEvent = MouseEvent \| TouchEvent;\nexport interface RightClickPositions {\n x: number;\n y: number;\n}\n\nexport interface UseRightClickOptions {\n // * The callback function to be invoked on right click end\n onEnd?: (event: RightClickEvent) => void;\n // * The callback function to be invoked on right click start\n onStart?: (event: RightClickEvent) => void;\n}\n\nexport interface UseRightClick {\n (target: HookTarget, callback: (event: Event) => void, options?: UseRightClickOptions): void;\n\n <Target extends Element>(\n callback: (positions: RightClickPositions, event: Event) => void,\n options?: UseRightClickOptions,\n target?: never\n ): StateRef<Target>;\n}\n\n/*\n @name useRightClick\n * @description - Hook that handles right-click events and long press on mobile devices\n * @category Elements\n \n @overload\n * @param {HookTarget} target The target element for right-click handling\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {void}\n \n @example\n * useRightClick(ref, () => console.log('clicked'));\n \n @overload\n * @template Target The target element\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {StateRef<Target>} Ref to attach to the element\n \n @example\n * const ref = useRightClick(() => console.log('clicked'));\n */\nexport const useRightClick = ((...params: any[]): any => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const callback = (target ? params[1] : params[0]) as (\n positions: RightClickPositions,\n event: RightClickEvent\n ) => void;\n const options = (target ? params[2] : params[1]) as UseRightClickOptions;\n\n const internalRef = useRefState<Element>();\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n const internalOptionsRef = useRef(options);\n internalOptionsRef.current = options;\n\n useEffect(() => {\n if (!target && !internalRef.state) return;\n\n const element = target ? getElement(target) : internalRef.current;\n if (!element) return;\n\n const onContextMenu = (event: RightClickEvent) => {\n event.preventDefault();\n internalOptionsRef.current?.onStart?.(event);\n const mouseEvent = event as MouseEvent;\n internalCallbackRef.current({ x: mouseEvent.clientX, y: mouseEvent.clientY }, event);\n };\n\n const onTouchStart = (event: RightClickEvent) => {\n event.preventDefault();\n internalOptionsRef.current?.onStart?.(event);\n const touchEvent = event as TouchEvent;\n internalCallbackRef.current(\n { x: touchEvent.touches[0].clientX, y: touchEvent.touches[0].clientY },\n event\n );\n };\n\n const onTouchEnd = (event: RightClickEvent) => {\n event.preventDefault();\n internalOptionsRef.current?.onEnd?.(event);\n };\n\n element.addEventListener('contextmenu', onContextMenu as EventListener);\n\n element.addEventListener('touchstart', onTouchStart as EventListener);\n element.addEventListener('touchend', onTouchEnd as EventListener);\n\n return () => {\n element.removeEventListener('contextmenu', onContextMenu as EventListener);\n\n element.removeEventListener('touchstart', onTouchStart as EventListener);\n element.removeEventListener('touchend', onTouchEnd as EventListener);\n };\n }, [target, internalRef.state]);\n\n if (target) return;\n return internalRef;\n}) as UseRightClick;\n"],"names":["useRightClick","params","target","isTarget","callback","options","internalRef","useRefState","internalCallbackRef","useRef","internalOptionsRef","useEffect","element","getElement","onContextMenu","event","mouseEvent","onTouchStart","touchEvent","onTouchEnd"],"mappings":"~~mPAsDaA~~,EAAiB,IAAIC,IAAuB,CACvD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EAAYF,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EAIzCI,EAAWH,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EAExCK,EAAcC,EAAAA,YAAA,EACdC,EAAsBC,EAAAA,OAAOL,CAAQ,EAC3CI,EAAoB,QAAUJ,EAC9B,MAAMM,EAAqBD,EAAAA,OAAOJ,CAAO,EA4CzC,GA3CAK,EAAmB,QAAUL,EAE7BM,EAAAA,UAAU,IAAM,CACd,GAAI,CAACT,GAAU,CAACI,EAAY,MAAO,OAEnC,MAAMM,EAAUV,EAASW,EAAAA,WAAWX,CAAM,EAAII,EAAY,QAC1D,GAAI,CAACM,EAAS,OAEd,MAAME,EAAiBC,GAA2B,CAChDA,EAAM,eAAA,EACNL,EAAmB,SAAS,UAAUK,CAAK,EAC3C,MAAMC,EAAaD,EACnBP,EAAoB,QAAQ,CAAE,EAAGQ,EAAW,QAAS,EAAGA,EAAW,OAAA,EAAWD,CAAK,CAAA,EAG/EE,EAAgBF,GAA2B,CAC/CA,EAAM,eAAA,EACNL,EAAmB,SAAS,UAAUK,CAAK,EAC3C,MAAMG,EAAaH,EACnBP,EAAoB,QAClB,CAAE,EAAGU,EAAW,QAAQ,CAAC,EAAE,QAAS,EAAGA,EAAW,QAAQ,CAAC,EAAE,OAAA,EAC7DH,CAAA,CACF,EAGII,EAAcJ,GAA2B,CAC7CA,EAAM,eAAA,EACNL,EAAmB,SAAS,QAAQK,CAAK,CAAA,EAG3C,OAAAH,EAAQ,iBAAiB,cAAeE,CAA8B,EAEtEF,EAAQ,iBAAiB,aAAcK,CAA6B,EACpEL,EAAQ,iBAAiB,WAAYO,CAA2B,EAEzD,IAAM,CACXP,EAAQ,oBAAoB,cAAeE,CAA8B,EAEzEF,EAAQ,oBAAoB,aAAcK,CAA6B,EACvEL,EAAQ,oBAAoB,WAAYO,CAA2B,CAAA,CACrE,EACC,CAACjB,EAAQI,EAAY,KAAK,CAAC,EAE1B,CAAAJ,EACJ,OAAOI,CACT"}
1	+ {"version":3,"file":"useRightClick.cjs","sources":["../../../../src/hooks/useRightClick/useRightClick.ts"],"sourcesContent":["import { useEffect, useRef } 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\nexport type RightClickEvent = MouseEvent \| TouchEvent;\nexport interface RightClickPositions {\n x: number;\n y: number;\n}\n\nexport interface UseRightClickOptions {\n // * The callback function to be invoked on right click end\n onEnd?: (event: RightClickEvent) => void;\n // * The callback function to be invoked on right click start\n onStart?: (event: RightClickEvent) => void;\n}\n\nexport interface UseRightClick {\n (target: HookTarget, callback: (event: Event) => void, options?: UseRightClickOptions): void;\n\n <Target extends Element>(\n callback: (positions: RightClickPositions, event: Event) => void,\n options?: UseRightClickOptions,\n target?: never\n ): StateRef<Target>;\n}\n\n/*\n @name useRightClick\n * @description - Hook that handles right-click events and long press on mobile devices\n * @category Elements\n * @usage low\n \n @overload\n * @param {HookTarget} target The target element for right-click handling\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {void}\n \n @example\n * useRightClick(ref, () => console.log('clicked'));\n \n @overload\n * @template Target The target element\n * @param {(event: RightClickEvents) => void} callback The callback function to be invoked on right click\n * @returns {StateRef<Target>} Ref to attach to the element\n \n @example\n * const ref = useRightClick(() => console.log('clicked'));\n */\nexport const useRightClick = ((...params: any[]): any => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const callback = (target ? params[1] : params[0]) as (\n positions: RightClickPositions,\n event: RightClickEvent\n ) => void;\n const options = (target ? params[2] : params[1]) as UseRightClickOptions;\n\n const internalRef = useRefState<Element>();\n const internalCallbackRef = useRef(callback);\n internalCallbackRef.current = callback;\n const internalOptionsRef = useRef(options);\n internalOptionsRef.current = options;\n\n useEffect(() => {\n if (!target && !internalRef.state) return;\n\n const element = target ? getElement(target) : internalRef.current;\n if (!element) return;\n\n const onContextMenu = (event: RightClickEvent) => {\n event.preventDefault();\n internalOptionsRef.current?.onStart?.(event);\n const mouseEvent = event as MouseEvent;\n internalCallbackRef.current({ x: mouseEvent.clientX, y: mouseEvent.clientY }, event);\n };\n\n const onTouchStart = (event: RightClickEvent) => {\n event.preventDefault();\n internalOptionsRef.current?.onStart?.(event);\n const touchEvent = event as TouchEvent;\n internalCallbackRef.current(\n { x: touchEvent.touches[0].clientX, y: touchEvent.touches[0].clientY },\n event\n );\n };\n\n const onTouchEnd = (event: RightClickEvent) => {\n event.preventDefault();\n internalOptionsRef.current?.onEnd?.(event);\n };\n\n element.addEventListener('contextmenu', onContextMenu as EventListener);\n\n element.addEventListener('touchstart', onTouchStart as EventListener);\n element.addEventListener('touchend', onTouchEnd as EventListener);\n\n return () => {\n element.removeEventListener('contextmenu', onContextMenu as EventListener);\n\n element.removeEventListener('touchstart', onTouchStart as EventListener);\n element.removeEventListener('touchend', onTouchEnd as EventListener);\n };\n }, [target, internalRef.state]);\n\n if (target) return;\n return internalRef;\n}) as UseRightClick;\n"],"names":["useRightClick","params","target","isTarget","callback","options","internalRef","useRefState","internalCallbackRef","useRef","internalOptionsRef","useEffect","element","getElement","onContextMenu","event","mouseEvent","onTouchStart","touchEvent","onTouchEnd"],"mappings":"mPAuDaA,EAAiB,IAAIC,IAAuB,CACvD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EAAYF,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EAIzCI,EAAWH,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EAExCK,EAAcC,EAAAA,YAAA,EACdC,EAAsBC,EAAAA,OAAOL,CAAQ,EAC3CI,EAAoB,QAAUJ,EAC9B,MAAMM,EAAqBD,EAAAA,OAAOJ,CAAO,EA4CzC,GA3CAK,EAAmB,QAAUL,EAE7BM,EAAAA,UAAU,IAAM,CACd,GAAI,CAACT,GAAU,CAACI,EAAY,MAAO,OAEnC,MAAMM,EAAUV,EAASW,EAAAA,WAAWX,CAAM,EAAII,EAAY,QAC1D,GAAI,CAACM,EAAS,OAEd,MAAME,EAAiBC,GAA2B,CAChDA,EAAM,eAAA,EACNL,EAAmB,SAAS,UAAUK,CAAK,EAC3C,MAAMC,EAAaD,EACnBP,EAAoB,QAAQ,CAAE,EAAGQ,EAAW,QAAS,EAAGA,EAAW,OAAA,EAAWD,CAAK,CAAA,EAG/EE,EAAgBF,GAA2B,CAC/CA,EAAM,eAAA,EACNL,EAAmB,SAAS,UAAUK,CAAK,EAC3C,MAAMG,EAAaH,EACnBP,EAAoB,QAClB,CAAE,EAAGU,EAAW,QAAQ,CAAC,EAAE,QAAS,EAAGA,EAAW,QAAQ,CAAC,EAAE,OAAA,EAC7DH,CAAA,CACF,EAGII,EAAcJ,GAA2B,CAC7CA,EAAM,eAAA,EACNL,EAAmB,SAAS,QAAQK,CAAK,CAAA,EAG3C,OAAAH,EAAQ,iBAAiB,cAAeE,CAA8B,EAEtEF,EAAQ,iBAAiB,aAAcK,CAA6B,EACpEL,EAAQ,iBAAiB,WAAYO,CAA2B,EAEzD,IAAM,CACXP,EAAQ,oBAAoB,cAAeE,CAA8B,EAEzEF,EAAQ,oBAAoB,aAAcK,CAA6B,EACvEL,EAAQ,oBAAoB,WAAYO,CAA2B,CAAA,CACrE,EACC,CAACjB,EAAQI,EAAY,KAAK,CAAC,EAE1B,CAAAJ,EACJ,OAAOI,CACT"}

package/dist/cjs/hooks/useScript/useScript.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useScript.cjs","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":"yGAMaA,EAA+B,~~gBAsB~~/BC,EAAY,CAACC,EAAaC,EAA4B,KAAO,CACxE,KAAM,CAACC,EAAQC,CAAS,EAAIC,EAAAA,SAA0B,IAAM,CAC1D,MAAMC,EAAS,SAAS,cAAc,eAAeL,CAAG,IAAI,EACtDM,EAAeD,GAAQ,aAAaP,CAA4B,EACtE,OAAIQ,IACAD,EAAe,UAEZ,UAAA,CACR,EACK,CAAE,gBAAAE,EAAkB,GAAM,MAAAC,EAAQ,IAASP,EAEjDQ,OAAAA,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAgB,SAAS,cAAc,eAAeV,CAAG,IAAI,EAC7DM,EAAeI,GAAe,aAClCZ,CAAA,EAEF,GAAIQ,EAAc,OAAOH,EAAUG,CAAY,EAC/C,GAAII,EAAe,OAAOP,EAAU,SAAS,EAE7C,MAAME,EAAS,SAAS,cAAc,QAAQ,EAC9CA,EAAO,IAAML,EACbK,EAAO,MAAQG,EAEf,SAAW,CAACG,EAAKC,CAAK,IAAK,OAAO,QAAQX,CAAO,EAC/CI,EAAO,aAAaM,EAAK,OAAOC,CAAK,CAAC,EAGxCP,EAAO,aAAaP,EAA8B,SAAS,EAC3D,SAAS,KAAK,YAAYO,CAAM,EAEhC,MAAMQ,EAAS,IAAM,CACnBR,EAAO,aAAaP,EAA8B,OAAO,EACzDK,EAAU,OAAO,CAAA,EAGbW,EAAU,IAAM,CACpBT,EAAO,aAAaP,EAA8B,OAAO,EACzDK,EAAU,OAAO,CAAA,EAGnB,OAAAE,EAAO,iBAAiB,OAAQQ,CAAM,EACtCR,EAAO,iBAAiB,QAASS,CAAO,EAEjC,IAAM,CACPP,KAAwB,OAAA,EAC5BF,EAAO,oBAAoB,OAAQQ,CAAM,EACzCR,EAAO,oBAAoB,QAASS,CAAO,CAAA,CAC7C,EACC,CAACd,EAAKO,CAAe,CAAC,EAElBL,CACT"}
1	+ {"version":3,"file":"useScript.cjs","sources":["../../../../src/hooks/useScript/useScript.ts"],"sourcesContent":["import type { ComponentProps } from 'react';\n\nimport { useEffect, useState } from 'react';\n\n/** The use script status /\nexport type UseScriptStatus = 'error' \| 'loading' \| 'ready' \| 'unknown';\nexport const SCRIPT_STATUS_ATTRIBUTE_NAME = 'script-status';\n\n/* The use script options extends from attributes script tag /\nexport interface UseScriptOptions extends ComponentProps<'script'> {\n /* Whether to remove the script on unmount /\n removeOnUnmount?: boolean;\n}\n\n/\n @name useScript\n * @description - Hook that manages a script with onLoad, onError, and removeOnUnmount functionalities\n * @category Elements\n * @usage low\n \n @param {string} src The source of the script\n * @param {UseScriptOptions} [options] The options of the script extends from attributes script tag\n * @param {boolean} [options.removeOnUnmount=true] Whether to remove the script on unmount\n * @param {boolean} [options.async=true] Whether to load the script asynchronously\n * @returns {UseScriptStatus} The status of the script\n \n @example\n * const status = useScript('https://example.com/script.js');\n */\nexport const useScript = (src: string, options: UseScriptOptions = {}) => {\n const [status, setStatus] = useState<UseScriptStatus>(() => {\n const script = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n const scriptStatus = script?.getAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME) as UseScriptStatus;\n if (scriptStatus) return scriptStatus;\n if (script) return 'unknown';\n\n return 'loading';\n });\n const { removeOnUnmount = true, async = true } = options;\n\n useEffect(() => {\n const existedScript = document.querySelector(`script[src=\"${src}\"]`) as HTMLScriptElement;\n const scriptStatus = existedScript?.getAttribute(\n SCRIPT_STATUS_ATTRIBUTE_NAME\n ) as UseScriptStatus;\n if (scriptStatus) return setStatus(scriptStatus);\n if (existedScript) return setStatus('unknown');\n\n const script = document.createElement('script');\n script.src = src;\n script.async = async;\n\n for (const [key, value] of Object.entries(options)) {\n script.setAttribute(key, String(value));\n }\n\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'loading');\n document.body.appendChild(script);\n\n const onLoad = () => {\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'ready');\n setStatus('ready');\n };\n\n const onError = () => {\n script.setAttribute(SCRIPT_STATUS_ATTRIBUTE_NAME, 'error');\n setStatus('error');\n };\n\n script.addEventListener('load', onLoad);\n script.addEventListener('error', onError);\n\n return () => {\n if (removeOnUnmount) script.remove();\n script.removeEventListener('load', onLoad);\n script.removeEventListener('error', onError);\n };\n }, [src, removeOnUnmount]);\n\n return status;\n};\n"],"names":["SCRIPT_STATUS_ATTRIBUTE_NAME","useScript","src","options","status","setStatus","useState","script","scriptStatus","removeOnUnmount","async","useEffect","existedScript","key","value","onLoad","onError"],"mappings":"yGAMaA,EAA+B,gBAuB/BC,EAAY,CAACC,EAAaC,EAA4B,KAAO,CACxE,KAAM,CAACC,EAAQC,CAAS,EAAIC,EAAAA,SAA0B,IAAM,CAC1D,MAAMC,EAAS,SAAS,cAAc,eAAeL,CAAG,IAAI,EACtDM,EAAeD,GAAQ,aAAaP,CAA4B,EACtE,OAAIQ,IACAD,EAAe,UAEZ,UAAA,CACR,EACK,CAAE,gBAAAE,EAAkB,GAAM,MAAAC,EAAQ,IAASP,EAEjDQ,OAAAA,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAgB,SAAS,cAAc,eAAeV,CAAG,IAAI,EAC7DM,EAAeI,GAAe,aAClCZ,CAAA,EAEF,GAAIQ,EAAc,OAAOH,EAAUG,CAAY,EAC/C,GAAII,EAAe,OAAOP,EAAU,SAAS,EAE7C,MAAME,EAAS,SAAS,cAAc,QAAQ,EAC9CA,EAAO,IAAML,EACbK,EAAO,MAAQG,EAEf,SAAW,CAACG,EAAKC,CAAK,IAAK,OAAO,QAAQX,CAAO,EAC/CI,EAAO,aAAaM,EAAK,OAAOC,CAAK,CAAC,EAGxCP,EAAO,aAAaP,EAA8B,SAAS,EAC3D,SAAS,KAAK,YAAYO,CAAM,EAEhC,MAAMQ,EAAS,IAAM,CACnBR,EAAO,aAAaP,EAA8B,OAAO,EACzDK,EAAU,OAAO,CAAA,EAGbW,EAAU,IAAM,CACpBT,EAAO,aAAaP,EAA8B,OAAO,EACzDK,EAAU,OAAO,CAAA,EAGnB,OAAAE,EAAO,iBAAiB,OAAQQ,CAAM,EACtCR,EAAO,iBAAiB,QAASS,CAAO,EAEjC,IAAM,CACPP,KAAwB,OAAA,EAC5BF,EAAO,oBAAoB,OAAQQ,CAAM,EACzCR,EAAO,oBAAoB,QAASS,CAAO,CAAA,CAC7C,EACC,CAACd,EAAKO,CAAe,CAAC,EAElBL,CACT"}

package/dist/cjs/hooks/useScroll/useScroll.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useScroll.cjs","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":"mPAUMA,EAAiC,~~EAgH1BC~~,EAAa,IAAIC,IAAkB,CAC9C,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EACJF,EACI,OAAOD,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EACtB,OAAOA,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EAGtBI,EAAcC,EAAAA,YAAA,EACdC,EAAqBC,EAAAA,OAAOJ,CAAO,EACzCG,EAAmB,QAAUH,EAE7B,KAAM,CAACK,EAAWC,CAAY,EAAIC,EAAAA,SAAS,EAAK,EAC1CC,EAAoBJ,EAAAA,OAAO,CAAE,EAAG,EAAG,EAAG,EAAG,EAqE/C,OAnEAK,EAAAA,UAAU,IAAM,CACd,GAAI,CAACX,GAAU,CAACG,EAAY,MAAO,OACnC,MAAMS,EAAWZ,EAASa,EAAAA,WAAWb,CAAM,EAAIG,EAAY,QAE3D,GAAI,CAACS,EAAS,OAEd,MAAME,EAAeC,GAAiB,CACpCP,EAAa,EAAK,EAClBN,GAAS,SAASa,CAAK,CAAA,EAGnBC,EAAYD,GAAiB,CACjCP,EAAa,EAAI,EACjB,MAAMR,EACJe,EAAM,SAAW,SAAYA,EAAM,OAAoB,gBAAkBA,EAAM,OAG3E,CAAE,QAAAE,EAAS,cAAAC,EAAe,UAAAC,CAAA,EAAcnB,EAAO,MAC/CoB,EAAsBD,IAAc,MAAQ,GAAK,EAEjDE,EAAarB,EAAO,WAC1B,IAAIsB,EAAYtB,EAAO,UACnBA,aAAkB,UAAY,CAACsB,IAAWA,EAAY,OAAO,SAAS,KAAK,WAE/E,MAAMC,EAASlB,EAAmB,SAAS,OACrCmB,EAAOH,EAAaD,IAAwBG,GAAQ,MAAQ,GAC5DE,EACJJ,EAAaD,EAAsBpB,EAAO,aAC1CA,EAAO,aAAeuB,GAAQ,OAAS,GAAK1B,EACxC6B,EAAMJ,IAAcC,GAAQ,KAAO,GACnCI,EACJL,EAAYtB,EAAO,cACnBA,EAAO,cAAgBuB,GAAQ,QAAU,GAAK1B,EAE1C+B,EAAkBX,IAAY,QAAUC,IAAkB,iBAC1DW,EAAeZ,IAAY,QAAUC,IAAkB,iBAEvDnB,EAAS,CACb,EAAGsB,EACH,EAAGC,EACH,WAAY,CACV,KAAMD,EAAaX,EAAkB,QAAQ,EAC7C,MAAOW,EAAaX,EAAkB,QAAQ,EAC9C,IAAKY,EAAYZ,EAAkB,QAAQ,EAC3C,OAAQY,EAAYZ,EAAkB,QAAQ,CAAA,EAEhD,QAAS,CACP,KAAMmB,EAAeJ,EAAQD,EAC7B,MAAOK,EAAeL,EAAOC,EAC7B,IAAKG,EAAkBD,EAASD,EAChC,OAAQE,EAAkBF,EAAMC,CAAA,CAClC,EAGFjB,EAAkB,QAAU,CAAE,EAAGW,EAAY,EAAGC,CAAA,EAChDjB,EAAmB,SAAS,WAAWN,EAAQgB,CAAK,CAAA,EAGtD,OAAAH,EAAQ,iBAAiB,SAAUI,CAAQ,EAC3CJ,EAAQ,iBAAiB,YAAaE,CAAW,EAE1C,IAAM,CACXF,EAAQ,oBAAoB,SAAUI,CAAQ,EAC9CJ,EAAQ,oBAAoB,YAAaE,CAAW,CAAA,CACtD,EACC,CAACd,EAAQG,EAAY,KAAK,CAAC,EAE1BH,EAAeO,EACZ,CACL,IAAKJ,EACL,UAAAI,CAAA,CAEJ"}
1	+ {"version":3,"file":"useScroll.cjs","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 * @usage low\n \n @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0] The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {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":"mPAUMA,EAAiC,EAiH1BC,EAAa,IAAIC,IAAkB,CAC9C,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EACJF,EACI,OAAOD,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EACtB,OAAOA,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EAGtBI,EAAcC,EAAAA,YAAA,EACdC,EAAqBC,EAAAA,OAAOJ,CAAO,EACzCG,EAAmB,QAAUH,EAE7B,KAAM,CAACK,EAAWC,CAAY,EAAIC,EAAAA,SAAS,EAAK,EAC1CC,EAAoBJ,EAAAA,OAAO,CAAE,EAAG,EAAG,EAAG,EAAG,EAqE/C,OAnEAK,EAAAA,UAAU,IAAM,CACd,GAAI,CAACX,GAAU,CAACG,EAAY,MAAO,OACnC,MAAMS,EAAWZ,EAASa,EAAAA,WAAWb,CAAM,EAAIG,EAAY,QAE3D,GAAI,CAACS,EAAS,OAEd,MAAME,EAAeC,GAAiB,CACpCP,EAAa,EAAK,EAClBN,GAAS,SAASa,CAAK,CAAA,EAGnBC,EAAYD,GAAiB,CACjCP,EAAa,EAAI,EACjB,MAAMR,EACJe,EAAM,SAAW,SAAYA,EAAM,OAAoB,gBAAkBA,EAAM,OAG3E,CAAE,QAAAE,EAAS,cAAAC,EAAe,UAAAC,CAAA,EAAcnB,EAAO,MAC/CoB,EAAsBD,IAAc,MAAQ,GAAK,EAEjDE,EAAarB,EAAO,WAC1B,IAAIsB,EAAYtB,EAAO,UACnBA,aAAkB,UAAY,CAACsB,IAAWA,EAAY,OAAO,SAAS,KAAK,WAE/E,MAAMC,EAASlB,EAAmB,SAAS,OACrCmB,EAAOH,EAAaD,IAAwBG,GAAQ,MAAQ,GAC5DE,EACJJ,EAAaD,EAAsBpB,EAAO,aAC1CA,EAAO,aAAeuB,GAAQ,OAAS,GAAK1B,EACxC6B,EAAMJ,IAAcC,GAAQ,KAAO,GACnCI,EACJL,EAAYtB,EAAO,cACnBA,EAAO,cAAgBuB,GAAQ,QAAU,GAAK1B,EAE1C+B,EAAkBX,IAAY,QAAUC,IAAkB,iBAC1DW,EAAeZ,IAAY,QAAUC,IAAkB,iBAEvDnB,EAAS,CACb,EAAGsB,EACH,EAAGC,EACH,WAAY,CACV,KAAMD,EAAaX,EAAkB,QAAQ,EAC7C,MAAOW,EAAaX,EAAkB,QAAQ,EAC9C,IAAKY,EAAYZ,EAAkB,QAAQ,EAC3C,OAAQY,EAAYZ,EAAkB,QAAQ,CAAA,EAEhD,QAAS,CACP,KAAMmB,EAAeJ,EAAQD,EAC7B,MAAOK,EAAeL,EAAOC,EAC7B,IAAKG,EAAkBD,EAASD,EAChC,OAAQE,EAAkBF,EAAMC,CAAA,CAClC,EAGFjB,EAAkB,QAAU,CAAE,EAAGW,EAAY,EAAGC,CAAA,EAChDjB,EAAmB,SAAS,WAAWN,EAAQgB,CAAK,CAAA,EAGtD,OAAAH,EAAQ,iBAAiB,SAAUI,CAAQ,EAC3CJ,EAAQ,iBAAiB,YAAaE,CAAW,EAE1C,IAAM,CACXF,EAAQ,oBAAoB,SAAUI,CAAQ,EAC9CJ,EAAQ,oBAAoB,YAAaE,CAAW,CAAA,CACtD,EACC,CAACd,EAAQG,EAAY,KAAK,CAAC,EAE1BH,EAAeO,EACZ,CACL,IAAKJ,EACL,UAAAI,CAAA,CAEJ"}

package/dist/cjs/hooks/useScrollIntoView/useScrollIntoView.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useScrollIntoView.cjs","sources":["../../../../src/hooks/useScrollIntoView/useScrollIntoView.ts"],"sourcesContent":["import { useEffect } 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 scroll into view options type /\nexport interface UseScrollIntoViewOptions extends ScrollIntoViewOptions {\n /* Whether to enable the scroll into view /\n enabled?: boolean;\n}\n\n/* The scroll into view return type /\nexport interface UseScrollIntoViewReturn {\n /* Function to scroll element into view /\n trigger: (params?: {\n behavior?: ScrollBehavior;\n block?: ScrollLogicalPosition;\n inline?: ScrollLogicalPosition;\n }) => void;\n}\n\nexport interface UseScrollIntoView {\n <Target extends Element>(\n options?: UseScrollIntoViewOptions,\n target?: never\n ): UseScrollIntoViewReturn & { ref: StateRef<Target> };\n\n (target: HookTarget, options?: UseScrollIntoViewOptions): UseScrollIntoViewReturn;\n}\n\n/\n @name useScrollIntoView\n * @description - Hook that provides functionality to scroll an element into view\n * @category Sensors\n \n @overload\n * @param {HookTarget} target The target element to scroll into view\n * @param {ScrollBehavior} [options.behavior='smooth'] The scrolling behavior\n * @param {ScrollLogicalPosition} [options.block='start'] The vertical alignment\n * @param {ScrollLogicalPosition} [options.inline='nearest'] The horizontal alignment\n * @returns {UseScrollIntoViewReturn} Object containing scroll function\n \n @example\n * const { trigger } = useScrollIntoView(ref);\n \n @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior='smooth'] The scrolling behavior\n * @param {ScrollLogicalPosition} [options.block='start'] The vertical alignment\n * @param {ScrollLogicalPosition} [options.inline='nearest'] The horizontal alignment\n * @returns {UseScrollIntoViewReturn & { ref: StateRef<Target> }} Object containing scroll function and ref\n \n @example\n * const { ref, trigger } = useScrollIntoView<HTMLDivElement>();\n */\nexport const useScrollIntoView = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (target ? params[1] : params[0]) as UseScrollIntoViewOptions \| undefined;\n\n const internalRef = useRefState<Element>();\n const {\n behavior = 'smooth',\n block = 'start',\n inline = 'nearest',\n enabled = true\n } = options ?? {};\n\n useEffect(() => {\n if (!enabled) return;\n if (!target && !internalRef.state) return;\n\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n\n element.scrollIntoView({\n behavior,\n block,\n inline\n });\n }, [target, internalRef.state, enabled]);\n\n const trigger = (params?: {\n behavior?: ScrollBehavior;\n block?: ScrollLogicalPosition;\n inline?: ScrollLogicalPosition;\n }) => {\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n\n const { behavior, block, inline } = params ?? {};\n\n element.scrollIntoView({\n behavior,\n block,\n inline\n });\n };\n\n if (target) return { trigger };\n return { ref: internalRef, trigger };\n}) as UseScrollIntoView;\n"],"names":["useScrollIntoView","params","target","isTarget","options","internalRef","useRefState","behavior","block","inline","enabled","useEffect","element","getElement","trigger"],"mappings":"~~mPA4DaA~~,EAAqB,IAAIC,IAAkB,CACtD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EAAWF,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EAExCI,EAAcC,EAAAA,YAAA,EACd,CACJ,SAAAC,EAAW,SACX,MAAAC,EAAQ,QACR,OAAAC,EAAS,UACT,QAAAC,EAAU,EAAA,EACRN,GAAW,CAAA,EAEfO,EAAAA,UAAU,IAAM,CAEd,GADI,CAACD,GACD,CAACR,GAAU,CAACG,EAAY,MAAO,OAEnC,MAAMO,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIG,EAAY,QACtDO,GAELA,EAAQ,eAAe,CACrB,SAAAL,EACA,MAAAC,EACA,OAAAC,CAAA,CACD,CAAA,EACA,CAACP,EAAQG,EAAY,MAAOK,CAAO,CAAC,EAEvC,MAAMI,EAAWb,GAIX,CACJ,MAAMW,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIG,EAAY,QAC3D,GAAI,CAACO,EAAS,OAEd,KAAM,CAAE,SAAAL,EAAU,MAAAC,EAAO,OAAAC,GAAWR,GAAU,CAAA,EAE9CW,EAAQ,eAAe,CACrB,SAAAL,EACA,MAAAC,EACA,OAAAC,CAAA,CACD,CAAA,EAGH,OAAIP,EAAe,CAAE,QAAAY,CAAA,EACd,CAAE,IAAKT,EAAa,QAAAS,CAAA,CAC7B"}
1	+ {"version":3,"file":"useScrollIntoView.cjs","sources":["../../../../src/hooks/useScrollIntoView/useScrollIntoView.ts"],"sourcesContent":["import { useEffect } 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 scroll into view options type /\nexport interface UseScrollIntoViewOptions extends ScrollIntoViewOptions {\n /* Whether to enable the scroll into view /\n enabled?: boolean;\n}\n\n/* The scroll into view return type /\nexport interface UseScrollIntoViewReturn {\n /* Function to scroll element into view /\n trigger: (params?: {\n behavior?: ScrollBehavior;\n block?: ScrollLogicalPosition;\n inline?: ScrollLogicalPosition;\n }) => void;\n}\n\nexport interface UseScrollIntoView {\n <Target extends Element>(\n options?: UseScrollIntoViewOptions,\n target?: never\n ): UseScrollIntoViewReturn & { ref: StateRef<Target> };\n\n (target: HookTarget, options?: UseScrollIntoViewOptions): UseScrollIntoViewReturn;\n}\n\n/\n @name useScrollIntoView\n * @description - Hook that provides functionality to scroll an element into view\n * @category Sensors\n * @usage low\n \n @overload\n * @param {HookTarget} target The target element to scroll into view\n * @param {ScrollBehavior} [options.behavior='smooth'] The scrolling behavior\n * @param {ScrollLogicalPosition} [options.block='start'] The vertical alignment\n * @param {ScrollLogicalPosition} [options.inline='nearest'] The horizontal alignment\n * @returns {UseScrollIntoViewReturn} Object containing scroll function\n \n @example\n * const { trigger } = useScrollIntoView(ref);\n \n @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior='smooth'] The scrolling behavior\n * @param {ScrollLogicalPosition} [options.block='start'] The vertical alignment\n * @param {ScrollLogicalPosition} [options.inline='nearest'] The horizontal alignment\n * @returns {UseScrollIntoViewReturn & { ref: StateRef<Target> }} Object containing scroll function and ref\n \n @example\n * const { ref, trigger } = useScrollIntoView<HTMLDivElement>();\n */\nexport const useScrollIntoView = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (target ? params[1] : params[0]) as UseScrollIntoViewOptions \| undefined;\n\n const internalRef = useRefState<Element>();\n const {\n behavior = 'smooth',\n block = 'start',\n inline = 'nearest',\n enabled = true\n } = options ?? {};\n\n useEffect(() => {\n if (!enabled) return;\n if (!target && !internalRef.state) return;\n\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n\n element.scrollIntoView({\n behavior,\n block,\n inline\n });\n }, [target, internalRef.state, enabled]);\n\n const trigger = (params?: {\n behavior?: ScrollBehavior;\n block?: ScrollLogicalPosition;\n inline?: ScrollLogicalPosition;\n }) => {\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n\n const { behavior, block, inline } = params ?? {};\n\n element.scrollIntoView({\n behavior,\n block,\n inline\n });\n };\n\n if (target) return { trigger };\n return { ref: internalRef, trigger };\n}) as UseScrollIntoView;\n"],"names":["useScrollIntoView","params","target","isTarget","options","internalRef","useRefState","behavior","block","inline","enabled","useEffect","element","getElement","trigger"],"mappings":"mPA6DaA,EAAqB,IAAIC,IAAkB,CACtD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EAAWF,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EAExCI,EAAcC,EAAAA,YAAA,EACd,CACJ,SAAAC,EAAW,SACX,MAAAC,EAAQ,QACR,OAAAC,EAAS,UACT,QAAAC,EAAU,EAAA,EACRN,GAAW,CAAA,EAEfO,EAAAA,UAAU,IAAM,CAEd,GADI,CAACD,GACD,CAACR,GAAU,CAACG,EAAY,MAAO,OAEnC,MAAMO,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIG,EAAY,QACtDO,GAELA,EAAQ,eAAe,CACrB,SAAAL,EACA,MAAAC,EACA,OAAAC,CAAA,CACD,CAAA,EACA,CAACP,EAAQG,EAAY,MAAOK,CAAO,CAAC,EAEvC,MAAMI,EAAWb,GAIX,CACJ,MAAMW,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIG,EAAY,QAC3D,GAAI,CAACO,EAAS,OAEd,KAAM,CAAE,SAAAL,EAAU,MAAAC,EAAO,OAAAC,GAAWR,GAAU,CAAA,EAE9CW,EAAQ,eAAe,CACrB,SAAAL,EACA,MAAAC,EACA,OAAAC,CAAA,CACD,CAAA,EAGH,OAAIP,EAAe,CAAE,QAAAY,CAAA,EACd,CAAE,IAAKT,EAAa,QAAAS,CAAA,CAC7B"}

package/dist/cjs/hooks/useScrollTo/useScrollTo.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useScrollTo.cjs","sources":["../../../../src/hooks/useScrollTo/useScrollTo.ts"],"sourcesContent":["import { useLayoutEffect } 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 scroll to options type /\nexport interface UseScrollToOptions {\n /* The scrolling behavior /\n behavior?: ScrollBehavior;\n /* Whether to enable the scroll to /\n enabled?: boolean;\n /* The horizontal position to scroll to /\n x: number;\n /* The vertical position to scroll to /\n y: number;\n}\n\n/* The use scroll to return type /\nexport interface UseScrollToReturn {\n /* The state of scrolling /\n trigger: (params?: { x: number; y: number; behavior?: ScrollBehavior }) => void;\n}\n\nexport interface UseScrollTo {\n <Target extends Element>(\n options?: UseScrollToOptions,\n target?: never\n ): UseScrollToReturn & { ref: StateRef<Target> };\n\n (target: HookTarget, options?: UseScrollToOptions): UseScrollToReturn;\n}\n\n/\n @name useScrollTo\n * @description - Hook for scrolling to a specific element\n * @category Sensors\n \n @overload\n * @param {HookTarget} target The target element for scrolling to\n * @param {UseScrollToOptions} [options] The scroll options\n * @returns {UseScrollToReturn} The scroll trigger function\n \n @example\n * const trigger = useScrollTo(ref, options);\n \n @overload\n * @template Target The target element\n * @param {UseScrollToOptions} [options] The scroll options\n * @returns {UseScrollToReturn & { ref: StateRef<Target> }} The scroll trigger function and ref\n \n @example\n * const { ref, trigger } = useScrollTo(options);\n */\nexport const useScrollTo = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (target ? params[1] : params[0]) as UseScrollToOptions \| undefined;\n const { x, y, behavior = 'auto', enabled = true } = options ?? {};\n const internalRef = useRefState<Element>();\n\n useLayoutEffect(() => {\n if (!enabled) return;\n if (!target && !internalRef.state) return;\n\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n\n element.scrollTo({ top: y, left: x, behavior });\n }, [target, internalRef.state]);\n\n const trigger = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n const { x, y, behavior } = params ?? {};\n\n element.scrollTo({ left: x, top: y, behavior });\n };\n\n if (target) return { trigger };\n return { ref: internalRef, trigger };\n}) as UseScrollTo;\n"],"names":["useScrollTo","params","target","isTarget","options","x","y","behavior","enabled","internalRef","useRefState","useLayoutEffect","element","getElement","trigger"],"mappings":"~~mPA0DaA~~,EAAe,IAAIC,IAAkB,CAChD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EAAWF,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EACxC,CAAE,EAAAI,EAAG,EAAAC,EAAG,SAAAC,EAAW,OAAQ,QAAAC,EAAU,IAASJ,GAAW,CAAA,EACzDK,EAAcC,EAAAA,YAAA,EAEpBC,EAAAA,gBAAgB,IAAM,CAEpB,GADI,CAACH,GACD,CAACN,GAAU,CAACO,EAAY,MAAO,OAEnC,MAAMG,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIO,EAAY,QACtDG,GAELA,EAAQ,SAAS,CAAE,IAAKN,EAAG,KAAMD,EAAG,SAAAE,EAAU,CAAA,EAC7C,CAACL,EAAQO,EAAY,KAAK,CAAC,EAE9B,MAAMK,EAAWb,GAAiE,CAChF,MAAMW,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIO,EAAY,QAC3D,GAAI,CAACG,EAAS,OACd,KAAM,CAAE,EAAAP,EAAG,EAAAC,EAAG,SAAAC,GAAaN,GAAU,CAAA,EAErCW,EAAQ,SAAS,CAAE,KAAMP,EAAG,IAAKC,EAAG,SAAAC,EAAU,CAAA,EAGhD,OAAIL,EAAe,CAAE,QAAAY,CAAA,EACd,CAAE,IAAKL,EAAa,QAAAK,CAAA,CAC7B"}
1	+ {"version":3,"file":"useScrollTo.cjs","sources":["../../../../src/hooks/useScrollTo/useScrollTo.ts"],"sourcesContent":["import { useLayoutEffect } 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 scroll to options type /\nexport interface UseScrollToOptions {\n /* The scrolling behavior /\n behavior?: ScrollBehavior;\n /* Whether to enable the scroll to /\n enabled?: boolean;\n /* The horizontal position to scroll to /\n x: number;\n /* The vertical position to scroll to /\n y: number;\n}\n\n/* The use scroll to return type /\nexport interface UseScrollToReturn {\n /* The state of scrolling /\n trigger: (params?: { x: number; y: number; behavior?: ScrollBehavior }) => void;\n}\n\nexport interface UseScrollTo {\n <Target extends Element>(\n options?: UseScrollToOptions,\n target?: never\n ): UseScrollToReturn & { ref: StateRef<Target> };\n\n (target: HookTarget, options?: UseScrollToOptions): UseScrollToReturn;\n}\n\n/\n @name useScrollTo\n * @description - Hook for scrolling to a specific element\n * @category Sensors\n * @usage low\n \n @overload\n * @param {HookTarget} target The target element for scrolling to\n * @param {UseScrollToOptions} [options] The scroll options\n * @returns {UseScrollToReturn} The scroll trigger function\n \n @example\n * const trigger = useScrollTo(ref, options);\n \n @overload\n * @template Target The target element\n * @param {UseScrollToOptions} [options] The scroll options\n * @returns {UseScrollToReturn & { ref: StateRef<Target> }} The scroll trigger function and ref\n \n @example\n * const { ref, trigger } = useScrollTo(options);\n */\nexport const useScrollTo = ((...params: any[]) => {\n const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget \| undefined;\n const options = (target ? params[1] : params[0]) as UseScrollToOptions \| undefined;\n const { x, y, behavior = 'auto', enabled = true } = options ?? {};\n const internalRef = useRefState<Element>();\n\n useLayoutEffect(() => {\n if (!enabled) return;\n if (!target && !internalRef.state) return;\n\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n\n element.scrollTo({ top: y, left: x, behavior });\n }, [target, internalRef.state]);\n\n const trigger = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n const element = (target ? getElement(target) : internalRef.current) as Element;\n if (!element) return;\n const { x, y, behavior } = params ?? {};\n\n element.scrollTo({ left: x, top: y, behavior });\n };\n\n if (target) return { trigger };\n return { ref: internalRef, trigger };\n}) as UseScrollTo;\n"],"names":["useScrollTo","params","target","isTarget","options","x","y","behavior","enabled","internalRef","useRefState","useLayoutEffect","element","getElement","trigger"],"mappings":"mPA2DaA,EAAe,IAAIC,IAAkB,CAChD,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EAAWF,EAASD,EAAO,CAAC,EAAIA,EAAO,CAAC,EACxC,CAAE,EAAAI,EAAG,EAAAC,EAAG,SAAAC,EAAW,OAAQ,QAAAC,EAAU,IAASJ,GAAW,CAAA,EACzDK,EAAcC,EAAAA,YAAA,EAEpBC,EAAAA,gBAAgB,IAAM,CAEpB,GADI,CAACH,GACD,CAACN,GAAU,CAACO,EAAY,MAAO,OAEnC,MAAMG,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIO,EAAY,QACtDG,GAELA,EAAQ,SAAS,CAAE,IAAKN,EAAG,KAAMD,EAAG,SAAAE,EAAU,CAAA,EAC7C,CAACL,EAAQO,EAAY,KAAK,CAAC,EAE9B,MAAMK,EAAWb,GAAiE,CAChF,MAAMW,EAAWV,EAASW,EAAAA,WAAWX,CAAM,EAAIO,EAAY,QAC3D,GAAI,CAACG,EAAS,OACd,KAAM,CAAE,EAAAP,EAAG,EAAAC,EAAG,SAAAC,GAAaN,GAAU,CAAA,EAErCW,EAAQ,SAAS,CAAE,KAAMP,EAAG,IAAKC,EAAG,SAAAC,EAAU,CAAA,EAGhD,OAAIL,EAAe,CAAE,QAAAY,CAAA,EACd,CAAE,IAAKL,EAAa,QAAAK,CAAA,CAC7B"}

package/dist/cjs/hooks/useSessionStorage/useSessionStorage.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useSessionStorage.cjs","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":"~~gIAmBaA~~,EAAoB,CAC/BC,EACAC,EACAC,IAEAC,EAAAA,WAAWH,EAAK,CACd,GAAGE,EACH,aAAAD,EACA,QAAS,OAAO,OAAW,IAAc,OAAO,eAAiB,MACnE,CAAC"}
1	+ {"version":3,"file":"useSessionStorage.cjs","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 * @usage medium\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":"gIAoBaA,EAAoB,CAC/BC,EACAC,EACAC,IAEAC,EAAAA,WAAWH,EAAK,CACd,GAAGE,EACH,aAAAD,EACA,QAAS,OAAO,OAAW,IAAc,OAAO,eAAiB,MACnE,CAAC"}

package/dist/cjs/hooks/useSet/useSet.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useSet.cjs","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":"~~yGA0CaA~~,EAAiBC,GAA0C,CACtE,KAAM,CAACC,EAAKC,CAAM,EAAIC,EAAAA,SAAS,IAAI,IAAIH,CAAM,CAAC,EAExCI,EAAOC,GAAiBH,EAAQI,GAAY,IAAI,IAAIA,CAAO,EAAE,IAAID,CAAK,CAAC,EACvEE,EAAUF,GACdH,EAAQI,GAAY,CAClB,GAAI,CAACA,EAAQ,IAAID,CAAK,EAAG,OAAOC,EAChC,MAAME,EAAS,IAAI,IAAIF,CAAO,EAC9B,OAAAE,EAAO,OAAOH,CAAK,EACZG,CAAA,CACR,EACGC,EAAQ,IAAMP,EAAO,IAAI,GAAK,EAC9BQ,EAAQ,IAAMR,EAAO,IAAI,IAAIF,CAAM,CAAC,EACpCW,EAAUN,GACdH,EAAQI,GAAY,CAClB,GAAI,CAACA,EAAQ,IAAID,CAAK,EAAG,OAAO,IAAI,IAAIC,CAAO,EAAE,IAAID,CAAK,EAC1D,MAAMG,EAAS,IAAI,IAAIF,CAAO,EAC9B,OAAAE,EAAO,OAAOH,CAAK,EACZG,CAAA,CACR,EACGI,EAASC,GAAsBX,EAAOD,EAAI,MAAMY,CAAK,CAAC,EACtDC,EAAcD,GAAsBX,EAAOD,EAAI,WAAWY,CAAK,CAAC,EAChEE,EAAuBF,GAAsBX,EAAOD,EAAI,oBAAoBY,CAAK,CAAC,EAClFG,EAAgBH,GAAsBX,EAAOD,EAAI,aAAaY,CAAK,CAAC,EACpEI,EAAOZ,GAAiBJ,EAAI,IAAII,CAAK,EAE3C,MAAO,CACL,MAAOJ,EACP,KAAMA,EAAI,KACV,IAAAgB,EACA,IAAAb,EACA,OAAAG,EACA,MAAAE,EACA,MAAAC,EACA,OAAAC,EACA,MAAAC,EACA,WAAAE,EACA,oBAAAC,EACA,aAAAC,CAAA,CAEJ"}
1	+ {"version":3,"file":"useSet.cjs","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 * @usage medium\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":"yGA2CaA,EAAiBC,GAA0C,CACtE,KAAM,CAACC,EAAKC,CAAM,EAAIC,EAAAA,SAAS,IAAI,IAAIH,CAAM,CAAC,EAExCI,EAAOC,GAAiBH,EAAQI,GAAY,IAAI,IAAIA,CAAO,EAAE,IAAID,CAAK,CAAC,EACvEE,EAAUF,GACdH,EAAQI,GAAY,CAClB,GAAI,CAACA,EAAQ,IAAID,CAAK,EAAG,OAAOC,EAChC,MAAME,EAAS,IAAI,IAAIF,CAAO,EAC9B,OAAAE,EAAO,OAAOH,CAAK,EACZG,CAAA,CACR,EACGC,EAAQ,IAAMP,EAAO,IAAI,GAAK,EAC9BQ,EAAQ,IAAMR,EAAO,IAAI,IAAIF,CAAM,CAAC,EACpCW,EAAUN,GACdH,EAAQI,GAAY,CAClB,GAAI,CAACA,EAAQ,IAAID,CAAK,EAAG,OAAO,IAAI,IAAIC,CAAO,EAAE,IAAID,CAAK,EAC1D,MAAMG,EAAS,IAAI,IAAIF,CAAO,EAC9B,OAAAE,EAAO,OAAOH,CAAK,EACZG,CAAA,CACR,EACGI,EAASC,GAAsBX,EAAOD,EAAI,MAAMY,CAAK,CAAC,EACtDC,EAAcD,GAAsBX,EAAOD,EAAI,WAAWY,CAAK,CAAC,EAChEE,EAAuBF,GAAsBX,EAAOD,EAAI,oBAAoBY,CAAK,CAAC,EAClFG,EAAgBH,GAAsBX,EAAOD,EAAI,aAAaY,CAAK,CAAC,EACpEI,EAAOZ,GAAiBJ,EAAI,IAAII,CAAK,EAE3C,MAAO,CACL,MAAOJ,EACP,KAAMA,EAAI,KACV,IAAAgB,EACA,IAAAb,EACA,OAAAG,EACA,MAAAE,EACA,MAAAC,EACA,OAAAC,EACA,MAAAC,EACA,WAAAE,EACA,oBAAAC,EACA,aAAAC,CAAA,CAEJ"}

package/dist/cjs/hooks/useShallowEffect/useShallowEffect.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useShallowEffect.cjs","sources":["../../../../src/hooks/useShallowEffect/useShallowEffect.ts"],"sourcesContent":["import type { DependencyList, EffectCallback } from 'react';\n\nimport { useEffect, useRef } from 'react';\n\nexport const deepEqual = (a: any, b: any): boolean => {\n if (a === b) return true;\n if (a == null \|\| b == null) return a === b;\n if (typeof a !== typeof b) return false;\n if (typeof a !== 'object') return a === b;\n if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n if (Array.isArray(a))\n return a.length === b.length && a.every((value, index) => deepEqual(value, b[index]));\n\n const keysA = Object.keys(a);\n const keysB = Object.keys(b);\n\n if (keysA.length !== keysB.length) return false;\n\n for (const key of keysA) {\n if (!keysB.includes(key)) return false;\n if (!deepEqual(a[key], b[key])) return false;\n }\n\n return true;\n};\n\n/*\n @name useShallowEffect\n * @description - Hook that executes an effect only when dependencies change shallowly or deeply\n * @category Lifecycle\n \n @param {EffectCallback} effect The effect callback\n * @param {DependencyList} [deps] The dependencies list for the effect\n \n @example\n * useShallowEffect(() => console.log(\"effect\"), [user]);\n */\nexport const useShallowEffect = (effect: EffectCallback, deps?: DependencyList) => {\n const depsRef = useRef<DependencyList>(deps);\n\n if (!depsRef.current \|\| !deepEqual(deps, depsRef.current)) {\n depsRef.current = deps;\n }\n\n useEffect(effect, depsRef.current);\n};\n"],"names":["deepEqual","a","b","value","index","keysA","keysB","key","useShallowEffect","effect","deps","depsRef","useRef","useEffect"],"mappings":"yGAIaA,EAAY,CAACC,EAAQC,IAAoB,CACpD,GAAID,IAAMC,EAAG,MAAO,GACpB,GAAID,GAAK,MAAQC,GAAK,YAAaD,IAAMC,EACzC,GAAI,OAAOD,GAAM,OAAOC,EAAG,MAAO,GAClC,GAAI,OAAOD,GAAM,SAAU,OAAOA,IAAMC,EACxC,GAAI,MAAM,QAAQD,CAAC,IAAM,MAAM,QAAQC,CAAC,EAAG,MAAO,GAElD,GAAI,MAAM,QAAQD,CAAC,EACjB,OAAOA,EAAE,SAAWC,EAAE,QAAUD,EAAE,MAAM,CAACE,EAAOC,IAAUJ,EAAUG,EAAOD,EAAEE,CAAK,CAAC,CAAC,EAEtF,MAAMC,EAAQ,OAAO,KAAKJ,CAAC,EACrBK,EAAQ,OAAO,KAAKJ,CAAC,EAE3B,GAAIG,EAAM,SAAWC,EAAM,OAAQ,MAAO,GAE1C,UAAWC,KAAOF,EAEhB,GADI,CAACC,EAAM,SAASC,CAAG,GACnB,CAACP,EAAUC,EAAEM,CAAG,EAAGL,EAAEK,CAAG,CAAC,EAAG,MAAO,GAGzC,MAAO,EACT,~~EAaaC~~,EAAmB,CAACC,EAAwBC,IAA0B,CACjF,MAAMC,EAAUC,EAAAA,OAAuBF,CAAI,GAEvC,CAACC,EAAQ,SAAW,CAACX,EAAUU,EAAMC,EAAQ,OAAO,KACtDA,EAAQ,QAAUD,GAGpBG,YAAUJ,EAAQE,EAAQ,OAAO,CACnC"}
1	+ {"version":3,"file":"useShallowEffect.cjs","sources":["../../../../src/hooks/useShallowEffect/useShallowEffect.ts"],"sourcesContent":["import type { DependencyList, EffectCallback } from 'react';\n\nimport { useEffect, useRef } from 'react';\n\nexport const deepEqual = (a: any, b: any): boolean => {\n if (a === b) return true;\n if (a == null \|\| b == null) return a === b;\n if (typeof a !== typeof b) return false;\n if (typeof a !== 'object') return a === b;\n if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n if (Array.isArray(a))\n return a.length === b.length && a.every((value, index) => deepEqual(value, b[index]));\n\n const keysA = Object.keys(a);\n const keysB = Object.keys(b);\n\n if (keysA.length !== keysB.length) return false;\n\n for (const key of keysA) {\n if (!keysB.includes(key)) return false;\n if (!deepEqual(a[key], b[key])) return false;\n }\n\n return true;\n};\n\n/*\n @name useShallowEffect\n * @description - Hook that executes an effect only when dependencies change shallowly or deeply\n * @category Lifecycle\n * @usage low\n \n @param {EffectCallback} effect The effect callback\n * @param {DependencyList} [deps] The dependencies list for the effect\n \n @example\n * useShallowEffect(() => console.log(\"effect\"), [user]);\n */\nexport const useShallowEffect = (effect: EffectCallback, deps?: DependencyList) => {\n const depsRef = useRef<DependencyList>(deps);\n\n if (!depsRef.current \|\| !deepEqual(deps, depsRef.current)) {\n depsRef.current = deps;\n }\n\n useEffect(effect, depsRef.current);\n};\n"],"names":["deepEqual","a","b","value","index","keysA","keysB","key","useShallowEffect","effect","deps","depsRef","useRef","useEffect"],"mappings":"yGAIaA,EAAY,CAACC,EAAQC,IAAoB,CACpD,GAAID,IAAMC,EAAG,MAAO,GACpB,GAAID,GAAK,MAAQC,GAAK,YAAaD,IAAMC,EACzC,GAAI,OAAOD,GAAM,OAAOC,EAAG,MAAO,GAClC,GAAI,OAAOD,GAAM,SAAU,OAAOA,IAAMC,EACxC,GAAI,MAAM,QAAQD,CAAC,IAAM,MAAM,QAAQC,CAAC,EAAG,MAAO,GAElD,GAAI,MAAM,QAAQD,CAAC,EACjB,OAAOA,EAAE,SAAWC,EAAE,QAAUD,EAAE,MAAM,CAACE,EAAOC,IAAUJ,EAAUG,EAAOD,EAAEE,CAAK,CAAC,CAAC,EAEtF,MAAMC,EAAQ,OAAO,KAAKJ,CAAC,EACrBK,EAAQ,OAAO,KAAKJ,CAAC,EAE3B,GAAIG,EAAM,SAAWC,EAAM,OAAQ,MAAO,GAE1C,UAAWC,KAAOF,EAEhB,GADI,CAACC,EAAM,SAASC,CAAG,GACnB,CAACP,EAAUC,EAAEM,CAAG,EAAGL,EAAEK,CAAG,CAAC,EAAG,MAAO,GAGzC,MAAO,EACT,EAcaC,EAAmB,CAACC,EAAwBC,IAA0B,CACjF,MAAMC,EAAUC,EAAAA,OAAuBF,CAAI,GAEvC,CAACC,EAAQ,SAAW,CAACX,EAAUU,EAAMC,EAAQ,OAAO,KACtDA,EAAQ,QAAUD,GAGpBG,YAAUJ,EAAQE,EAAQ,OAAO,CACnC"}

package/dist/cjs/hooks/useShare/useShare.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=t=>{const r=typeof navigator<"u"&&"share"in navigator;return{trigger:async a=>{if(!r)return;const e={...t,...a};return e.files&&navigator.canShare({files:e.files})&&navigator.share(e),navigator.share(e)},supported:r}};exports.useShare=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=a=>{const r=typeof navigator<"u"&&"share"in navigator&&!!navigator.share;return{trigger:async t=>{if(!r)return;const e={...a,...t};return e.files&&navigator.canShare({files:e.files})&&navigator.share(e),navigator.share(e)},supported:r}};exports.useShare=n;
 //# sourceMappingURL=useShare.cjs.map

package/dist/cjs/hooks/useShare/useShare.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useShare.cjs","sources":["../../../../src/hooks/useShare/useShare.ts"],"sourcesContent":["/** The use share options type /\nexport interface UseShareParams {\n /* Array of files to be shared /\n files?: File[];\n /* Text content to be shared /\n text?: string;\n /* Title of the content being shared /\n title?: string;\n /* URL link to be shared /\n url?: string;\n}\n\n/* The use share return type /\nexport interface UseShareReturn {\n /* Whether the Web Share API is supported in the current environment /\n supported: boolean;\n /* Function to trigger the native share dialog /\n trigger: (shareParams: ShareData) => Promise<void>;\n}\n\n/\n @name useShare\n * @description - Hook that utilizes the share api\n * @category Browser\n \n @browserapi share https://developer.mozilla.org/en-US/docs/Web/API/Navigator/share\n \n @param {UseShareParams} [params] The use share options\n * @returns {UseShareReturn}\n \n @example\n * const { share, supported } = useShare();\n */\nexport const useShare = (params?: UseShareParams) => {\n const supported = typeof navigator !== 'undefined' && 'share' in navigator;\n\n const trigger = async (shareParams: ShareData) => {\n if (!supported) return;\n\n const data = {\n ...params,\n ...shareParams\n };\n\n if (data.files && navigator.canShare({ files: data.files })) navigator.share(data);\n\n return navigator.share(data);\n };\n\n return { trigger, supported };\n};\n"],"names":["useShare","params","supported","shareParams","data"],"mappings":"~~gFAiCO~~,MAAMA,EAAYC,GAA4B,CACnD,MAAMC,EAAY,OAAO,UAAc,KAAe,UAAW,~~UAejE~~,MAAO,CAAE,QAbO,MAAOC,GAA2B,CAChD,GAAI,CAACD,EAAW,OAEhB,MAAME,EAAO,CACX,GAAGH,EACH,GAAGE,CAAA,EAGL,OAAIC,EAAK,OAAS,UAAU,SAAS,CAAE,MAAOA,EAAK,KAAA,CAAO,GAAG,UAAU,MAAMA,CAAI,EAE1E,UAAU,MAAMA,CAAI,CAAA,EAGX,UAAAF,CAAA,CACpB"}
1	+ {"version":3,"file":"useShare.cjs","sources":["../../../../src/hooks/useShare/useShare.ts"],"sourcesContent":["/** The use share options type /\nexport interface UseShareParams {\n /* Array of files to be shared /\n files?: File[];\n /* Text content to be shared /\n text?: string;\n /* Title of the content being shared /\n title?: string;\n /* URL link to be shared /\n url?: string;\n}\n\n/* The use share return type /\nexport interface UseShareReturn {\n /* Whether the Web Share API is supported in the current environment /\n supported: boolean;\n /* Function to trigger the native share dialog /\n trigger: (shareParams: ShareData) => Promise<void>;\n}\n\n/\n @name useShare\n * @description - Hook that utilizes the share api\n * @category Browser\n * @usage medium\n \n @browserapi share https://developer.mozilla.org/en-US/docs/Web/API/Navigator/share\n \n @param {UseShareParams} [params] The use share options\n * @returns {UseShareReturn}\n \n @example\n * const { share, supported } = useShare();\n */\nexport const useShare = (params?: UseShareParams) => {\n const supported = typeof navigator !== 'undefined' && 'share' in navigator && !!navigator.share;\n\n const trigger = async (shareParams: ShareData) => {\n if (!supported) return;\n\n const data = {\n ...params,\n ...shareParams\n };\n\n if (data.files && navigator.canShare({ files: data.files })) navigator.share(data);\n\n return navigator.share(data);\n };\n\n return { trigger, supported };\n};\n"],"names":["useShare","params","supported","shareParams","data"],"mappings":"gFAkCO,MAAMA,EAAYC,GAA4B,CACnD,MAAMC,EAAY,OAAO,UAAc,KAAe,UAAW,WAAa,CAAC,CAAC,UAAU,MAe1F,MAAO,CAAE,QAbO,MAAOC,GAA2B,CAChD,GAAI,CAACD,EAAW,OAEhB,MAAME,EAAO,CACX,GAAGH,EACH,GAAGE,CAAA,EAGL,OAAIC,EAAK,OAAS,UAAU,SAAS,CAAE,MAAOA,EAAK,KAAA,CAAO,GAAG,UAAU,MAAMA,CAAI,EAE1E,UAAU,MAAMA,CAAI,CAAA,EAGX,UAAAF,CAAA,CACpB"}

package/dist/cjs/hooks/useSpeechRecognition/useSpeechRecognition.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useSpeechRecognition.cjs","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":"yGA8CaA,EAAuB,IAClC,QAAQ,mBAAqB,QAAQ,~~wBAuB1BC~~,EAAuB,CAClCC,EAAuC,KACR,CAC/B,MAAMC,EAAY,OAAO,OAAW,KAAe,CAAC,CAACH,EAAA,EAE/C,CACJ,WAAAI,EAAa,GACb,eAAAC,EAAiB,GACjB,SAAAC,EAAW,QACX,SAAAC,EACA,gBAAAC,EAAkB,EAClB,QAAAC,EACA,MAAAC,EACA,QAAAC,EACA,SAAAC,CAAA,EACEV,EAEE,CAACW,EAAWC,CAAY,EAAIC,EAAAA,SAAS,EAAK,EAC1C,CAACC,EAAYC,CAAa,EAAIF,EAAAA,SAAS,EAAE,EACzC,CAACG,EAAOC,CAAQ,EAAIJ,EAAAA,SAAS,EAAK,EAClC,CAACK,EAAOC,CAAQ,EAAIN,EAAAA,SAA6C,IAAI,EACrE,CAACO,CAAW,EAAIP,EAAAA,SAA4B,IAAM,CACtD,GAAI,CAACZ,EAAW,MAAO,CAAA,EAEvB,MAAMoB,EAAoBvB,EAAA,EACpBwB,EAAoB,IAAID,EAE9B,OAAAC,EAAkB,WAAapB,EAC3BG,MAA4B,SAAWA,GAC3CiB,EAAkB,eAAiBnB,EACnCmB,EAAkB,KAAOlB,EACzBkB,EAAkB,gBAAkBhB,EAEpCgB,EAAkB,QAAU,IAAM,CAChCV,EAAa,EAAI,EACjBK,EAAS,EAAK,EACdV,IAAA,CAAU,EAEZe,EAAkB,MAAQ,IAAM,CAC9BV,EAAa,EAAK,EAClBJ,IAAA,CAAQ,EAEVc,EAAkB,QAAWC,GAAU,CACrCJ,EAASI,CAAK,EACdX,EAAa,EAAK,EAClBH,IAAUc,CAAK,CAAA,EAEjBD,EAAkB,SAAYC,GAAU,CACtC,QAAQ,IAAI,WAAYA,CAAK,EAC7B,MAAMC,EAAgBD,EAAM,QAAQA,EAAM,WAAW,EAC/C,CAAE,WAAAT,GAAeU,EAAc,CAAC,EAEtCT,EAAcD,CAAU,EACxBK,EAAS,IAAI,EACbT,IAAWa,CAAK,CAAA,EAElBD,EAAkB,MAAQ,IAAM,CAC9BV,EAAa,EAAK,EAClBU,EAAkB,KAAOlB,CAAA,EAGpBkB,CAAA,CACR,EAEDG,EAAAA,UAAU,IAAM,IAAML,EAAY,KAAA,EAAQ,CAAA,CAAE,EAE5C,MAAMM,EAAQ,IAAMN,EAAY,MAAA,EAC1BO,EAAO,IAAMP,EAAY,KAAA,EAO/B,MAAO,CACL,UAAAnB,EACA,WAAAa,EACA,YAAAM,EACA,MAAAJ,EACA,UAAAL,EACA,MAAAO,EACA,MAAAQ,EACA,KAAAC,EACA,OAda,CAACC,EAAQ,CAACjB,IAAc,CACrC,GAAIiB,SAAcF,EAAA,EAClBC,EAAA,CAAK,CAYL,CAEJ"}
1	+ {"version":3,"file":"useSpeechRecognition.cjs","sources":["../../../../src/hooks/useSpeechRecognition/useSpeechRecognition.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The use speech recognition hook options type /\ninterface UseSpeechRecognitionOptions {\n /* If true, recognition continues even after pauses in speech. Default is false /\n continuous?: SpeechRecognition['continuous'];\n /* A list of grammar rules /\n grammars?: SpeechRecognition['grammars'];\n /* If true, interim (non-final) results are provided as the user speaks /\n interimResults?: SpeechRecognition['interimResults'];\n /* The language in which recognition should occur. Must be a valid BCP 47 language tag (e.g., \"en-US\", \"ru-RU\") /\n language?: SpeechRecognition['lang'];\n /* The maximum number of alternative transcripts returned for a given recognition result. Must be a positive integer /\n maxAlternatives?: SpeechRecognition['maxAlternatives'];\n /* Callback invoked when speech recognition ends /\n onEnd?: () => void;\n /* Callback invoked when an error occurs during recognition /\n onError?: (error: SpeechRecognitionErrorEvent) => void;\n /* Callback invoked when recognition produces a result /\n onResult?: (event: SpeechRecognitionEvent) => void;\n /* Callback invoked when speech recognition starts /\n onStart?: () => void;\n}\n\n/* The return type of the useSpeechRecognition hook. /\ninterface UseSpeechRecognitionReturn {\n /* The error state /\n error: SpeechRecognitionErrorEvent \| null;\n /* The final transcript /\n final: boolean;\n /* Whether the hook is currently listening for speech /\n listening: boolean;\n /* The speech recognition instance /\n recognition: SpeechRecognition;\n /* Whether the current browser supports the Web Speech API /\n supported: boolean;\n /* The current transcript /\n transcript: string;\n /* Begins speech recognition /\n start: () => void;\n /* Ends speech recognition, finalizing results /\n stop: () => void;\n /* Toggles the listening state /\n toggle: (value?: boolean) => void;\n}\n\nexport const getSpeechRecognition = () =>\n window?.SpeechRecognition ?? window?.webkitSpeechRecognition;\n\n/\n @name useSpeechRecognition\n * @description - Hook that provides a streamlined interface for incorporating speech-to-text functionality\n * @category Browser\n * @usage low\n \n @browserapi window.SpeechRecognition https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition\n \n @param {boolean} [options.continuous=false] Whether recognition should continue after pauses\n * @param {boolean} [options.interimResults=false] Whether interim results should be provided\n * @param {string} [options.language=\"en-US\"] The language for recognition, as a valid BCP 47 tag\n * @param {number} [options.maxAlternatives=1] The maximum number of alternative transcripts to return\n * @param {SpeechGrammarList} [options.grammars] A list of grammar rules\n * @param {() => void} [options.onStart] Callback invoked when speech recognition starts\n * @param {() => void} [options.onEnd] Callback invoked when speech recognition ends\n * @param {(error: SpeechRecognitionErrorEvent) => void} [options.onError] Callback invoked when an error occurs during recognition\n * @param {(event: SpeechRecognitionEvent) => void} [options.onResult] Callback invoked when recognition produces a result\n * @returns {UseSpeechRecognitionReturn} An object containing the speech recognition functionality\n \n @example\n * const { supported, value, recognition, listening, error, start, stop, toggle } = useSpeechRecognition();\n */\nexport const useSpeechRecognition = (\n options: UseSpeechRecognitionOptions = {}\n): UseSpeechRecognitionReturn => {\n const supported = typeof window !== 'undefined' && !!getSpeechRecognition();\n\n const {\n continuous = false,\n interimResults = false,\n language = 'en-US',\n grammars,\n maxAlternatives = 1,\n onStart,\n onEnd,\n onError,\n onResult\n } = options;\n\n const [listening, setListening] = useState(false);\n const [transcript, setTranscript] = useState('');\n const [final, setFinal] = useState(false);\n const [error, setError] = useState<SpeechRecognitionErrorEvent \| null>(null);\n const [recognition] = useState<SpeechRecognition>(() => {\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":"yGA8CaA,EAAuB,IAClC,QAAQ,mBAAqB,QAAQ,wBAwB1BC,EAAuB,CAClCC,EAAuC,KACR,CAC/B,MAAMC,EAAY,OAAO,OAAW,KAAe,CAAC,CAACH,EAAA,EAE/C,CACJ,WAAAI,EAAa,GACb,eAAAC,EAAiB,GACjB,SAAAC,EAAW,QACX,SAAAC,EACA,gBAAAC,EAAkB,EAClB,QAAAC,EACA,MAAAC,EACA,QAAAC,EACA,SAAAC,CAAA,EACEV,EAEE,CAACW,EAAWC,CAAY,EAAIC,EAAAA,SAAS,EAAK,EAC1C,CAACC,EAAYC,CAAa,EAAIF,EAAAA,SAAS,EAAE,EACzC,CAACG,EAAOC,CAAQ,EAAIJ,EAAAA,SAAS,EAAK,EAClC,CAACK,EAAOC,CAAQ,EAAIN,EAAAA,SAA6C,IAAI,EACrE,CAACO,CAAW,EAAIP,EAAAA,SAA4B,IAAM,CACtD,GAAI,CAACZ,EAAW,MAAO,CAAA,EAEvB,MAAMoB,EAAoBvB,EAAA,EACpBwB,EAAoB,IAAID,EAE9B,OAAAC,EAAkB,WAAapB,EAC3BG,MAA4B,SAAWA,GAC3CiB,EAAkB,eAAiBnB,EACnCmB,EAAkB,KAAOlB,EACzBkB,EAAkB,gBAAkBhB,EAEpCgB,EAAkB,QAAU,IAAM,CAChCV,EAAa,EAAI,EACjBK,EAAS,EAAK,EACdV,IAAA,CAAU,EAEZe,EAAkB,MAAQ,IAAM,CAC9BV,EAAa,EAAK,EAClBJ,IAAA,CAAQ,EAEVc,EAAkB,QAAWC,GAAU,CACrCJ,EAASI,CAAK,EACdX,EAAa,EAAK,EAClBH,IAAUc,CAAK,CAAA,EAEjBD,EAAkB,SAAYC,GAAU,CACtC,QAAQ,IAAI,WAAYA,CAAK,EAC7B,MAAMC,EAAgBD,EAAM,QAAQA,EAAM,WAAW,EAC/C,CAAE,WAAAT,GAAeU,EAAc,CAAC,EAEtCT,EAAcD,CAAU,EACxBK,EAAS,IAAI,EACbT,IAAWa,CAAK,CAAA,EAElBD,EAAkB,MAAQ,IAAM,CAC9BV,EAAa,EAAK,EAClBU,EAAkB,KAAOlB,CAAA,EAGpBkB,CAAA,CACR,EAEDG,EAAAA,UAAU,IAAM,IAAML,EAAY,KAAA,EAAQ,CAAA,CAAE,EAE5C,MAAMM,EAAQ,IAAMN,EAAY,MAAA,EAC1BO,EAAO,IAAMP,EAAY,KAAA,EAO/B,MAAO,CACL,UAAAnB,EACA,WAAAa,EACA,YAAAM,EACA,MAAAJ,EACA,UAAAL,EACA,MAAAO,EACA,MAAAQ,EACA,KAAAC,EACA,OAda,CAACC,EAAQ,CAACjB,IAAc,CACrC,GAAIiB,SAAcF,EAAA,EAClBC,EAAA,CAAK,CAYL,CAEJ"}

package/dist/cjs/hooks/useSpeechSynthesis/useSpeechSynthesis.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),P=(S={})=>{const t=typeof window<"u"&&"speechSynthesis"in window,{text:u="",lang:c="en-US",pitch:i=1,rate:a=1,voice:l=null,volume:p=1}=S,[w,n]=r.useState(!1),[d,o]=r.useState("init"),[h,y]=r.useState(),s=r.useRef(null),f=e=>{e.lang=c,e.pitch=i,e.rate=a,e.volume=p,e.voice=l,e.onstart=()=>{n(!0),o("play")},e.onpause=()=>{n(!1),o("pause")},e.onresume=()=>{n(!0),o("play")},e.onend=()=>{n(!1),o("end")},e.onerror=E=>{n(!1),y(E)}};r.useEffect(()=>{if(!t)return;const e=new SpeechSynthesisUtterance(u);return f(e),s.current=e,()=>{window.speechSynthesis?.cancel()}},[u,c,i,a,l,p]);const g=e=>{t&&(e&&(s.current=new SpeechSynthesisUtterance(e),f(s.current)),window.speechSynthesis?.cancel(),s.current&&window.speechSynthesis?.speak(s.current))},m=()=>{t&&(window.speechSynthesis?.cancel(),n(!1))},v=(e=!w)=>{t&&(e?window.speechSynthesis?.resume():window.speechSynthesis?.pause(),n(e))},b=()=>{n(!0),window.speechSynthesis?.resume()},k=()=>{n(!1),window.speechSynthesis?.pause()};return{supported:t,playing:w,status:d,utterance:s.current,error:h,stop:m,toggle:v,speak:g,resume:b,pause:k}};exports.useSpeechSynthesis=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),P=(S={})=>{const t=typeof window<"u"&&"speechSynthesis"in window&&!!window.speechSynthesis,{text:u="",lang:i="en-US",pitch:c=1,rate:a=1,voice:l=null,volume:p=1}=S,[w,s]=r.useState(!1),[d,o]=r.useState("init"),[h,y]=r.useState(),n=r.useRef(null),f=e=>{e.lang=i,e.pitch=c,e.rate=a,e.volume=p,e.voice=l,e.onstart=()=>{s(!0),o("play")},e.onpause=()=>{s(!1),o("pause")},e.onresume=()=>{s(!0),o("play")},e.onend=()=>{s(!1),o("end")},e.onerror=E=>{s(!1),y(E)}};r.useEffect(()=>{if(!t)return;const e=new SpeechSynthesisUtterance(u);return f(e),n.current=e,()=>{window.speechSynthesis?.cancel()}},[u,i,c,a,l,p]);const g=e=>{t&&(e&&(n.current=new SpeechSynthesisUtterance(e),f(n.current)),window.speechSynthesis?.cancel(),n.current&&window.speechSynthesis?.speak(n.current))},m=()=>{t&&(window.speechSynthesis?.cancel(),s(!1))},v=(e=!w)=>{t&&(e?window.speechSynthesis?.resume():window.speechSynthesis?.pause(),s(e))},b=()=>{s(!0),window.speechSynthesis?.resume()},k=()=>{s(!1),window.speechSynthesis?.pause()};return{supported:t,playing:w,status:d,utterance:n.current,error:h,stop:m,toggle:v,speak:g,resume:b,pause:k}};exports.useSpeechSynthesis=P;
 //# sourceMappingURL=useSpeechSynthesis.cjs.map