/**
 * Minimal terminal spinner with an elapsed-time readout.
 *
 * Renders `⠙ <label>… (3s)` on a single line via carriage-return redraw, in the
 * style of Claude Code's live status. Built for awaiting a single async op
 * (e.g. polling on-chain authorization during login).
 *
 * Footgun-safe by design:
 *  - the redraw interval is .unref()'d, so it never keeps the Node event loop
 *    alive — callers that process.exit() still exit cleanly.
 *  - stop() is idempotent and always clears the interval.
 *  - in a non-TTY (CI / piped output) it prints one static line and no \r
 *    animation, so logs stay clean.
 */
interface Spinner {
    /** Stop the spinner, clear the line, and optionally print a final line. */
    stop(finalLine?: string): void;
}
declare function startSpinner(label: string, stream?: NodeJS.WriteStream): Spinner;

export { type Spinner, startSpinner };