import type { UxAuditReport } from "../ux/tenets-traps.js";
export type UiFixCategory = "tokens" | "accessibility" | "components" | "responsive" | "code-health";
export type UiFixRisk = "safe" | "review" | "manual";
export interface UiFixOperation {
    type: "replace" | "insert" | "annotate" | "extract-token";
    file: string;
    description: string;
    search?: string;
    replacement?: string;
    line?: number;
}
export interface UiFixPatch {
    id: string;
    title: string;
    category: UiFixCategory;
    risk: UiFixRisk;
    confidence: number;
    affectedFiles: string[];
    rationale: string;
    operations: UiFixOperation[];
    writeSafe: boolean;
}
export interface UiFixPlan {
    version: 1;
    generatedAt: string;
    target: string;
    summary: {
        patchCount: number;
        safePatchCount: number;
        reviewPatchCount: number;
        manualPatchCount: number;
    };
    ux: UxAuditReport;
    patches: UiFixPatch[];
    caveats: string[];
}
export interface BuildUiFixPlanOptions {
    projectRoot: string;
    target?: string;
    maxFiles?: number;
    write?: boolean;
}
export interface ApplyUiFixOptions extends BuildUiFixPlanOptions {
    yes?: boolean;
}
export interface ApplyUiFixResult {
    status: "applied" | "blocked" | "noop";
    appliedPatches: string[];
    skippedPatches: string[];
    filesChanged: string[];
    plan: UiFixPlan;
}
export declare function buildUiFixPlan(options: BuildUiFixPlanOptions): Promise<UiFixPlan>;
export declare function applyUiFixPlan(options: ApplyUiFixOptions): Promise<ApplyUiFixResult>;
export declare function addMissingAltPlaceholders(content: string): string;