import { type FidelityGateOptions, type FidelityGateResult } from "@slowcook-ai/gates";
import type { EyeContext } from "./plan.js";
export interface RunEyeOptions {
    referenceUrl: string;
    candidateUrl: string;
    matrix: EyeContext[];
    /** Directory for screenshots. Files named `<label>-<viewport>-<scheme>[-<locale>].png`. */
    outDir: string;
    gate?: FidelityGateOptions;
    /** Screenshot filename prefix (e.g. `eye-pr-123`); default none. */
    shotPrefix?: string;
    /**
     * design §4 — shared-fixture scenario, appended as `?scenario=<name>` to BOTH
     * sides so the mock's mock-data layer + the candidate's dev-only data adaptor
     * render the SAME data → only real UI drift, no data noise.
     */
    scenario?: string;
}
/**
 * Pure: build the per-cell URL by merging the §6 locale (`lang=`) and §4
 * scenario (`scenario=`) query params into `url`, preserving any params already
 * present (e.g. `?__preview=1`). Applied identically to reference + candidate so
 * both render the same locale/fixture. Returns `url` unchanged when neither
 * applies and the URL has no params to normalise.
 */
export declare function withEyeParams(url: string, ctx: EyeContext, scenario?: string): string;
/** Pure: screenshot/label suffix for a cell — locale appended only when present. */
export declare function cellLabel(ctx: EyeContext): string;
export interface RunEyeResult {
    result: FidelityGateResult;
    screenshots: string[];
}
/** Render + grade the full matrix. Launches one browser, a fresh context per cell. */
export declare function runEyeMatrix(opts: RunEyeOptions): Promise<RunEyeResult>;
/** Pure: one-line pass summary for the watch loop (`violations: N → M (Δ)`). */
export declare function formatPassLine(pass: number, prevTotal: number | null, result: FidelityGateResult): string;
export interface WatchEyeOptions extends RunEyeOptions {
    intervalMs: number;
    untilConverged: boolean;
    maxPasses: number;
    /** Injectable for tests/logging; defaults to console.log. */
    log?: (msg: string) => void;
}
export interface WatchEyeResult {
    result: FidelityGateResult;
    passes: number;
    converged: boolean;
}
/**
 * sc#189 — warm-browser HMR re-eye loop. Captures the reference (static mock)
 * ONCE per cell, keeps a warm candidate page per cell, and re-captures ONLY the
 * candidate each pass (a `reload()` picks up HMR edits with no rebuild). Prints
 * the per-axis violation delta each pass; with `untilConverged`, exits as soon
 * as the gate passes. Bounded by `maxPasses`. The warm browser + reference-once
 * capture is the win over re-running one-shot `eye` per iteration.
 */
export declare function runEyeWatch(opts: WatchEyeOptions): Promise<WatchEyeResult>;
//# sourceMappingURL=run.d.ts.map