OwlCyberSecurity - MANAGER
Edit File: index.mjs.map
{"version":3,"file":"index.mjs","sources":["../src/useDebouncedCallback.ts","../src/useDebounce.ts","../src/useThrottledCallback.ts"],"sourcesContent":["import { useRef, useEffect, useMemo } from 'react';\n\nexport interface CallOptions {\n /**\n * Controls if the function should be invoked on the leading edge of the timeout.\n */\n leading?: boolean;\n /**\n * Controls if the function should be invoked on the trailing edge of the timeout.\n */\n trailing?: boolean;\n}\n\nexport interface Options extends CallOptions {\n /**\n * The maximum time the given function is allowed to be delayed before it's invoked.\n */\n maxWait?: number;\n /**\n * If the setting is set to true, all debouncing and timers will happen on the server side as well\n */\n debounceOnServer?: boolean;\n}\n\nexport interface ControlFunctions {\n /**\n * Cancel pending function invocations\n */\n cancel: () => void;\n /**\n * Immediately invoke pending function invocations\n */\n flush: () => void;\n /**\n * Returns `true` if there are any pending function invocations\n */\n isPending: () => boolean;\n}\n\n/**\n * Subsequent calls to the debounced function `debounced.callback` return the result of the last func invocation.\n * Note, that if there are no previous invocations it's mean you will get undefined. You should check it in your code properly.\n */\nexport interface DebouncedState<T extends (...args: any) => ReturnType<T>>\n extends ControlFunctions {\n (...args: Parameters<T>): ReturnType<T> | undefined;\n}\n\n/**\n * Creates a debounced function that delays invoking `func` until after `wait`\n * milliseconds have elapsed since the last time the debounced function was\n * invoked, or until the next browser frame is drawn.\n *\n * The debounced function comes with a `cancel` method to cancel delayed `func`\n * invocations and a `flush` method to immediately invoke them.\n *\n * Provide `options` to indicate whether `func` should be invoked on the leading\n * and/or trailing edge of the `wait` timeout. The `func` is invoked with the\n * last arguments provided to the debounced function.\n *\n * Subsequent calls to the debounced function return the result of the last\n * `func` invocation.\n *\n * **Note:** If `leading` and `trailing` options are `true`, `func` is\n * invoked on the trailing edge of the timeout only if the debounced function\n * is invoked more than once during the `wait` timeout.\n *\n * If `wait` is `0` and `leading` is `false`, `func` invocation is deferred\n * until the next tick, similar to `setTimeout` with a timeout of `0`.\n *\n * If `wait` is omitted in an environment with `requestAnimationFrame`, `func`\n * invocation will be deferred until the next frame is drawn (typically about\n * 16ms).\n *\n * See [David Corbacho's article](https://css-tricks.com/debouncing-throttling-explained-examples/)\n * for details over the differences between `debounce` and `throttle`.\n *\n * @category Function\n * @param {Function} func The function to debounce.\n * @param {number} [wait=0]\n * The number of milliseconds to delay; if omitted, `requestAnimationFrame` is\n * used (if available, otherwise it will be setTimeout(...,0)).\n * @param {Object} [options={}] The options object.\n * Controls if `func` should be invoked on the leading edge of the timeout.\n * @param {boolean} [options.leading=false]\n * The maximum time `func` is allowed to be delayed before it's invoked.\n * @param {number} [options.maxWait]\n * Controls if `func` should be invoked the trailing edge of the timeout.\n * @param {boolean} [options.trailing=true]\n * @returns {Function} Returns the new debounced function.\n * @example\n *\n * // Avoid costly calculations while the window size is in flux.\n * const resizeHandler = useDebouncedCallback(calculateLayout, 150);\n * window.addEventListener('resize', resizeHandler)\n *\n * // Invoke `sendMail` when clicked, debouncing subsequent calls.\n * const clickHandler = useDebouncedCallback(sendMail, 300, {\n * leading: true,\n * trailing: false,\n * })\n * <button onClick={clickHandler}>click me</button>\n *\n * // Ensure `batchLog` is invoked once after 1 second of debounced calls.\n * const debounced = useDebouncedCallback(batchLog, 250, { 'maxWait': 1000 })\n * const source = new EventSource('/stream')\n * source.addEventListener('message', debounced)\n *\n * // Cancel the trailing debounced invocation.\n * window.addEventListener('popstate', debounced.cancel)\n *\n * // Check for pending invocations.\n * const status = debounced.pending() ? \"Pending...\" : \"Ready\"\n */\nexport default function useDebouncedCallback<\n T extends (...args: any) => ReturnType<T>,\n>(func: T, wait?: number, options?: Options): DebouncedState<T> {\n const lastCallTime = useRef(null);\n const lastInvokeTime = useRef(0);\n const timerId = useRef(null);\n const lastArgs = useRef<unknown[]>([]);\n const lastThis = useRef<unknown>();\n const result = useRef<ReturnType<T>>();\n const funcRef = useRef(func);\n const mounted = useRef(true);\n // Always keep the latest version of debounce callback, with no wait time.\n funcRef.current = func;\n\n const isClientSize = typeof window !== 'undefined';\n // Bypass `requestAnimationFrame` by explicitly setting `wait=0`.\n const useRAF = !wait && wait !== 0 && isClientSize;\n\n if (typeof func !== 'function') {\n throw new TypeError('Expected a function');\n }\n\n wait = +wait || 0;\n options = options || {};\n\n const leading = !!options.leading;\n const trailing = 'trailing' in options ? !!options.trailing : true; // `true` by default\n const maxing = 'maxWait' in options;\n const debounceOnServer =\n 'debounceOnServer' in options ? !!options.debounceOnServer : false; // `false` by default\n const maxWait = maxing ? Math.max(+options.maxWait || 0, wait) : null;\n\n useEffect(() => {\n mounted.current = true;\n return () => {\n mounted.current = false;\n };\n }, []);\n\n // You may have a question, why we have so many code under the useMemo definition.\n //\n // This was made as we want to escape from useCallback hell and\n // not to initialize a number of functions each time useDebouncedCallback is called.\n //\n // It means that we have less garbage for our GC calls which improves performance.\n // Also, it makes this library smaller.\n //\n // And the last reason, that the code without lots of useCallback with deps is easier to read.\n // You have only one place for that.\n const debounced = useMemo(() => {\n const invokeFunc = (time: number) => {\n const args = lastArgs.current;\n const thisArg = lastThis.current;\n\n lastArgs.current = lastThis.current = null;\n lastInvokeTime.current = time;\n return (result.current = funcRef.current.apply(thisArg, args));\n };\n\n const startTimer = (pendingFunc: () => void, wait: number) => {\n if (useRAF) cancelAnimationFrame(timerId.current);\n timerId.current = useRAF\n ? requestAnimationFrame(pendingFunc)\n : setTimeout(pendingFunc, wait);\n };\n\n const shouldInvoke = (time: number) => {\n if (!mounted.current) return false;\n\n const timeSinceLastCall = time - lastCallTime.current;\n const timeSinceLastInvoke = time - lastInvokeTime.current;\n\n // Either this is the first call, activity has stopped and we're at the\n // trailing edge, the system time has gone backwards and we're treating\n // it as the trailing edge, or we've hit the `maxWait` limit.\n return (\n !lastCallTime.current ||\n timeSinceLastCall >= wait ||\n timeSinceLastCall < 0 ||\n (maxing && timeSinceLastInvoke >= maxWait)\n );\n };\n\n const trailingEdge = (time: number) => {\n timerId.current = null;\n\n // Only invoke if we have `lastArgs` which means `func` has been\n // debounced at least once.\n if (trailing && lastArgs.current) {\n return invokeFunc(time);\n }\n lastArgs.current = lastThis.current = null;\n return result.current;\n };\n\n const timerExpired = () => {\n const time = Date.now();\n if (shouldInvoke(time)) {\n return trailingEdge(time);\n }\n // https://github.com/xnimorz/use-debounce/issues/97\n if (!mounted.current) {\n return;\n }\n // Remaining wait calculation\n const timeSinceLastCall = time - lastCallTime.current;\n const timeSinceLastInvoke = time - lastInvokeTime.current;\n const timeWaiting = wait - timeSinceLastCall;\n const remainingWait = maxing\n ? Math.min(timeWaiting, maxWait - timeSinceLastInvoke)\n : timeWaiting;\n\n // Restart the timer\n startTimer(timerExpired, remainingWait);\n };\n\n const func: DebouncedState<T> = (...args: Parameters<T>): ReturnType<T> => {\n if (!isClientSize && !debounceOnServer) {\n return;\n }\n const time = Date.now();\n const isInvoking = shouldInvoke(time);\n\n lastArgs.current = args;\n lastThis.current = this;\n lastCallTime.current = time;\n\n if (isInvoking) {\n if (!timerId.current && mounted.current) {\n // Reset any `maxWait` timer.\n lastInvokeTime.current = lastCallTime.current;\n // Start the timer for the trailing edge.\n startTimer(timerExpired, wait);\n // Invoke the leading edge.\n return leading ? invokeFunc(lastCallTime.current) : result.current;\n }\n if (maxing) {\n // Handle invocations in a tight loop.\n startTimer(timerExpired, wait);\n return invokeFunc(lastCallTime.current);\n }\n }\n if (!timerId.current) {\n startTimer(timerExpired, wait);\n }\n return result.current;\n };\n\n func.cancel = () => {\n if (timerId.current) {\n useRAF\n ? cancelAnimationFrame(timerId.current)\n : clearTimeout(timerId.current);\n }\n lastInvokeTime.current = 0;\n lastArgs.current =\n lastCallTime.current =\n lastThis.current =\n timerId.current =\n null;\n };\n\n func.isPending = () => {\n return !!timerId.current;\n };\n\n func.flush = () => {\n return !timerId.current ? result.current : trailingEdge(Date.now());\n };\n\n return func;\n }, [\n leading,\n maxing,\n wait,\n maxWait,\n trailing,\n useRAF,\n isClientSize,\n debounceOnServer,\n ]);\n\n return debounced;\n}\n","import { useCallback, useRef, useReducer } from 'react';\nimport useDebouncedCallback, { DebouncedState } from './useDebouncedCallback';\n\nfunction valueEquality<T>(left: T, right: T): boolean {\n return left === right;\n}\n\nfunction reducer<T>(_: T, action: T) {\n return action;\n}\n\nexport default function useDebounce<T>(\n value: T,\n delay: number,\n options?: {\n maxWait?: number;\n leading?: boolean;\n trailing?: boolean;\n equalityFn?: (left: T, right: T) => boolean;\n }\n): [T, DebouncedState<(value: T) => void>] {\n const eq = (options && options.equalityFn) || valueEquality;\n\n const [state, dispatch] = useReducer(reducer, value);\n const debounced = useDebouncedCallback(\n useCallback((value: T) => dispatch(value), [dispatch]),\n delay,\n options\n );\n const previousValue = useRef(value);\n\n if (!eq(previousValue.current, value)) {\n debounced(value);\n previousValue.current = value;\n }\n\n return [state as T, debounced];\n}\n","import useDebouncedCallback, {\n CallOptions,\n DebouncedState,\n} from './useDebouncedCallback';\n\n/**\n * Creates a throttled function that only invokes `func` at most once per\n * every `wait` milliseconds (or once per browser frame).\n *\n * The throttled function comes with a `cancel` method to cancel delayed `func`\n * invocations and a `flush` method to immediately invoke them.\n *\n * Provide `options` to indicate whether `func` should be invoked on the leading\n * and/or trailing edge of the `wait` timeout. The `func` is invoked with the\n * last arguments provided to the throttled function.\n *\n * Subsequent calls to the throttled function return the result of the last\n * `func` invocation.\n *\n * **Note:** If `leading` and `trailing` options are `true`, `func` is\n * invoked on the trailing edge of the timeout only if the throttled function\n * is invoked more than once during the `wait` timeout.\n *\n * If `wait` is `0` and `leading` is `false`, `func` invocation is deferred\n * until the next tick, similar to `setTimeout` with a timeout of `0`.\n *\n * If `wait` is omitted in an environment with `requestAnimationFrame`, `func`\n * invocation will be deferred until the next frame is drawn (typically about\n * 16ms).\n *\n * See [David Corbacho's article](https://css-tricks.com/debouncing-throttling-explained-examples/)\n * for details over the differences between `throttle` and `debounce`.\n *\n * @category Function\n * @param {Function} func The function to throttle.\n * @param {number} [wait=0]\n * The number of milliseconds to throttle invocations to; if omitted,\n * `requestAnimationFrame` is used (if available, otherwise it will be setTimeout(...,0)).\n * @param {Object} [options={}] The options object.\n * @param {boolean} [options.leading=true]\n * Specify invoking on the leading edge of the timeout.\n * @param {boolean} [options.trailing=true]\n * Specify invoking on the trailing edge of the timeout.\n * @returns {Function} Returns the new throttled function.\n * @example\n *\n * // Avoid excessively updating the position while scrolling.\n * const scrollHandler = useThrottledCallback(updatePosition, 100)\n * window.addEventListener('scroll', scrollHandler)\n *\n * // Invoke `renewToken` when the click event is fired, but not more than once every 5 minutes.\n * const { callback } = useThrottledCallback(renewToken, 300000, { 'trailing': false })\n * <button onClick={callback}>click</button>\n *\n * // Cancel the trailing throttled invocation.\n * window.addEventListener('popstate', throttled.cancel);\n */\nexport default function useThrottledCallback<\n T extends (...args: any) => ReturnType<T>,\n>(\n func: T,\n wait: number,\n { leading = true, trailing = true }: CallOptions = {}\n): DebouncedState<T> {\n return useDebouncedCallback(func, wait, {\n maxWait: wait,\n leading,\n trailing,\n });\n}\n"],"names":["useDebouncedCallback","func","wait","options","lastCallTime","useRef","lastInvokeTime","timerId","lastArgs","lastThis","result","funcRef","mounted","current","isClientSize","window","useRAF","TypeError","leading","trailing","maxing","debounceOnServer","maxWait","Math","max","useEffect","debounced","useMemo","invokeFunc","time","args","thisArg","apply","startTimer","pendingFunc","cancelAnimationFrame","requestAnimationFrame","setTimeout","shouldInvoke","timeSinceLastCall","trailingEdge","timerExpired","Date","now","timeWaiting","remainingWait","min","isInvoking","this","cancel","clearTimeout","isPending","flush","valueEquality","left","right","reducer","_","action","useDebounce","value","delay","eq","equalityFn","state","dispatch","useReducer","useCallback","previousValue","useThrottledCallback"],"mappings":"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"}