interface CodemodContext {
    bundler?: "vite" | "wrangler";
    configPath?: string;
    cwd: string;
    dryRun: boolean;
    files?: string[];
    force?: boolean;
    installDependencies?: boolean;
}
interface CodemodFollowUp {
    blocking: boolean;
    docsUrl?: string;
    message: string;
    sourcePath?: string;
}
interface CodemodResult {
    changedFiles: string[];
    followUps?: CodemodFollowUp[];
    message?: string;
    requiresInstall?: boolean;
    status?: "complete" | "needs-intervention" | "skipped";
}

/**
 * Runs a named codemod and writes its staged outputs unless this is a dry run.
 *
 * @param name Codemod name or alias.
 * @param context Working directory, dry-run mode, optional file restrictions, and safety override.
 * @returns The files changed by the codemod.
 */
declare function runCodemod(name: string, context: CodemodContext): Promise<CodemodResult>;

type MigrationBundler = "vite" | "wrangler";
interface WranglerToCfMigrationOptions {
    bundler?: MigrationBundler;
    dryRun?: boolean;
    force?: boolean;
    /** Whether to install cf and install or upgrade Vite plugin and Wrangler dependencies when needed. Required dependency changes become blocking follow-ups when false. */
    installDependencies?: boolean;
}
interface MigrationFollowUp {
    blocking: boolean;
    code: string;
    docsUrl?: string;
    message: string;
    sourcePath?: string;
}
interface WranglerToCfMigrationResult {
    changedFiles: string[];
    followUps: MigrationFollowUp[];
    requiresInstall: boolean;
    status: "complete" | "needs-intervention";
}

/**
 * Migrates one exact Wrangler configuration file to the new cf configuration.
 *
 * @param configPath Path to a Wrangler JSON, JSONC, or TOML configuration file.
 * @param options Optional bundler selection and write-safety controls.
 *
 * @returns Generated file paths and any follow-up work left for the caller.
 */
declare function migrateWranglerToCf(configPath: string, options?: WranglerToCfMigrationOptions): Promise<WranglerToCfMigrationResult>;

export { type CodemodContext, type CodemodResult, type MigrationFollowUp, type WranglerToCfMigrationOptions, type WranglerToCfMigrationResult, migrateWranglerToCf, runCodemod };