/**
 * Migration unit registry — auto-discovery from the file system.
 *
 * Units are discovered by scanning the `units/` directory for numbered
 * subdirectories (each representing a major version). Every `.ts` / `.js`
 * file inside a major directory that exports a `unit` constant is
 * registered automatically.
 *
 *     units/
 *       0/            ← major 0 (examples / disabled units)
 *         example.ts
 *       3/            ← major 3
 *         remove-dropdown-value-generic.ts
 *
 * @module migrate/registry
 */
import type { ResolvedMigrationUnit } from './types.js';
/**
 * Discover migration units from the `units/<major>/` directory structure.
 *
 * @param basePath - Root `units/` directory to scan. Defaults to the
 *                   co-located `./units` directory next to this module.
 * @returns All discovered units, sorted by major then ID.
 */
export declare function discoverMigrationUnits(basePath?: string): Promise<ResolvedMigrationUnit[]>;
/**
 * Get migration units matching optional filter criteria.
 *
 * By default only enabled units are returned. Set `includeDisabled: true`
 * to include disabled units (useful for tooling / debugging).
 *
 * @param options.major           - Filter by target major version
 * @param options.id              - Filter by exact unit ID
 * @param options.includeDisabled - Include units with `enabled: false`
 * @param options.basePath        - Override the units directory (for tests)
 * @returns Filtered array of resolved migration units
 */
export declare function getMigrationUnits(options?: {
    major?: number;
    id?: string;
    includeDisabled?: boolean;
    basePath?: string;
}): Promise<ResolvedMigrationUnit[]>;