import { MigrationFrontmatter } from "./outfitter-y37yfehn.js";
/** A migration doc with parsed frontmatter and body content. */
interface MigrationDocWithMetadata {
	readonly body: string;
	readonly frontmatter: MigrationFrontmatter;
	readonly version: string;
}
/**
* Find migration docs directory, checking known locations.
*
* Searches:
* 1. Relative to the target cwd
* 2. Walking up parent directories from cwd (monorepo root detection)
* 3. Relative to the outfitter binary itself (development mode)
*/
declare function findMigrationDocsDir(cwd: string, binaryDir?: string): string | null;
/**
* Read all migration docs for a package between two versions.
*
* Scans the migrations directory for docs matching the package name,
* filters to versions greater than `fromVersion` and at most `toVersion`,
* and returns their contents sorted by version ascending.
*/
declare function readMigrationDocs(migrationsDir: string, shortName: string, fromVersion: string, toVersion: string): string[];
/**
* Read the `breaking` flag for an exact migration doc version, if present.
*
* Returns:
* - `true` or `false` when the frontmatter contains `breaking: ...`
* - `undefined` when the doc is missing, unreadable, or has no valid flag
*/
declare function readMigrationBreakingFlag(migrationsDir: string, shortName: string, version: string): boolean | undefined;
/**
* Read all migration docs for a package between two versions,
* returning parsed frontmatter alongside the body content.
*
* Like `readMigrationDocs` but returns structured metadata instead of
* plain strings. Used by the codemod infrastructure to discover
* machine-actionable changes.
*/
declare function readMigrationDocsWithMetadata(migrationsDir: string, shortName: string, fromVersion: string, toVersion: string): MigrationDocWithMetadata[];
export { MigrationDocWithMetadata, findMigrationDocsDir, readMigrationDocs, readMigrationBreakingFlag, readMigrationDocsWithMetadata };