export interface RetroArchOptions {
    /** Target host (UDP destination). Default 127.0.0.1. */
    host?: string;
    /** UDP port. Must match `network_cmd_port` in retroarch.cfg. Default 55355. */
    port?: number;
    /** Per-call timeout in ms (responses only). Default 5000. */
    timeoutMs?: number;
}
export type EmuStatus = {
    state: "playing" | "paused";
    system: string;
    game: string;
    crc32?: string;
} | {
    state: "contentless";
};
export declare class RetroArchClient {
    private socket;
    private pending;
    private readonly host;
    private readonly port;
    private readonly timeoutMs;
    constructor(opts?: RetroArchOptions);
    describeTarget(): string;
    /** Open a UDP socket and bind a message handler. */
    connect(): Promise<void>;
    disconnect(): void;
    /** Fire-and-forget send. Use for hotkey-style commands (PAUSE_TOGGLE, etc.). */
    send(command: string): Promise<void>;
    /**
     * Send and await one UDP response. Serial: throws if a previous query is
     * still in flight. Times out per `timeoutMs`.
     */
    query(command: string): Promise<Buffer>;
    getVersion(): Promise<string>;
    getStatus(): Promise<EmuStatus>;
    /** Memory read via libretro's system memory map (preferred). */
    readMemory(addr: number, length: number): Promise<Uint8Array>;
    /** Memory read via the achievements (CHEEVOS) address space. */
    readRam(addr: number, length: number): Promise<Uint8Array>;
    /** Memory write via libretro's system memory map (preferred). */
    writeMemory(addr: number, bytes: Uint8Array | number[]): Promise<number>;
    /** Memory write via CHEEVOS address space. No reply — fire-and-forget. */
    writeRam(addr: number, bytes: Uint8Array | number[]): Promise<void>;
    pauseToggle(): Promise<void>;
    frameAdvance(): Promise<void>;
    reset(): Promise<void>;
    screenshot(): Promise<void>;
    showMessage(msg: string): Promise<void>;
    saveStateCurrent(): Promise<void>;
    loadStateCurrent(): Promise<void>;
    loadStateSlot(slot: number): Promise<void>;
    stateSlotPlus(): Promise<void>;
    stateSlotMinus(): Promise<void>;
    /** GET_CONFIG_PARAM — query select RetroArch config values by name. */
    getConfigParam(name: string): Promise<string>;
}
//# sourceMappingURL=retroarch.d.ts.map