import type { UpdateReference } from './types/types';
/**
 * Starts a latest package versions check if not already running.
 * This function returns immediately (fire-and-forget pattern).
 * The check runs in the background and results can be retrieved later via getLatestPackageVersionsCheck.
 *
 * @param root - The project root path
 *
 * @example
 * ```ts
 * // Start the check early (don't wait)
 * startLatestPackageVersionsCheck(cwd);
 *
 * // Later, get the results
 * const updates = await getLatestPackageVersionsCheck(cwd);
 * ```
 */
export declare function startLatestPackageVersionsCheck(root: string): void;
/**
 * Gets the latest package versions check promise.
 * If no check is running, starts one automatically.
 * This function should be awaited to get the actual results.
 *
 * @param root - The project root path
 * @returns Promise that resolves to update references
 *
 * @example
 * ```ts
 * const updateReferences = await getLatestPackageVersionsCheck(cwd);
 * ```
 */
export declare function getLatestPackageVersionsCheck(root: string): Promise<Record<string, UpdateReference>>;
/**
 * Clears the latest package versions cache.
 * Useful for testing or when you want to force a fresh check.
 */
export declare function clearLatestPackageVersionsCache(): void;