/** A file map: relative path -> file contents. */
export type AppFileMap = Record<string, string>;
export interface AppMigration {
    /** Unique migration id, e.g. "app-api-v0.2". Referenced by compat policy. */
    id: string;
    /** Human range this migration upgrades from, e.g. "<0.2". */
    appliesTo: string;
    /** What the migration does. */
    description: string;
    /** Globs the migration may edit, for dry-run summaries. */
    files: string[];
    /** Pure transform: returns only the files it changed or added. */
    run(files: AppFileMap): AppFileMap;
}
export declare const APP_MIGRATIONS: AppMigration[];
/** Look up a migration by id. */
export declare function getAppMigration(id: string): AppMigration | undefined;
/** Add the `@kazzle/app` dependency to an app package.json string. */
export declare function addPackageDependency(pkgJson: string, version: string): string;