export type CleanCategory = "vite-cache" | "nitro-cache" | "build-output" | "deploy-artifacts";
export interface CleanTarget {
    category: CleanCategory;
    path: string;
    realPath: string;
    dev: number;
    ino: number;
    bytes: number;
}
export interface CleanFailure {
    path: string;
    message: string;
    remainingBytes?: number;
}
export interface CleanCategoryTotals {
    found: number;
    reclaimed: number;
    count: number;
}
export interface CleanReport {
    root: string;
    scope: "workspace" | "app";
    applied: boolean;
    targets: CleanTarget[];
    failures: CleanFailure[];
    bytesFound: number;
    bytesReclaimed: number;
    byCategory: Partial<Record<CleanCategory, CleanCategoryTotals>>;
}
export declare function formatBytes(bytes: number): string;
export declare function isSafeTarget(root: string, target: string): boolean;
export interface ScanCleanOptions {
    root: string;
    builds?: boolean;
}
export interface CleanScan {
    scope: "workspace" | "app";
    realRoot: string;
    targets: CleanTarget[];
    failures: CleanFailure[];
}
export declare function scanCleanTargets(options: ScanCleanOptions): CleanScan;
export interface PerformCleanOptions extends ScanCleanOptions {
    apply?: boolean;
}
export declare function performClean(options: PerformCleanOptions): CleanReport;
export interface CleanIo {
    log: (message: string) => void;
    err: (message: string) => void;
}
export interface CleanCliOptions {
    cwd?: string;
    apply?: boolean;
    dryRun?: boolean;
    builds?: boolean;
    json?: boolean;
    help?: boolean;
    error?: string;
}
export declare function parseCleanArgs(argv: string[]): CleanCliOptions;
export declare function printCleanHelp(io?: Pick<CleanIo, "log">): void;
export declare function runClean(argv: string[], io?: CleanIo): Promise<number>;