export const PACKAGE_INSTALL_GUARD_RELATIVE_PATH: string;
/** Checks a Node version against the standalone package engine-range subset. */
export function nodeVersionSatisfiesPackageEngine(
  version: string | null,
  engine: string | null,
): boolean;
/** Reads the Node runtime contract from the package being installed. */
export function readPackageNodeEngine(packageJsonUrl?: URL): string | null;
export type PackageCliNodeRuntime = {
  version: string | null;
  bunVersion: string | null;
  execPath: string | null;
};
/** Finds the real Node that will launch the installed CLI after Bun removes its lifecycle PATH. */
export function probePackageCliNodeRuntime(options?: {
  env?: NodeJS.ProcessEnv;
  pathEnv?: string;
  platform?: NodeJS.Platform;
  cwd?: string;
  run?: (
    command: string,
    args: string[],
    options: {
      cwd: string;
      encoding: "utf8";
      env: NodeJS.ProcessEnv;
      timeout: number;
      windowsHide: boolean;
    },
  ) => {
    status?: number | null;
    stdout?: string;
    error?: NodeJS.ErrnoException;
  };
}): PackageCliNodeRuntime | null;
/** Rejects installation before an unsupported runtime can replace a working release. */
export function enforceSupportedNodeRuntime(
  options?: {
    version?: string | null;
    bunVersion?: string | null;
    engine?: string | null;
    execPath?: string | null;
    probeNodeRuntime?: () => PackageCliNodeRuntime | null;
  },
  reportError?: (...data: unknown[]) => void,
): boolean;
/** Removes the packed sentinel only after the runtime check succeeds. */
export function completePackageInstallGuard(
  options?: {
    markerUrl?: URL;
    remove?: (path: URL, options: { force: boolean }) => void;
  },
  reportError?: (...data: unknown[]) => void,
): boolean;
/**
 * Detects the package manager running the current lifecycle script.
 */
export function detectLifecyclePackageManager(env?: NodeJS.ProcessEnv): string | null;
/**
 * Builds the warning shown for non-pnpm lifecycle installs.
 */
export function createPackageManagerWarningMessage(packageManager: unknown): string | null;
/**
 * Emits the non-pnpm lifecycle warning when needed.
 */
export function warnIfNonPnpmLifecycle(
  env?: NodeJS.ProcessEnv,
  warn?: (...data: unknown[]) => void,
): boolean;