import { type ThrottledFunction, throttle } from "es-toolkit";
type Dep = Array<unknown>;
type Callback<Args extends unknown[], Return> = (...args: Args) => Return;
export type ThrottleOptions = Parameters<typeof throttle>[2];
/**
 * Returns a memoized throttled function.
 *
 * @remarks
 * This hook wraps `es-toolkit`'s `throttle` function.
 * The callback is always up-to-date (via ref), so you don't need to include it in deps.
 *
 * @typeParam Args - The arguments of the callback.
 * @typeParam Return - The return type of the callback.
 * @param cb - The function to throttle.
 * @param wait - The throttle wait time in milliseconds.
 * @param dep - Additional dependencies to recreate the throttled function.
 * @param options - Throttle options (leading, trailing, etc.).
 * @returns The throttled function.
 *
 * @example
 * ```tsx
 * const throttledScroll = useThrottleCallback((e) => {
 *   console.log("Scroll event", e);
 * }, 100);
 * ```
 */
export declare function useThrottleCallback<Args extends unknown[], Return = unknown>(cb: Callback<Args, Return>, wait: number, dep?: Dep, options?: ThrottleOptions): ThrottledFunction<Callback<Args, Return>>;
export {};