import { type CommandResult, type RunCommandOptions } from "./platform/command.js";
type CommandRunner = (command: string, args: string[], options?: Omit<RunCommandOptions, "onOutput">) => Promise<CommandResult>;
export interface NpmInstallPreflightOptions {
    npmCommand: string;
    nodePath: string;
    packageName: string;
    packageSpec: string;
    expectedVersion: string;
    cwd: string;
    env: NodeJS.ProcessEnv;
    timeoutMs: number;
    platform?: NodeJS.Platform;
    run?: CommandRunner;
}
export interface VerifyInstalledPackageOptions {
    packageRoot: string;
    nodePath: string;
    packageName: string;
    expectedVersion: string;
    cwd: string;
    env: NodeJS.ProcessEnv;
    run?: CommandRunner;
}
/**
 * Install the candidate under a disposable npm prefix and verify both the CLI
 * entry and native dependency before the real global installation is touched.
 */
export declare function preflightGlobalNpmInstall(options: NpmInstallPreflightOptions): Promise<void>;
export declare function verifyInstalledPackage(options: VerifyInstalledPackageOptions): Promise<void>;
export declare function resolveGlobalPackageRoot(prefix: string, packageName: string, platform?: NodeJS.Platform): string;
export {};