"--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;

const hasCorepackDownloadPromptSetting = Boolean(

sourceEnv.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim(),

);

const missingPosixScriptShell =

Boolean(resolvePosixNpmScriptShell(sourceEnv)) && !hasNpmScriptShellSetting(sourceEnv);

const requiresMergedEnv =

pathPrepend.length > 0 || process.platform === "win32" || !hasCorepackDownloadPromptSetting;

pathPrepend.length > 0 ||

process.platform === "win32" ||

!hasCorepackDownloadPromptSetting ||

missingPosixScriptShell;

if (!requiresMergedEnv) {

return env;

}

applyPathPrepend(merged, pathPrepend);

applyWindowsPackageInstallEnv(merged);

applyCorepackDownloadPromptEnv(merged);

applyPosixNpmScriptShellEnv(merged);

return merged;

}