import { BUNDLED_RUNTIME_SIDECAR_PATHS } from "../plugins/runtime-sidecar-paths.js";

import { normalizeLowercaseStringOrEmpty } from "../shared/string-coerce.js";

import { pathExists } from "../utils.js";

import {

applyPosixNpmScriptShellEnv,

hasNpmScriptShellSetting,

resolvePosixNpmScriptShell,

} from "./npm-install-env.js";

import {

collectPackageDistInventory,

PACKAGE_DIST_INVENTORY_RELATIVE_PATH,

"--omit=optional",

...NPM_GLOBAL_INSTALL_QUIET_FLAGS,

] as const;

const NPM_CONFIG_SCRIPT_SHELL_KEYS = ["NPM_CONFIG_SCRIPT_SHELL", "npm_config_script_shell"];

const FIRST_PACKAGED_DIST_INVENTORY_VERSION = { major: 2026, minor: 4, patch: 15 };

const OMITTED_PRIVATE_QA_BUNDLED_PLUGIN_ROOTS = new Set([

"dist/extensions/qa-channel",

}

}

function hasNpmScriptShellSetting(env: NodeJS.ProcessEnv): boolean {

return NPM_CONFIG_SCRIPT_SHELL_KEYS.some((key) => Boolean(env[key]?.trim()));

}

function resolvePosixNpmScriptShell(env: NodeJS.ProcessEnv): string | null {

if (process.platform === "win32") {

return null;

}

if (fsSync.existsSync("/bin/sh")) {

return "/bin/sh";

}

const shell = env.SHELL?.trim();

return shell && path.isAbsolute(shell) && fsSync.existsSync(shell) ? shell : null;

}

function applyPosixNpmScriptShellEnv(env: Record<string, string>) {

if (hasNpmScriptShellSetting(env)) {

return;

}

const scriptShell = resolvePosixNpmScriptShell(env);

if (scriptShell) {

env.NPM_CONFIG_SCRIPT_SHELL = scriptShell;

}

}

export function resolveGlobalInstallSpec(params: {

packageName: string;

tag: string;