export type Fn = (...args: any[]) => any;
export type FnAsync = (...args: any[]) => Promise<any>;
/**
 * Executes a function and returns its result or a fallback value if the function throws an error.
 *
 * @template T - The type of the function.
 * @template F - The type of the fallback value.
 * @param {T} fn - The function to execute.
 * @param {F} fallback - The fallback value to return if the function throws an error.
 * @param {...Parameters<T>} args - The parameters to pass to the function.
 * @returns {ReturnType<T> | F} The function's result or the fallback value if an error is thrown.
 *
 * @example
 * ```typescript
 * function divide(a: number, b: number): number {
 *   return a / b;
 * }
 *
 * const result = tryFn(divide, 0, 10, 2);
 *
 * console.log(result); // 5 or 0 if an error occurs
 * ```
 */
export declare function tryFn<T extends Fn, F>(fn: T, fallback: F, ...args: Parameters<T>): ReturnType<T> | F;
/**
 * Executes a function and returns a tuple containing either the result or the error.
 *
 * @template T - The type of the function.
 * @param fn - The function to execute.
 * @param args - The parameters to pass to the function.
 * @returns A tuple:
 * - [result, null] if the function executes successfully.
 * - [null, error] if an error is thrown during function execution.
 *
 * @example
 * ```typescript
 * function divide(a: number, b: number): number {
 *   return a / b;
 * }
 *
 * const [result, error] = tryFnWithError(divide, 10, 2);
 *
 * if (error) {
 *   console.error('Error occurred:', error);
 * } else {
 *   console.log('Result:', result);
 * }
 * ```
 */
export declare function tryFnWithError<T extends Fn>(fn: T, ...args: Parameters<T>): [ReturnType<T>, null] | [null, unknown];
/**
 * Executes an asynchronous function and returns its result or a fallback value if the function throws an error.
 *
 * @template T - The type of the asynchronous function.
 * @template F - The type of the fallback value.
 * @param {T} fn - The asynchronous function to execute.
 * @param {F} fallback - The fallback value to return if the function throws an error.
 * @param {...Parameters<T>} args - The parameters to pass to the function.
 * @returns {Promise<ReturnType<T> | F>} A Promise that resolves with the function's result or the fallback value if an error is thrown.
 *
 * @example
 * ```typescript
 * async function fetchData(id: number): Promise<string> {
 *   // simulate an API call
 *   return `Data for ID: ${id}`;
 * }
 *
 * const result = await tryFnAsync(fetchData, 'Fallback data', 10);
 *
 * console.log(result); // 'Data for ID: 10' or 'Fallback data' if an error occurs
 * ```
 */
export declare function tryFnAsync<T extends FnAsync, F>(fn: T, fallback: F, ...args: Parameters<T>): Promise<ReturnType<T> | F>;
/**
 * Executes an asynchronous function and returns a tuple containing either the result or the error.
 *
 * @template T - The type of the asynchronous function.
 * @param fn - The asynchronous function to execute.
 * @param args - The parameters to pass to the function.
 * @returns A Promise that resolves with a tuple:
 * - [result, null] if the function executes successfully.
 * - [null, error] if an error is thrown during function execution.
 *
 * @example
 * ```typescript
 * async function fetchData(id: number): Promise<string> {
 *   // simulate an API call
 *   return `Data for ID: ${id}`;
 * }
 *
 * const [data, error] = await tryFnAsyncWithError(fetchData, 10);
 *
 * if (error) {
 *   console.error('Error occurred:', error);
 * } else {
 *   console.log('Data received:', data);
 * }
 * ```
 */
export declare function tryFnAsyncWithError<T extends FnAsync>(fn: T, ...args: Parameters<T>): Promise<[ReturnType<T>, null] | [null, unknown]>;
/**
 * Pauses execution for a specified amount of time.
 *
 * @param {number} time - The amount of time to sleep, in milliseconds.
 * @returns {Promise<void>} A Promise that resolves after the specified time has passed.
 *
 * @example
 * ```typescript
 * await sleep(1000); // Pauses execution for 1 second
 * console.log('1 second has passed');
 * ```
 */
export declare function sleep(time: number): Promise<void>;