import type { LibraryReport } from './libraries-types.js';
export type ScanLibrariesOptions = {
    projectRoot: string;
};
/**
 * Parse the major version from a semver-ish spec.
 *
 * Handles the common shapes:
 *   "^5.18.0"      → 5
 *   "~1.2.3"       → 1
 *   "1.2.3"        → 1
 *   ">=1.0.0"      → 1
 *   "5"            → 5
 *   "5.x"          → 5
 *
 * Returns null for non-semver specs that the LLM should not assume a
 * major for:
 *   "workspace:*"  → null
 *   "file:../..."   → null
 *   "git+https..." → null
 *   "npm:@scope/x@1" → 1 (alias spec, we extract what we can)
 */
export declare function parseMajorVersion(spec: string): number | null;
export declare function scanLibraries(options: ScanLibrariesOptions): Promise<LibraryReport>;