/**
 * Register (or override) named sound samples. Later registrations win, so a
 * host can replace individual sounds; unknown names simply no-op on play.
 */
export declare const registerSounds: (map: Record<string, string>) => void;
export declare const getVolume: () => number;
export declare const setVolume: (vol: number) => void;
export declare const getMuted: () => boolean;
export declare const setMuted: (muted: boolean) => void;
export declare const sounds: {
    startup(): void;
    shutdown(): void;
    logon(): void;
    logoff(): void;
    criticalStop(): void;
    error(): void;
    ding(): void;
    exclamation(): void;
    notify(): void;
    menuCommand(): void;
    minimize(): void;
    restore(): void;
    recycle(): void;
    windowOpen(): void;
    qqKnock(): void;
    qqMessage(): void;
    qqOnline(): void;
    qqSystem(): void;
};
/** Play a named system sound by key (used by the imperative XPHandle). */
export declare const playSound: (name: keyof typeof sounds) => void;
/**
 * Play a custom audio file by URL, honoring the global volume + mute state
 * (#139 branded startup sound). No-ops when muted.
 */
export declare const playCustomSound: (url: string) => void;