import { type Browser, type BrowserContext, type Page } from "@playwright/test";
export interface LiveBrowser {
    browser: Browser;
    context: BrowserContext;
    page: Page;
}
/** Launch headless chromium for a live-dashboard capture. Uses the nix-provided
 *  chromium (BROWSER_FOR_TESTING) so no Playwright browser download is needed;
 *  --no-sandbox because the nix chromium has no setuid sandbox helper. */
export declare function launchLiveBrowser(opts?: {
    viewport?: {
        width: number;
        height: number;
    };
    /** Default: captureScaleFactor() -- 2 in a DOCS_GENERATE run, 1 otherwise. */
    deviceScaleFactor?: number;
}): Promise<LiveBrowser>;