@usefy/use-debounce-callback 0.0.20 → 0.0.22

package/README.md

@@ -372,12 +372,7 @@ This package maintains comprehensive test coverage to ensure reliability and sta
 
 ### Test Coverage
 
-| Category   | Coverage        |
-| ---------- | --------------- |
-| Statements | 94.11% (96/102) |
-| Branches   | 82.6% (38/46)   |
-| Functions  | 93.75% (15/16)  |
-| Lines      | 94.05% (95/101) |
+📊 <a href="https://geon0529.github.io/usefy/coverage/use-debounce-callback/src/index.html" target="_blank" rel="noopener noreferrer"><strong>View Detailed Coverage Report</strong></a> (GitHub Pages)
 
 ### Test Categories
 

package/dist/index.js

@@ -151,7 +151,9 @@ function useDebounceCallback(callback, delay = 500, options = {}) {
             timerExpiredRef.current,
             waitRef.current
           );
-          return invokeFunc(time);
+          if (leadingRef.current || trailingRef.current) {
+            return invokeFunc(time);
+          }
         }
       }
       if (timerIdRef.current === void 0) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/useDebounceCallback.ts"],"sourcesContent":["export {\n  useDebounceCallback,\n  type UseDebounceCallbackOptions,\n  type DebouncedFunction,\n} from \"./useDebounceCallback\";\n","import { useCallback, useEffect, useMemo, useRef } from \"react\";\n\n/**\n * Options for useDebounceCallback hook\n */\nexport interface UseDebounceCallbackOptions {\n  /**\n   * Maximum time the debounced function can be delayed\n   * @default undefined (no maximum)\n   */\n  maxWait?: number;\n  /**\n   * Whether to invoke on the leading edge\n   * @default false\n   */\n  leading?: boolean;\n  /**\n   * Whether to invoke on the trailing edge\n   * @default true\n   */\n  trailing?: boolean;\n}\n\n/**\n * Debounced function interface with control methods\n */\nexport interface DebouncedFunction<T extends (...args: any[]) => any> {\n  /**\n   * Call the debounced function\n   */\n  (...args: Parameters<T>): ReturnType<T> | undefined;\n  /**\n   * Cancel any pending invocation\n   */\n  cancel: () => void;\n  /**\n   * Immediately invoke any pending invocation\n   */\n  flush: () => ReturnType<T> | undefined;\n  /**\n   * Check if there is a pending invocation\n   */\n  pending: () => boolean;\n}\n\n/**\n * Creates a debounced version of the provided callback function.\n * The debounced function delays invoking the callback until after `delay` milliseconds\n * have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the callback function\n * @param callback - The function to debounce\n * @param delay - The delay in milliseconds (default: 500ms)\n * @param options - Additional options for controlling debounce behavior\n * @returns A debounced version of the callback with cancel, flush, and pending methods\n *\n * @example\n * ```tsx\n * function SearchComponent() {\n *   const [results, setResults] = useState([]);\n *\n *   const debouncedSearch = useDebounceCallback(\n *     async (query: string) => {\n *       const data = await searchAPI(query);\n *       setResults(data);\n *     },\n *     500\n *   );\n *\n *   return (\n *     <input\n *       type=\"text\"\n *       onChange={(e) => debouncedSearch(e.target.value)}\n *       placeholder=\"Search...\"\n *     />\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With leading edge invocation\n * const debouncedFn = useDebounceCallback(callback, 300, { leading: true });\n * ```\n *\n * @example\n * ```tsx\n * // With maximum wait time\n * const debouncedFn = useDebounceCallback(callback, 500, { maxWait: 2000 });\n *\n * // Cancel pending invocation\n * debouncedFn.cancel();\n *\n * // Immediately invoke pending invocation\n * debouncedFn.flush();\n *\n * // Check if there's a pending invocation\n * if (debouncedFn.pending()) {\n *   console.log('There is a pending call');\n * }\n * ```\n */\nexport function useDebounceCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  delay: number = 500,\n  options: UseDebounceCallbackOptions = {}\n): DebouncedFunction<T> {\n  // Parse options\n  const wait = delay || 0;\n  const leading = options.leading ?? false;\n  const trailing = options.trailing !== undefined ? options.trailing : true;\n  const maxing = \"maxWait\" in options;\n  const maxWait = maxing ? Math.max(options.maxWait || 0, wait) : undefined;\n\n  // Refs for mutable state\n  const callbackRef = useRef<T>(callback);\n  const timerIdRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined\n  );\n  const lastCallTimeRef = useRef<number | undefined>(undefined);\n  const lastInvokeTimeRef = useRef<number>(0);\n  const lastArgsRef = useRef<Parameters<T> | undefined>(undefined);\n  const resultRef = useRef<ReturnType<T> | undefined>(undefined);\n\n  // Store options in refs\n  const waitRef = useRef(wait);\n  const leadingRef = useRef(leading);\n  const trailingRef = useRef(trailing);\n  const maxingRef = useRef(maxing);\n  const maxWaitRef = useRef(maxWait);\n\n  // Update callback ref on every render to always have the latest callback\n  callbackRef.current = callback;\n\n  // Update option refs when options change\n  waitRef.current = wait;\n  leadingRef.current = leading;\n  trailingRef.current = trailing;\n  maxingRef.current = maxing;\n  maxWaitRef.current = maxWait;\n\n  // Helper function to get current time\n  const now = useCallback(() => Date.now(), []);\n\n  // Helper function: shouldInvoke\n  const shouldInvoke = useCallback((time: number): boolean => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return true; // First call\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n\n    return (\n      timeSinceLastCall >= waitRef.current ||\n      timeSinceLastCall < 0 || // System time went backwards\n      (maxingRef.current &&\n        timeSinceLastInvoke >= (maxWaitRef.current as number))\n    );\n  }, []);\n\n  // Helper function: invokeFunc\n  const invokeFunc = useCallback((time: number): ReturnType<T> | undefined => {\n    const args = lastArgsRef.current;\n    lastArgsRef.current = undefined;\n    lastInvokeTimeRef.current = time;\n\n    if (args !== undefined) {\n      resultRef.current = callbackRef.current(...args);\n    }\n    return resultRef.current;\n  }, []);\n\n  // Helper function: remainingWait\n  const remainingWait = useCallback((time: number): number => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return waitRef.current;\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n    const timeWaiting = waitRef.current - timeSinceLastCall;\n\n    return maxingRef.current\n      ? Math.min(\n          timeWaiting,\n          (maxWaitRef.current as number) - timeSinceLastInvoke\n        )\n      : timeWaiting;\n  }, []);\n\n  // Forward declare timerExpired for mutual recursion\n  const timerExpiredRef = useRef<() => void>(() => {});\n\n  // Helper function: trailingEdge\n  const trailingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      timerIdRef.current = undefined;\n\n      // Only invoke if trailing is true and we have args (meaning the function was called)\n      if (trailingRef.current && lastArgsRef.current !== undefined) {\n        return invokeFunc(time);\n      }\n      lastArgsRef.current = undefined;\n      return resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Helper function: timerExpired\n  const timerExpired = useCallback((): void => {\n    const time = now();\n    if (shouldInvoke(time)) {\n      trailingEdge(time);\n    } else {\n      // Restart the timer\n      timerIdRef.current = setTimeout(\n        timerExpiredRef.current,\n        remainingWait(time)\n      );\n    }\n  }, [now, shouldInvoke, trailingEdge, remainingWait]);\n\n  // Update the ref after timerExpired is defined\n  timerExpiredRef.current = timerExpired;\n\n  // Helper function: leadingEdge\n  const leadingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      // Reset any `maxWait` timer\n      lastInvokeTimeRef.current = time;\n      // Start the timer for the trailing edge\n      timerIdRef.current = setTimeout(timerExpiredRef.current, waitRef.current);\n      // Invoke the leading edge\n      return leadingRef.current ? invokeFunc(time) : resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Cancel function\n  const cancel = useCallback((): void => {\n    if (timerIdRef.current !== undefined) {\n      clearTimeout(timerIdRef.current);\n    }\n    lastInvokeTimeRef.current = 0;\n    lastArgsRef.current = undefined;\n    lastCallTimeRef.current = undefined;\n    timerIdRef.current = undefined;\n  }, []);\n\n  // Flush function\n  const flush = useCallback((): ReturnType<T> | undefined => {\n    if (timerIdRef.current === undefined) {\n      return resultRef.current;\n    }\n    return trailingEdge(now());\n  }, [now, trailingEdge]);\n\n  // Pending function\n  const pending = useCallback((): boolean => {\n    return timerIdRef.current !== undefined;\n  }, []);\n\n  // Main debounced function\n  const debounced = useCallback(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const time = now();\n      const isInvoking = shouldInvoke(time);\n\n      lastArgsRef.current = args;\n      lastCallTimeRef.current = time;\n\n      if (isInvoking) {\n        if (timerIdRef.current === undefined) {\n          return leadingEdge(time);\n        }\n        if (maxingRef.current) {\n          // Handle invocations in a tight loop\n          clearTimeout(timerIdRef.current);\n          timerIdRef.current = setTimeout(\n            timerExpiredRef.current,\n            waitRef.current\n          );\n          return invokeFunc(time);\n        }\n      }\n      if (timerIdRef.current === undefined) {\n        timerIdRef.current = setTimeout(\n          timerExpiredRef.current,\n          waitRef.current\n        );\n      }\n      return resultRef.current;\n    },\n    [now, shouldInvoke, leadingEdge, invokeFunc]\n  );\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timerIdRef.current !== undefined) {\n        clearTimeout(timerIdRef.current);\n      }\n    };\n  }, []);\n\n  // Create the debounced function with attached methods\n  const debouncedWithMethods = useMemo(() => {\n    const fn = debounced as DebouncedFunction<T>;\n    fn.cancel = cancel;\n    fn.flush = flush;\n    fn.pending = pending;\n    return fn;\n  }, [debounced, cancel, flush, pending]);\n\n  return debouncedWithMethods;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/useDebounceCallback.ts"],"sourcesContent":["export {\n  useDebounceCallback,\n  type UseDebounceCallbackOptions,\n  type DebouncedFunction,\n} from \"./useDebounceCallback\";\n","import { useCallback, useEffect, useMemo, useRef } from \"react\";\n\n/**\n * Options for useDebounceCallback hook\n */\nexport interface UseDebounceCallbackOptions {\n  /**\n   * Maximum time the debounced function can be delayed\n   * @default undefined (no maximum)\n   */\n  maxWait?: number;\n  /**\n   * Whether to invoke on the leading edge\n   * @default false\n   */\n  leading?: boolean;\n  /**\n   * Whether to invoke on the trailing edge\n   * @default true\n   */\n  trailing?: boolean;\n}\n\n/**\n * Debounced function interface with control methods\n */\nexport interface DebouncedFunction<T extends (...args: any[]) => any> {\n  /**\n   * Call the debounced function\n   */\n  (...args: Parameters<T>): ReturnType<T> | undefined;\n  /**\n   * Cancel any pending invocation\n   */\n  cancel: () => void;\n  /**\n   * Immediately invoke any pending invocation\n   */\n  flush: () => ReturnType<T> | undefined;\n  /**\n   * Check if there is a pending invocation\n   */\n  pending: () => boolean;\n}\n\n/**\n * Creates a debounced version of the provided callback function.\n * The debounced function delays invoking the callback until after `delay` milliseconds\n * have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the callback function\n * @param callback - The function to debounce\n * @param delay - The delay in milliseconds (default: 500ms)\n * @param options - Additional options for controlling debounce behavior\n * @returns A debounced version of the callback with cancel, flush, and pending methods\n *\n * @example\n * ```tsx\n * function SearchComponent() {\n *   const [results, setResults] = useState([]);\n *\n *   const debouncedSearch = useDebounceCallback(\n *     async (query: string) => {\n *       const data = await searchAPI(query);\n *       setResults(data);\n *     },\n *     500\n *   );\n *\n *   return (\n *     <input\n *       type=\"text\"\n *       onChange={(e) => debouncedSearch(e.target.value)}\n *       placeholder=\"Search...\"\n *     />\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With leading edge invocation\n * const debouncedFn = useDebounceCallback(callback, 300, { leading: true });\n * ```\n *\n * @example\n * ```tsx\n * // With maximum wait time\n * const debouncedFn = useDebounceCallback(callback, 500, { maxWait: 2000 });\n *\n * // Cancel pending invocation\n * debouncedFn.cancel();\n *\n * // Immediately invoke pending invocation\n * debouncedFn.flush();\n *\n * // Check if there's a pending invocation\n * if (debouncedFn.pending()) {\n *   console.log('There is a pending call');\n * }\n * ```\n */\nexport function useDebounceCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  delay: number = 500,\n  options: UseDebounceCallbackOptions = {}\n): DebouncedFunction<T> {\n  // Parse options\n  const wait = delay || 0;\n  const leading = options.leading ?? false;\n  const trailing = options.trailing !== undefined ? options.trailing : true;\n  const maxing = \"maxWait\" in options;\n  const maxWait = maxing ? Math.max(options.maxWait || 0, wait) : undefined;\n\n  // Refs for mutable state\n  const callbackRef = useRef<T>(callback);\n  const timerIdRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined\n  );\n  const lastCallTimeRef = useRef<number | undefined>(undefined);\n  const lastInvokeTimeRef = useRef<number>(0);\n  const lastArgsRef = useRef<Parameters<T> | undefined>(undefined);\n  const resultRef = useRef<ReturnType<T> | undefined>(undefined);\n\n  // Store options in refs\n  const waitRef = useRef(wait);\n  const leadingRef = useRef(leading);\n  const trailingRef = useRef(trailing);\n  const maxingRef = useRef(maxing);\n  const maxWaitRef = useRef(maxWait);\n\n  // Update callback ref on every render to always have the latest callback\n  callbackRef.current = callback;\n\n  // Update option refs when options change\n  waitRef.current = wait;\n  leadingRef.current = leading;\n  trailingRef.current = trailing;\n  maxingRef.current = maxing;\n  maxWaitRef.current = maxWait;\n\n  // Helper function to get current time\n  const now = useCallback(() => Date.now(), []);\n\n  // Helper function: shouldInvoke\n  const shouldInvoke = useCallback((time: number): boolean => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return true; // First call\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n\n    return (\n      timeSinceLastCall >= waitRef.current ||\n      timeSinceLastCall < 0 || // System time went backwards\n      (maxingRef.current &&\n        timeSinceLastInvoke >= (maxWaitRef.current as number))\n    );\n  }, []);\n\n  // Helper function: invokeFunc\n  const invokeFunc = useCallback((time: number): ReturnType<T> | undefined => {\n    const args = lastArgsRef.current;\n    lastArgsRef.current = undefined;\n    lastInvokeTimeRef.current = time;\n\n    if (args !== undefined) {\n      resultRef.current = callbackRef.current(...args);\n    }\n    return resultRef.current;\n  }, []);\n\n  // Helper function: remainingWait\n  const remainingWait = useCallback((time: number): number => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return waitRef.current;\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n    const timeWaiting = waitRef.current - timeSinceLastCall;\n\n    return maxingRef.current\n      ? Math.min(\n          timeWaiting,\n          (maxWaitRef.current as number) - timeSinceLastInvoke\n        )\n      : timeWaiting;\n  }, []);\n\n  // Forward declare timerExpired for mutual recursion\n  const timerExpiredRef = useRef<() => void>(() => {});\n\n  // Helper function: trailingEdge\n  const trailingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      timerIdRef.current = undefined;\n\n      // Only invoke if trailing is true and we have args (meaning the function was called)\n      if (trailingRef.current && lastArgsRef.current !== undefined) {\n        return invokeFunc(time);\n      }\n      lastArgsRef.current = undefined;\n      return resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Helper function: timerExpired\n  const timerExpired = useCallback((): void => {\n    const time = now();\n    if (shouldInvoke(time)) {\n      trailingEdge(time);\n    } else {\n      // Restart the timer\n      timerIdRef.current = setTimeout(\n        timerExpiredRef.current,\n        remainingWait(time)\n      );\n    }\n  }, [now, shouldInvoke, trailingEdge, remainingWait]);\n\n  // Update the ref after timerExpired is defined\n  timerExpiredRef.current = timerExpired;\n\n  // Helper function: leadingEdge\n  const leadingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      // Reset any `maxWait` timer\n      lastInvokeTimeRef.current = time;\n      // Start the timer for the trailing edge\n      timerIdRef.current = setTimeout(timerExpiredRef.current, waitRef.current);\n      // Invoke the leading edge\n      return leadingRef.current ? invokeFunc(time) : resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Cancel function\n  const cancel = useCallback((): void => {\n    if (timerIdRef.current !== undefined) {\n      clearTimeout(timerIdRef.current);\n    }\n    lastInvokeTimeRef.current = 0;\n    lastArgsRef.current = undefined;\n    lastCallTimeRef.current = undefined;\n    timerIdRef.current = undefined;\n  }, []);\n\n  // Flush function\n  const flush = useCallback((): ReturnType<T> | undefined => {\n    if (timerIdRef.current === undefined) {\n      return resultRef.current;\n    }\n    return trailingEdge(now());\n  }, [now, trailingEdge]);\n\n  // Pending function\n  const pending = useCallback((): boolean => {\n    return timerIdRef.current !== undefined;\n  }, []);\n\n  // Main debounced function\n  const debounced = useCallback(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const time = now();\n      const isInvoking = shouldInvoke(time);\n\n      lastArgsRef.current = args;\n      lastCallTimeRef.current = time;\n\n      if (isInvoking) {\n        if (timerIdRef.current === undefined) {\n          return leadingEdge(time);\n        }\n        if (maxingRef.current) {\n          // Handle invocations in a tight loop\n          clearTimeout(timerIdRef.current);\n          timerIdRef.current = setTimeout(\n            timerExpiredRef.current,\n            waitRef.current\n          );\n          // Only invoke if at least one edge is enabled (matches lodash behavior)\n          if (leadingRef.current || trailingRef.current) {\n            return invokeFunc(time);\n          }\n        }\n      }\n      if (timerIdRef.current === undefined) {\n        timerIdRef.current = setTimeout(\n          timerExpiredRef.current,\n          waitRef.current\n        );\n      }\n      return resultRef.current;\n    },\n    [now, shouldInvoke, leadingEdge, invokeFunc]\n  );\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timerIdRef.current !== undefined) {\n        clearTimeout(timerIdRef.current);\n      }\n    };\n  }, []);\n\n  // Create the debounced function with attached methods\n  const debouncedWithMethods = useMemo(() => {\n    const fn = debounced as DebouncedFunction<T>;\n    fn.cancel = cancel;\n    fn.flush = flush;\n    fn.pending = pending;\n    return fn;\n  }, [debounced, cancel, flush, pending]);\n\n  return debouncedWithMethods;\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -125,7 +125,9 @@ function useDebounceCallback(callback, delay = 500, options = {}) {
             timerExpiredRef.current,
             waitRef.current
           );
-          return invokeFunc(time);
+          if (leadingRef.current || trailingRef.current) {
+            return invokeFunc(time);
+          }
         }
       }
       if (timerIdRef.current === void 0) {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDebounceCallback.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef } from \"react\";\n\n/**\n * Options for useDebounceCallback hook\n */\nexport interface UseDebounceCallbackOptions {\n  /**\n   * Maximum time the debounced function can be delayed\n   * @default undefined (no maximum)\n   */\n  maxWait?: number;\n  /**\n   * Whether to invoke on the leading edge\n   * @default false\n   */\n  leading?: boolean;\n  /**\n   * Whether to invoke on the trailing edge\n   * @default true\n   */\n  trailing?: boolean;\n}\n\n/**\n * Debounced function interface with control methods\n */\nexport interface DebouncedFunction<T extends (...args: any[]) => any> {\n  /**\n   * Call the debounced function\n   */\n  (...args: Parameters<T>): ReturnType<T> | undefined;\n  /**\n   * Cancel any pending invocation\n   */\n  cancel: () => void;\n  /**\n   * Immediately invoke any pending invocation\n   */\n  flush: () => ReturnType<T> | undefined;\n  /**\n   * Check if there is a pending invocation\n   */\n  pending: () => boolean;\n}\n\n/**\n * Creates a debounced version of the provided callback function.\n * The debounced function delays invoking the callback until after `delay` milliseconds\n * have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the callback function\n * @param callback - The function to debounce\n * @param delay - The delay in milliseconds (default: 500ms)\n * @param options - Additional options for controlling debounce behavior\n * @returns A debounced version of the callback with cancel, flush, and pending methods\n *\n * @example\n * ```tsx\n * function SearchComponent() {\n *   const [results, setResults] = useState([]);\n *\n *   const debouncedSearch = useDebounceCallback(\n *     async (query: string) => {\n *       const data = await searchAPI(query);\n *       setResults(data);\n *     },\n *     500\n *   );\n *\n *   return (\n *     <input\n *       type=\"text\"\n *       onChange={(e) => debouncedSearch(e.target.value)}\n *       placeholder=\"Search...\"\n *     />\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With leading edge invocation\n * const debouncedFn = useDebounceCallback(callback, 300, { leading: true });\n * ```\n *\n * @example\n * ```tsx\n * // With maximum wait time\n * const debouncedFn = useDebounceCallback(callback, 500, { maxWait: 2000 });\n *\n * // Cancel pending invocation\n * debouncedFn.cancel();\n *\n * // Immediately invoke pending invocation\n * debouncedFn.flush();\n *\n * // Check if there's a pending invocation\n * if (debouncedFn.pending()) {\n *   console.log('There is a pending call');\n * }\n * ```\n */\nexport function useDebounceCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  delay: number = 500,\n  options: UseDebounceCallbackOptions = {}\n): DebouncedFunction<T> {\n  // Parse options\n  const wait = delay || 0;\n  const leading = options.leading ?? false;\n  const trailing = options.trailing !== undefined ? options.trailing : true;\n  const maxing = \"maxWait\" in options;\n  const maxWait = maxing ? Math.max(options.maxWait || 0, wait) : undefined;\n\n  // Refs for mutable state\n  const callbackRef = useRef<T>(callback);\n  const timerIdRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined\n  );\n  const lastCallTimeRef = useRef<number | undefined>(undefined);\n  const lastInvokeTimeRef = useRef<number>(0);\n  const lastArgsRef = useRef<Parameters<T> | undefined>(undefined);\n  const resultRef = useRef<ReturnType<T> | undefined>(undefined);\n\n  // Store options in refs\n  const waitRef = useRef(wait);\n  const leadingRef = useRef(leading);\n  const trailingRef = useRef(trailing);\n  const maxingRef = useRef(maxing);\n  const maxWaitRef = useRef(maxWait);\n\n  // Update callback ref on every render to always have the latest callback\n  callbackRef.current = callback;\n\n  // Update option refs when options change\n  waitRef.current = wait;\n  leadingRef.current = leading;\n  trailingRef.current = trailing;\n  maxingRef.current = maxing;\n  maxWaitRef.current = maxWait;\n\n  // Helper function to get current time\n  const now = useCallback(() => Date.now(), []);\n\n  // Helper function: shouldInvoke\n  const shouldInvoke = useCallback((time: number): boolean => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return true; // First call\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n\n    return (\n      timeSinceLastCall >= waitRef.current ||\n      timeSinceLastCall < 0 || // System time went backwards\n      (maxingRef.current &&\n        timeSinceLastInvoke >= (maxWaitRef.current as number))\n    );\n  }, []);\n\n  // Helper function: invokeFunc\n  const invokeFunc = useCallback((time: number): ReturnType<T> | undefined => {\n    const args = lastArgsRef.current;\n    lastArgsRef.current = undefined;\n    lastInvokeTimeRef.current = time;\n\n    if (args !== undefined) {\n      resultRef.current = callbackRef.current(...args);\n    }\n    return resultRef.current;\n  }, []);\n\n  // Helper function: remainingWait\n  const remainingWait = useCallback((time: number): number => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return waitRef.current;\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n    const timeWaiting = waitRef.current - timeSinceLastCall;\n\n    return maxingRef.current\n      ? Math.min(\n          timeWaiting,\n          (maxWaitRef.current as number) - timeSinceLastInvoke\n        )\n      : timeWaiting;\n  }, []);\n\n  // Forward declare timerExpired for mutual recursion\n  const timerExpiredRef = useRef<() => void>(() => {});\n\n  // Helper function: trailingEdge\n  const trailingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      timerIdRef.current = undefined;\n\n      // Only invoke if trailing is true and we have args (meaning the function was called)\n      if (trailingRef.current && lastArgsRef.current !== undefined) {\n        return invokeFunc(time);\n      }\n      lastArgsRef.current = undefined;\n      return resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Helper function: timerExpired\n  const timerExpired = useCallback((): void => {\n    const time = now();\n    if (shouldInvoke(time)) {\n      trailingEdge(time);\n    } else {\n      // Restart the timer\n      timerIdRef.current = setTimeout(\n        timerExpiredRef.current,\n        remainingWait(time)\n      );\n    }\n  }, [now, shouldInvoke, trailingEdge, remainingWait]);\n\n  // Update the ref after timerExpired is defined\n  timerExpiredRef.current = timerExpired;\n\n  // Helper function: leadingEdge\n  const leadingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      // Reset any `maxWait` timer\n      lastInvokeTimeRef.current = time;\n      // Start the timer for the trailing edge\n      timerIdRef.current = setTimeout(timerExpiredRef.current, waitRef.current);\n      // Invoke the leading edge\n      return leadingRef.current ? invokeFunc(time) : resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Cancel function\n  const cancel = useCallback((): void => {\n    if (timerIdRef.current !== undefined) {\n      clearTimeout(timerIdRef.current);\n    }\n    lastInvokeTimeRef.current = 0;\n    lastArgsRef.current = undefined;\n    lastCallTimeRef.current = undefined;\n    timerIdRef.current = undefined;\n  }, []);\n\n  // Flush function\n  const flush = useCallback((): ReturnType<T> | undefined => {\n    if (timerIdRef.current === undefined) {\n      return resultRef.current;\n    }\n    return trailingEdge(now());\n  }, [now, trailingEdge]);\n\n  // Pending function\n  const pending = useCallback((): boolean => {\n    return timerIdRef.current !== undefined;\n  }, []);\n\n  // Main debounced function\n  const debounced = useCallback(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const time = now();\n      const isInvoking = shouldInvoke(time);\n\n      lastArgsRef.current = args;\n      lastCallTimeRef.current = time;\n\n      if (isInvoking) {\n        if (timerIdRef.current === undefined) {\n          return leadingEdge(time);\n        }\n        if (maxingRef.current) {\n          // Handle invocations in a tight loop\n          clearTimeout(timerIdRef.current);\n          timerIdRef.current = setTimeout(\n            timerExpiredRef.current,\n            waitRef.current\n          );\n          return invokeFunc(time);\n        }\n      }\n      if (timerIdRef.current === undefined) {\n        timerIdRef.current = setTimeout(\n          timerExpiredRef.current,\n          waitRef.current\n        );\n      }\n      return resultRef.current;\n    },\n    [now, shouldInvoke, leadingEdge, invokeFunc]\n  );\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timerIdRef.current !== undefined) {\n        clearTimeout(timerIdRef.current);\n      }\n    };\n  }, []);\n\n  // Create the debounced function with attached methods\n  const debouncedWithMethods = useMemo(() => {\n    const fn = debounced as DebouncedFunction<T>;\n    fn.cancel = cancel;\n    fn.flush = flush;\n    fn.pending = pending;\n    return fn;\n  }, [debounced, cancel, flush, pending]);\n\n  return debouncedWithMethods;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/useDebounceCallback.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef } from \"react\";\n\n/**\n * Options for useDebounceCallback hook\n */\nexport interface UseDebounceCallbackOptions {\n  /**\n   * Maximum time the debounced function can be delayed\n   * @default undefined (no maximum)\n   */\n  maxWait?: number;\n  /**\n   * Whether to invoke on the leading edge\n   * @default false\n   */\n  leading?: boolean;\n  /**\n   * Whether to invoke on the trailing edge\n   * @default true\n   */\n  trailing?: boolean;\n}\n\n/**\n * Debounced function interface with control methods\n */\nexport interface DebouncedFunction<T extends (...args: any[]) => any> {\n  /**\n   * Call the debounced function\n   */\n  (...args: Parameters<T>): ReturnType<T> | undefined;\n  /**\n   * Cancel any pending invocation\n   */\n  cancel: () => void;\n  /**\n   * Immediately invoke any pending invocation\n   */\n  flush: () => ReturnType<T> | undefined;\n  /**\n   * Check if there is a pending invocation\n   */\n  pending: () => boolean;\n}\n\n/**\n * Creates a debounced version of the provided callback function.\n * The debounced function delays invoking the callback until after `delay` milliseconds\n * have elapsed since the last time the debounced function was invoked.\n *\n * @template T - The type of the callback function\n * @param callback - The function to debounce\n * @param delay - The delay in milliseconds (default: 500ms)\n * @param options - Additional options for controlling debounce behavior\n * @returns A debounced version of the callback with cancel, flush, and pending methods\n *\n * @example\n * ```tsx\n * function SearchComponent() {\n *   const [results, setResults] = useState([]);\n *\n *   const debouncedSearch = useDebounceCallback(\n *     async (query: string) => {\n *       const data = await searchAPI(query);\n *       setResults(data);\n *     },\n *     500\n *   );\n *\n *   return (\n *     <input\n *       type=\"text\"\n *       onChange={(e) => debouncedSearch(e.target.value)}\n *       placeholder=\"Search...\"\n *     />\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With leading edge invocation\n * const debouncedFn = useDebounceCallback(callback, 300, { leading: true });\n * ```\n *\n * @example\n * ```tsx\n * // With maximum wait time\n * const debouncedFn = useDebounceCallback(callback, 500, { maxWait: 2000 });\n *\n * // Cancel pending invocation\n * debouncedFn.cancel();\n *\n * // Immediately invoke pending invocation\n * debouncedFn.flush();\n *\n * // Check if there's a pending invocation\n * if (debouncedFn.pending()) {\n *   console.log('There is a pending call');\n * }\n * ```\n */\nexport function useDebounceCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  delay: number = 500,\n  options: UseDebounceCallbackOptions = {}\n): DebouncedFunction<T> {\n  // Parse options\n  const wait = delay || 0;\n  const leading = options.leading ?? false;\n  const trailing = options.trailing !== undefined ? options.trailing : true;\n  const maxing = \"maxWait\" in options;\n  const maxWait = maxing ? Math.max(options.maxWait || 0, wait) : undefined;\n\n  // Refs for mutable state\n  const callbackRef = useRef<T>(callback);\n  const timerIdRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined\n  );\n  const lastCallTimeRef = useRef<number | undefined>(undefined);\n  const lastInvokeTimeRef = useRef<number>(0);\n  const lastArgsRef = useRef<Parameters<T> | undefined>(undefined);\n  const resultRef = useRef<ReturnType<T> | undefined>(undefined);\n\n  // Store options in refs\n  const waitRef = useRef(wait);\n  const leadingRef = useRef(leading);\n  const trailingRef = useRef(trailing);\n  const maxingRef = useRef(maxing);\n  const maxWaitRef = useRef(maxWait);\n\n  // Update callback ref on every render to always have the latest callback\n  callbackRef.current = callback;\n\n  // Update option refs when options change\n  waitRef.current = wait;\n  leadingRef.current = leading;\n  trailingRef.current = trailing;\n  maxingRef.current = maxing;\n  maxWaitRef.current = maxWait;\n\n  // Helper function to get current time\n  const now = useCallback(() => Date.now(), []);\n\n  // Helper function: shouldInvoke\n  const shouldInvoke = useCallback((time: number): boolean => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return true; // First call\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n\n    return (\n      timeSinceLastCall >= waitRef.current ||\n      timeSinceLastCall < 0 || // System time went backwards\n      (maxingRef.current &&\n        timeSinceLastInvoke >= (maxWaitRef.current as number))\n    );\n  }, []);\n\n  // Helper function: invokeFunc\n  const invokeFunc = useCallback((time: number): ReturnType<T> | undefined => {\n    const args = lastArgsRef.current;\n    lastArgsRef.current = undefined;\n    lastInvokeTimeRef.current = time;\n\n    if (args !== undefined) {\n      resultRef.current = callbackRef.current(...args);\n    }\n    return resultRef.current;\n  }, []);\n\n  // Helper function: remainingWait\n  const remainingWait = useCallback((time: number): number => {\n    const lastCallTime = lastCallTimeRef.current;\n    if (lastCallTime === undefined) {\n      return waitRef.current;\n    }\n\n    const timeSinceLastCall = time - lastCallTime;\n    const timeSinceLastInvoke = time - lastInvokeTimeRef.current;\n    const timeWaiting = waitRef.current - timeSinceLastCall;\n\n    return maxingRef.current\n      ? Math.min(\n          timeWaiting,\n          (maxWaitRef.current as number) - timeSinceLastInvoke\n        )\n      : timeWaiting;\n  }, []);\n\n  // Forward declare timerExpired for mutual recursion\n  const timerExpiredRef = useRef<() => void>(() => {});\n\n  // Helper function: trailingEdge\n  const trailingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      timerIdRef.current = undefined;\n\n      // Only invoke if trailing is true and we have args (meaning the function was called)\n      if (trailingRef.current && lastArgsRef.current !== undefined) {\n        return invokeFunc(time);\n      }\n      lastArgsRef.current = undefined;\n      return resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Helper function: timerExpired\n  const timerExpired = useCallback((): void => {\n    const time = now();\n    if (shouldInvoke(time)) {\n      trailingEdge(time);\n    } else {\n      // Restart the timer\n      timerIdRef.current = setTimeout(\n        timerExpiredRef.current,\n        remainingWait(time)\n      );\n    }\n  }, [now, shouldInvoke, trailingEdge, remainingWait]);\n\n  // Update the ref after timerExpired is defined\n  timerExpiredRef.current = timerExpired;\n\n  // Helper function: leadingEdge\n  const leadingEdge = useCallback(\n    (time: number): ReturnType<T> | undefined => {\n      // Reset any `maxWait` timer\n      lastInvokeTimeRef.current = time;\n      // Start the timer for the trailing edge\n      timerIdRef.current = setTimeout(timerExpiredRef.current, waitRef.current);\n      // Invoke the leading edge\n      return leadingRef.current ? invokeFunc(time) : resultRef.current;\n    },\n    [invokeFunc]\n  );\n\n  // Cancel function\n  const cancel = useCallback((): void => {\n    if (timerIdRef.current !== undefined) {\n      clearTimeout(timerIdRef.current);\n    }\n    lastInvokeTimeRef.current = 0;\n    lastArgsRef.current = undefined;\n    lastCallTimeRef.current = undefined;\n    timerIdRef.current = undefined;\n  }, []);\n\n  // Flush function\n  const flush = useCallback((): ReturnType<T> | undefined => {\n    if (timerIdRef.current === undefined) {\n      return resultRef.current;\n    }\n    return trailingEdge(now());\n  }, [now, trailingEdge]);\n\n  // Pending function\n  const pending = useCallback((): boolean => {\n    return timerIdRef.current !== undefined;\n  }, []);\n\n  // Main debounced function\n  const debounced = useCallback(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const time = now();\n      const isInvoking = shouldInvoke(time);\n\n      lastArgsRef.current = args;\n      lastCallTimeRef.current = time;\n\n      if (isInvoking) {\n        if (timerIdRef.current === undefined) {\n          return leadingEdge(time);\n        }\n        if (maxingRef.current) {\n          // Handle invocations in a tight loop\n          clearTimeout(timerIdRef.current);\n          timerIdRef.current = setTimeout(\n            timerExpiredRef.current,\n            waitRef.current\n          );\n          // Only invoke if at least one edge is enabled (matches lodash behavior)\n          if (leadingRef.current || trailingRef.current) {\n            return invokeFunc(time);\n          }\n        }\n      }\n      if (timerIdRef.current === undefined) {\n        timerIdRef.current = setTimeout(\n          timerExpiredRef.current,\n          waitRef.current\n        );\n      }\n      return resultRef.current;\n    },\n    [now, shouldInvoke, leadingEdge, invokeFunc]\n  );\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (timerIdRef.current !== undefined) {\n        clearTimeout(timerIdRef.current);\n      }\n    };\n  }, []);\n\n  // Create the debounced function with attached methods\n  const debouncedWithMethods = useMemo(() => {\n    const fn = debounced as DebouncedFunction<T>;\n    fn.cancel = cancel;\n    fn.flush = flush;\n    fn.pending = pending;\n    return fn;\n  }, [debounced, cancel, flush, pending]);\n\n  return debouncedWithMethods;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefy/use-debounce-callback",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "A React hook for debouncing callback functions",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",