import { type PlayerOptions, type PlayOptions } from "./types.js";
/**
 * A "player" that can be used to play an audio file.
 *
 * @example
 *
 * ```ts
 * import { Player } from "cli-sound";
 *
 * try {
 *   const player = new Player();
 *   const audioPath = "test.mp3";
 * } catch (error) {
 *   console.error("An error occurred while playing the file:");
 *   console.error(error);
 * }
 * ```
 */
export declare class Player {
    #private;
    constructor({ commands, extendCommands, ...options }?: PlayerOptions);
    /**
     * Creates a command that can be used to play an audio file.
     *
     * Useful if you want to use your own method to play the audio file, or just
     * want to see what command will be used for debugging purposes.
     */
    createPlayCommand(filePath: string, options?: PlayOptions): string;
    /**
     * Plays an audio file.
     *
     * When the command is done, the returned promise will be resolved with the
     * stdout and stderr of the command.
     */
    play(filePath: string, options?: PlayOptions): Promise<{
        stdout: string;
        stderr: string;
    }>;
}