/**
 * A custom hook that debounces a value, delaying updates until after a specified delay period.
 * Useful for optimizing performance when dealing with rapidly changing values like user input.
 *
 * @param value - The value to debounce
 * @param delay - The delay in milliseconds before updating the debounced value
 * @returns The debounced value that only updates after the delay period
 *
 * @example
 * ```ts
 * const [searchTerm, setSearchTerm] = useState('')
 * const debouncedSearchTerm = useDebounce(searchTerm, 500)
 *
 * // API call will only happen 500ms after user stops typing
 * useEffect(() => {
 *   if (debouncedSearchTerm) {
 *     searchAPI(debouncedSearchTerm)
 *   }
 * }, [debouncedSearchTerm])
 * ```
 */
export declare function useDebounce<T>(value: T, delay: number): T;