import { KeyboardShortcut } from '../interfaces/keyboard.interface.cjs';
import { PromiseWithResolver } from '../interfaces/utils.interface.cjs';
import './constant/shortcut.const.cjs';

declare function debounce<T extends unknown[]>(fn: (...args: T) => void, delay: number): (...args: T) => void;
declare function createDebounce(): (callback: () => void, timeoutMs: number) => void;
type ThrottledFunction<T extends unknown[]> = (...args: T) => void;
declare function throttle<T extends unknown[]>(func: (...args: T) => void, limit?: number): ThrottledFunction<T>;
declare function parseJSON<T = unknown, K = unknown>(input: string, def?: K): T | K;
declare function isObject(input: unknown): input is Record<number | string | symbol, unknown>;
declare function sleep(ms?: number): Promise<void>;
declare function getRandomArbitrary(min?: number, max?: number, remainder?: number): number;
declare function getRandomItemFromArr<T>(array: T[]): T;
declare function shuffleArray<T>(array: T[]): T[];
declare function isValidURL(url: string): boolean;
declare function getShortcutStr(shortcut?: KeyboardShortcut, wrap?: boolean): string;
declare function generateRandomString(length?: number): string;
declare function promiseWithResolver<T = void>(): PromiseWithResolver<T>;
declare function sleepWithRetry(callback: () => boolean | Promise<boolean>, ms?: number): Promise<void>;
declare function searhParamsBuilder(queries: Record<string, string | undefined>): URLSearchParams;

export { type ThrottledFunction, createDebounce, debounce, generateRandomString, getRandomArbitrary, getRandomItemFromArr, getShortcutStr, isObject, isValidURL, parseJSON, promiseWithResolver, searhParamsBuilder, shuffleArray, sleep, sleepWithRetry, throttle };