@vltpkg/run 1.0.0-rc.9 → 1.0.2

package/dist/{esm/index.d.ts → index.d.ts}

@@ -1,6 +1,12 @@
 import { PackageJson } from '@vltpkg/package-json';
 import type { PromiseSpawnOptions, SpawnResultNoStdio, SpawnResultStdioStrings } from '@vltpkg/promise-spawn';
 import type { Manifest } from '@vltpkg/types';
+export * from './node-gyp.ts';
+/**
+ * The user agent string set as `npm_config_user_agent` in lifecycle script
+ * environments. Follows the conventional format used by package managers.
+ */
+export declare const npmConfigUserAgent: string;
 /** options shared by run() and exec() */
 export type SharedOptions = PromiseSpawnOptions & {
     /** additional arguments to pass to the command */
@@ -127,5 +133,3 @@ export declare const runExec: (options: RunExecOptions) => Promise<RunResult | S
  * execFG()
  */
 export declare const runExecFG: (options: RunExecOptions) => Promise<RunFGResult | SpawnResultNoStdio>;
-export { getNodeGypShim, getNodeGypShimDir, hasNodeGypReference, } from './aliasRunner.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/{esm/index.js → index.js}

@@ -6,7 +6,14 @@ import { proxySignals } from 'foreground-child/proxy-signals';
 import { statSync } from 'node:fs';
 import { delimiter, resolve, sep } from 'node:path';
 import { walkUp } from 'walk-up-path';
-import { getNodeGypShimDir, hasNodeGypReference, } from "./aliasRunner.js";
+import { getNodeGypShimDir, hasNodeGypReference, hasNodeGypBinding, } from "./node-gyp.js";
+// Re-export all named exports from node-gyp.ts
+export * from "./node-gyp.js";
+/**
+ * The user agent string set as `npm_config_user_agent` in lifecycle script
+ * environments. Follows the conventional format used by package managers.
+ */
+export const npmConfigUserAgent = `vlt/${process.version.slice(1)} node/${process.version} ${process.platform} ${process.arch}`;
 /** map of which node_modules/.bin folders exist */
 const dotBins = new Map();
 /** Check if a directory exists, and cache result */
@@ -102,21 +109,47 @@ const runImpl = async (options, execImpl, empty) => {
     const pj = (untrustworthy ? undefined : manifest) ??
         packageJson.read(options.cwd);
     const { scripts } = pj;
-    const command = scripts?.[arg0];
-    if (!command) {
+    const command = scripts?.[arg0] ??
+        // npm's implicit install behavior: "If there is a binding.gyp file in the
+        // root of your package and you haven't defined your own install or preinstall
+        // scripts, npm will default the install command to compile using node-gyp
+        // via node-gyp rebuild"
+        ((arg0 === 'install' &&
+            !scripts?.install &&
+            !scripts?.preinstall &&
+            hasNodeGypBinding(options.cwd)) ?
+            'node-gyp rebuild'
+            : undefined);
+    // Check for pre/post commands even if main command doesn't exist for cases
+    // like packages that have only a preinstall or postinstall script.
+    const precommand = !options.ignorePrePost && scripts?.[`pre${arg0}`];
+    const postcommand = !options.ignorePrePost && scripts?.[`post${arg0}`];
+    const emptyResult = () => ({
+        command: '',
+        args: execArgs.args ?? [],
+        cwd: options.cwd,
+        status: 0,
+        signal: null,
+        stdout: empty,
+        stderr: empty,
+    });
+    const execCommand = (command, preOrPost) => execImpl({
+        arg0: command,
+        ...execArgs,
+        'script-shell': shell,
+        // pre/post scripts always have empty args, main script uses execArgs.args
+        args: preOrPost ? [] : (execArgs.args ?? []),
+        env: {
+            ...execArgs.env,
+            npm_config_user_agent: npmConfigUserAgent,
+            npm_package_json: pjPath,
+            npm_lifecycle_event: `${preOrPost ?? ''}${arg0}`,
+            npm_lifecycle_script: command,
+        },
+    });
+    if (!command && !precommand && !postcommand) {
         if (ignoreMissing) {
-            return {
-                command: '',
-                /* c8 ignore next */
-                args: execArgs.args ?? [],
-                cwd: options.cwd,
-                status: 0,
-                signal: null,
-                stdout: empty,
-                stderr: empty,
-                // `as` to workaround "could be instantiated with arbitrary type".
-                // it's private and used in 2 places, we know that it isn't.
-            };
+            return emptyResult();
         }
         throw error('Script not defined in package.json', {
             name: arg0,
@@ -126,67 +159,71 @@ const runImpl = async (options, execImpl, empty) => {
             manifest: pj,
         });
     }
-    const precommand = !options.ignorePrePost && scripts[`pre${arg0}`];
-    const pre = precommand ?
-        await execImpl({
-            arg0: precommand,
-            ...execArgs,
-            'script-shell': shell,
-            args: [],
-            env: {
-                ...execArgs.env,
-                npm_package_json: pjPath,
-                npm_lifecycle_event: `pre${arg0}`,
-                npm_lifecycle_script: precommand,
-            },
-        })
-        : undefined;
-    if (pre && (pre.status || pre.signal)) {
-        return pre;
+    const pre = precommand ? await execCommand(precommand, 'pre') : undefined;
+    if (pre?.status || pre?.signal) {
+        return {
+            ...pre,
+        };
     }
-    const result = await execImpl({
-        arg0: command,
-        ...execArgs,
-        'script-shell': shell,
-        env: {
-            ...execArgs.env,
-            npm_package_json: pjPath,
-            npm_lifecycle_event: arg0,
-            npm_lifecycle_script: command,
-        },
-    });
-    result.pre = pre;
-    if (result.signal || result.status) {
-        return result;
+    const main = command ? await execCommand(command) : emptyResult();
+    if (main.signal || main.status) {
+        return {
+            ...main,
+            ...(pre ? { pre } : {}),
+        };
     }
-    const postcommand = !options.ignorePrePost && scripts[`post${arg0}`];
-    if (!postcommand)
-        return result;
-    const post = await execImpl({
-        arg0: postcommand,
-        ...execArgs,
-        'script-shell': shell,
-        args: [],
-        env: {
-            ...execArgs.env,
-            npm_package_json: pjPath,
-            npm_lifecycle_event: `post${arg0}`,
-            npm_lifecycle_script: postcommand,
-        },
-    });
-    if (post.status || post.signal) {
-        const { status, signal } = post;
-        return Object.assign(result, { post, status, signal });
+    const post = postcommand ? await execCommand(postcommand, 'post') : undefined;
+    if (post?.signal || post?.status) {
+        return {
+            ...main,
+            ...(pre ? { pre } : {}),
+            post,
+            signal: post.signal,
+            status: post.status,
+        };
     }
-    result.post = post;
-    return result;
+    return {
+        ...main,
+        ...(pre ? { pre } : {}),
+        ...(post ? { post } : {}),
+    };
+};
+/**
+ * Escapes a string for safe inclusion in a POSIX shell command.
+ * Wraps in single quotes and escapes any embedded single quotes.
+ */
+const shellEscape = (s) => `'${s.replace(/'/g, "'\\''")}'`;
+const isPosixShell = (shell) => {
+    if (typeof shell === 'string')
+        return !/(^|\\)cmd\.exe$/i.test(shell);
+    return process.platform !== 'win32';
+};
+/**
+ * When running through a POSIX shell, Node.js joins `spawn(cmd, args)`
+ * into a single string without escaping (DEP0190). This means
+ * characters like `#` are interpreted as shell comments, silently
+ * swallowing the rest of the command line.
+ *
+ * Fix: append shell-escaped args directly to the command string
+ * so the script is still shell-interpreted but args are passed
+ * literally.
+ *
+ * On Windows with cmd.exe, these characters are not special, so
+ * we leave args as-is to avoid injecting POSIX quotes that cmd.exe
+ * would pass through literally.
+ */
+const withShellArgs = (shell, arg0, args) => {
+    if (!shell || args.length === 0 || !isPosixShell(shell))
+        return [arg0, args];
+    return [`${arg0} ${args.map(shellEscape).join(' ')}`, []];
 };
 /**
  * Execute an arbitrary command in the background
  */
 export const exec = async (options) => {
     const { arg0, args = [], cwd, env = {}, projectRoot, 'script-shell': shell = false, color = false, signal, ...spawnOptions } = options;
-    const p = promiseSpawn(arg0, args, {
+    const [spawnCmd, spawnArgs] = withShellArgs(shell, arg0, args);
+    const p = promiseSpawn(spawnCmd, spawnArgs, {
         ...spawnOptions,
         shell,
         stdio: 'pipe',
@@ -195,7 +232,7 @@ export const exec = async (options) => {
         env: await addPaths(projectRoot, cwd, {
             ...process.env,
             ...env,
-            FORCE_COLOR: color ? '1' : '0',
+            FORCE_COLOR: color && process.stdout.isTTY ? '1' : '0',
         }, arg0),
         windowsHide: true,
     });
@@ -207,13 +244,14 @@ export const exec = async (options) => {
  */
 export const execFG = async (options) => {
     const { arg0, args = [], cwd, projectRoot, env = {}, 'script-shell': shell = false, color = true, signal, ...spawnOptions } = options;
+    const [spawnCmd, spawnArgs] = withShellArgs(shell, arg0, args);
     const processEnv = await addPaths(projectRoot, cwd, {
         ...process.env,
         ...env,
         FORCE_COLOR: color ? '1' : '0',
     }, arg0);
     return new Promise(res => {
-        foregroundChild(arg0, args, {
+        foregroundChild(spawnCmd, spawnArgs, {
             ...spawnOptions,
             shell,
             cwd,
@@ -253,6 +291,3 @@ export const runExec = async (options) => runExecImpl(options, run, exec);
  * execFG()
  */
 export const runExecFG = async (options) => runExecImpl(options, runFG, execFG);
-// Export shim utilities
-export { getNodeGypShim, getNodeGypShimDir, hasNodeGypReference, } from "./aliasRunner.js";
-//# sourceMappingURL=index.js.map

package/dist/{esm/aliasRunner.d.ts → node-gyp.d.ts}

@@ -12,4 +12,7 @@ export declare function getNodeGypShimDir(): Promise<string>;
  * Check if a command contains node-gyp references
  */
 export declare function hasNodeGypReference(command: string): boolean;
-//# sourceMappingURL=aliasRunner.d.ts.map
+/**
+ * Check if a binding.gyp file exists
+ */
+export declare function hasNodeGypBinding(cwd: string): boolean;

package/dist/{esm/aliasRunner.js → node-gyp.js}

@@ -1,4 +1,5 @@
 import { XDG } from '@vltpkg/xdg';
+import { statSync } from 'node:fs';
 import { chmod, mkdir, stat, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 const xdg = new XDG('vlt');
@@ -27,8 +28,8 @@ export async function getNodeGypShim() {
     // Create shim that calls vlx
     /* c8 ignore start - ignore platform-dependent coverage */
     const shimContent = process.platform === 'win32' ?
-        `@echo off\nvlx node-gyp@latest %*\n`
-        : `#!/bin/sh\nexec vlx node-gyp@latest "$@"\n`;
+        `@echo off\nvlx --yes node-gyp@latest %*\n`
+        : `#!/bin/sh\nexec vlx --yes node-gyp@latest "$@"\n`;
     /* c8 ignore stop */
     await writeFile(shimFile, shimContent, 'utf8');
     // Make executable on Unix systems
@@ -54,4 +55,14 @@ export async function getNodeGypShimDir() {
 export function hasNodeGypReference(command) {
     return command.includes('node-gyp');
 }
-//# sourceMappingURL=aliasRunner.js.map
+/**
+ * Check if a binding.gyp file exists
+ */
+export function hasNodeGypBinding(cwd) {
+    try {
+        return statSync(join(cwd, 'binding.gyp')).isFile();
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,75 +1,73 @@
 {
   "name": "@vltpkg/run",
   "description": "Run package.json scripts and execute commands",
-  "version": "1.0.0-rc.9",
+  "version": "1.0.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
     "directory": "src/run"
   },
-  "author": "vlt technology inc. <support@vlt.sh> (http://vlt.sh)",
-  "tshy": {
-    "selfLink": false,
-    "liveDev": true,
-    "dialects": [
-      "esm"
-    ],
-    "exports": {
-      "./package.json": "./package.json",
-      ".": "./src/index.ts"
-    }
+  "author": {
+    "name": "vlt technology inc.",
+    "email": "support@vlt.sh",
+    "url": "http://vlt.sh"
   },
   "dependencies": {
+    "@vltpkg/error-cause": "1.0.2",
+    "@vltpkg/package-json": "1.0.2",
+    "@vltpkg/promise-spawn": "1.0.2",
+    "@vltpkg/types": "1.0.2",
+    "@vltpkg/xdg": "1.0.2",
     "foreground-child": "^3.3.1",
-    "walk-up-path": "^4.0.0",
-    "@vltpkg/error-cause": "1.0.0-rc.9",
-    "@vltpkg/package-json": "1.0.0-rc.9",
-    "@vltpkg/promise-spawn": "1.0.0-rc.9",
-    "@vltpkg/types": "1.0.0-rc.9",
-    "@vltpkg/xdg": "1.0.0-rc.9"
+    "walk-up-path": "^4.0.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.34.0",
-    "@types/node": "^22.17.2",
-    "eslint": "^9.34.0",
-    "prettier": "^3.6.2",
-    "tap": "^21.1.0",
-    "tshy": "^3.0.2",
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^22.19.2",
+    "eslint": "^9.39.1",
+    "prettier": "^3.7.4",
+    "tap": "^21.5.0",
     "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.40.0"
+    "typescript-eslint": "^8.49.0"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {
-    "node": ">=22"
+    "node": ">=22.22.0"
+  },
+  "scripts": {
+    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
+    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "prepack": "tsc -p tsconfig.publish.json && ../../scripts/update-dist-exports.ts",
+    "snap": "tap",
+    "test": "tap",
+    "posttest": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
   },
   "tap": {
     "extends": "../../tap-config.yaml"
   },
   "prettier": "../../.prettierrc.js",
-  "module": "./dist/esm/index.js",
+  "module": "./dist/index.js",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
+        "default": "./dist/index.js"
       }
     }
   },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
-    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
-    "lint": "eslint . --fix",
-    "lint:check": "eslint .",
-    "snap": "tap",
-    "test": "tap",
-    "posttest": "tsc --noEmit",
-    "tshy": "tshy",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  "bugs": [
+    {
+      "type": "link",
+      "url": "https://github.com/vltpkg/vltpkg/issues"
+    }
+  ],
+  "homepage": "https://github.com/vltpkg/vltpkg/tree/main/src/run#readme"
+}

package/dist/esm/aliasRunner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aliasRunner.d.ts","sourceRoot":"","sources":["../../src/aliasRunner.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAsCtD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAGzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/esm/aliasRunner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"aliasRunner.js","sourceRoot":"","sources":["../../src/aliasRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;AAC1B,IAAI,QAA4B,CAAA;AAEhC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IAE7C,+BAA+B;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpB,qCAAqC;QACrC,QAAQ,GAAG,QAAQ,CAAA;QACnB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;IAED,qCAAqC;IACrC,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE5C,6BAA6B;IAC7B,0DAA0D;IAC1D,MAAM,WAAW,GACf,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QAC5B,qCAAqC;QACvC,CAAC,CAAC,4CAA4C,CAAA;IAChD,oBAAoB;IAEpB,MAAM,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IAE9C,kCAAkC;IAClC,iCAAiC;IACjC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC9B,CAAC;IACD,oBAAoB;IAEpB,QAAQ,GAAG,QAAQ,CAAA;IACnB,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAA;IACnC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AACrC,CAAC","sourcesContent":["import { XDG } from '@vltpkg/xdg'\nimport { chmod, mkdir, stat, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\n\nconst xdg = new XDG('vlt')\nlet shimPath: string | undefined\n\n/**\n * Get or create the node-gyp shim file path\n * The shim redirects node-gyp calls to vlx node-gyp@latest\n */\nexport async function getNodeGypShim(): Promise<string> {\n  if (shimPath) return shimPath\n\n  const runtimeDir = xdg.runtime('run')\n  const shimFile = join(runtimeDir, 'node-gyp')\n\n  // Check if shim already exists\n  try {\n    await stat(shimFile)\n    /* c8 ignore next 2 - hard to test */\n    shimPath = shimFile\n    return shimPath\n  } catch {\n    // Shim doesn't exist, create it\n  }\n\n  // Create runtime directory if needed\n  await mkdir(runtimeDir, { recursive: true })\n\n  // Create shim that calls vlx\n  /* c8 ignore start - ignore platform-dependent coverage */\n  const shimContent =\n    process.platform === 'win32' ?\n      `@echo off\\nvlx node-gyp@latest %*\\n`\n    : `#!/bin/sh\\nexec vlx node-gyp@latest \"$@\"\\n`\n  /* c8 ignore stop */\n\n  await writeFile(shimFile, shimContent, 'utf8')\n\n  // Make executable on Unix systems\n  /* c8 ignore start - unix-only */\n  if (process.platform !== 'win32') {\n    await chmod(shimFile, 0o755)\n  }\n  /* c8 ignore stop */\n\n  shimPath = shimFile\n  return shimPath\n}\n\n/**\n * Get the directory containing the node-gyp shim\n * This can be prepended to PATH to make the shim available\n */\nexport async function getNodeGypShimDir(): Promise<string> {\n  const shim = await getNodeGypShim()\n  return dirname(shim)\n}\n\n/**\n * Check if a command contains node-gyp references\n */\nexport function hasNodeGypReference(command: string): boolean {\n  return command.includes('node-gyp')\n}\n"]}

package/dist/esm/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { PackageJson } from '@vltpkg/package-json'\nimport type {\n  PromiseSpawnOptions,\n  SpawnResultNoStdio,\n  SpawnResultStdioStrings,\n} from '@vltpkg/promise-spawn'\nimport { promiseSpawn } from '@vltpkg/promise-spawn'\nimport type { Manifest } from '@vltpkg/types'\nimport { foregroundChild } from 'foreground-child'\nimport { proxySignals } from 'foreground-child/proxy-signals'\nimport { statSync } from 'node:fs'\nimport { delimiter, resolve, sep } from 'node:path'\nimport { walkUp } from 'walk-up-path'\nimport {\n  getNodeGypShimDir,\n  hasNodeGypReference,\n} from './aliasRunner.ts'\n\n/** map of which node_modules/.bin folders exist */\nconst dotBins = new Map<string, boolean>()\n\n/** Check if a directory exists, and cache result */\nconst dirExists = (p: string) => {\n  const cached = dotBins.get(p)\n  if (cached !== undefined) return cached\n  try {\n    const isDir = statSync(p).isDirectory()\n    dotBins.set(p, isDir)\n    return isDir\n  } catch {\n    dotBins.set(p, false)\n    return false\n  }\n}\n\nconst nmBin = `${sep}node_modules${sep}.bin`\n\n/**\n * Add all existing `node_modules/.bin` folders to the PATH that\n * exist between the cwd and the projectRoot, so dependency bins\n * are found, with closer paths higher priority.\n *\n * If command contains node-gyp reference, also inject the shim directory\n * as a fallback (after all existing PATH entries).\n */\nconst addPaths = async (\n  projectRoot: string,\n  cwd: string,\n  env: NodeJS.ProcessEnv,\n  command?: string,\n): Promise<NodeJS.ProcessEnv> => {\n  const { PATH = '' } = env\n  const PATHsplit = PATH.split(delimiter)\n  const paths = new Set<string>()\n\n  // anything in the PATH that already has node_modules/.bin is a thing\n  // we put there, perhaps for the vlx exec cache usage\n  for (const p of PATHsplit) {\n    if (p.endsWith(nmBin)) {\n      paths.add(p)\n    }\n  }\n  for (const p of walkUp(cwd)) {\n    const dotBin = resolve(p, 'node_modules/.bin')\n    if (dirExists(dotBin)) paths.add(dotBin)\n    if (p === projectRoot) break\n  }\n  for (const p of PATH.split(delimiter)) {\n    /* c8 ignore next - pretty rare to have an empty entry */\n    if (p) paths.add(p)\n  }\n\n  // If command has node-gyp, inject shim directory as fallback (last)\n  if (command && hasNodeGypReference(command)) {\n    try {\n      const shimDir = await getNodeGypShimDir()\n      paths.add(shimDir)\n      /* c8 ignore start */\n    } catch {\n      // Ignore shim creation errors, command will fail naturally if node-gyp is needed\n    }\n    /* c8 ignore stop */\n  }\n\n  env.PATH = [...paths].join(delimiter)\n  return env\n}\n\n/** options shared by run() and exec() */\nexport type SharedOptions = PromiseSpawnOptions & {\n  /** additional arguments to pass to the command */\n  args?: string[]\n  /** the root of the project, which we don't walk up past */\n  projectRoot: string\n\n  /** the directory where the package.json lives and the script runs */\n  cwd: string\n  /**\n   * environment variables to set. `process.env` is always included,\n   * to omit fields, set them explicitly to undefined.\n   *\n   * vlt will add some of its own, as well:\n   * - npm_lifecycle_event: the event name\n   * - npm_lifecycle_script: the command in package.json#scripts\n   * - npm_package_json: path to the package.json file\n   * - VLT_* envs for all vlt configuration values that are set\n   */\n  env?: NodeJS.ProcessEnv\n  /**\n   * the shell to run the script in. If not set, then the default\n   * platform-specific shell will be used.\n   */\n  'script-shell'?: boolean | string\n\n  /**\n   * If true, then `FORCE_COLOR=1` will be set in the environment so that\n   * scripts will typically have colored output enablled, even if the output\n   * is not a tty.\n   */\n  color?: boolean\n}\n\n/**\n * Options for run() and runFG()\n */\nexport type RunOptions = SharedOptions & {\n  /** the name of the thing in package.json#scripts */\n  arg0: string\n  /**\n   * pass in a @vltpkg/package-json.PackageJson instance, and\n   * it'll be used for reading the package.json file. Optional,\n   * may improve performance somewhat.\n   */\n  packageJson?: PackageJson\n\n  /**\n   * Pass in a manifest to avoid having to read it at all\n   */\n  manifest?: Pick<Manifest, 'scripts' | 'gypfile'>\n\n  /**\n   * if the script is not defined in package.json#scripts, just ignore it and\n   * treat as success. Otherwise, treat as an error. Default false.\n   */\n  ignoreMissing?: boolean\n\n  /**\n   * skip the pre/post commands, just run the one specified.\n   * This can be used to run JUST the specified script, without any\n   * pre/post commands.\n   */\n  ignorePrePost?: boolean\n}\n\n/**\n * Options for exec() and execFG()\n */\nexport type ExecOptions = SharedOptions & {\n  /** the command to execute */\n  arg0: string\n}\n\n/**\n * Options for runExec() and runExecFG()\n */\nexport type RunExecOptions = SharedOptions & {\n  /**\n   * Either the command to be executed, or the event to be run\n   */\n  arg0: string\n  /**\n   * pass in a @vltpkg/package-json.PackageJson instance, and\n   * it'll be used for reading the package.json file. Optional,\n   * may improve performance somewhat.\n   */\n  packageJson?: PackageJson\n}\n\n/**\n * Run a package.json#scripts event in the background\n */\nexport const run = async (options: RunOptions): Promise<RunResult> =>\n  runImpl(options, exec, '')\n\n/**\n * Run a package.json#scripts event in the foreground\n */\nexport const runFG = async (\n  options: RunOptions,\n): Promise<RunFGResult> => runImpl(options, execFG, null)\n\n/** Return type of {@link run} */\nexport type RunResult = SpawnResultStdioStrings & {\n  pre?: SpawnResultStdioStrings\n  post?: SpawnResultStdioStrings\n}\n\n/** Return type of {@link runFG} */\nexport type RunFGResult = SpawnResultNoStdio & {\n  pre?: SpawnResultNoStdio\n  post?: SpawnResultNoStdio\n}\n\nexport const isRunResult = (v: unknown): v is RunResult =>\n  !!v &&\n  typeof v === 'object' &&\n  !Array.isArray(v) &&\n  'stdout' in v &&\n  'stderr' in v &&\n  'status' in v &&\n  'signal' in v\n\n/**\n * Return type of {@link run} or {@link runFG}, as determined by their base\n * type\n * @internal\n */\nexport type RunImplResult<\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n> = R & { pre?: R; post?: R }\n\n/**\n * Internal implementation of run() and runFG(), since they're mostly identical\n */\nconst runImpl = async <\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n>(\n  options: RunOptions,\n  execImpl: (options: ExecOptions) => Promise<R>,\n  empty: R['stdout'],\n): Promise<RunImplResult<R>> => {\n  const {\n    arg0,\n    packageJson = new PackageJson(),\n    ignoreMissing = false,\n    manifest,\n    'script-shell': shell = true,\n    ...execArgs\n  } = options\n  const pjPath = resolve(options.cwd, 'package.json')\n  // npm adds a `\"install\": \"node-gyp rebuild\"` if a binding.gyp\n  // is present at the time of publish, EVEN IF it's not included\n  // in the package. So, we need to read the actual package.json\n  // in those cases.\n  const untrustworthy = !!(\n    manifest?.gypfile &&\n    arg0 === 'install' &&\n    manifest.scripts?.install === 'node-gyp rebuild'\n  )\n  const pj =\n    (untrustworthy ? undefined : manifest) ??\n    packageJson.read(options.cwd)\n  const { scripts } = pj\n  const command = scripts?.[arg0]\n  if (!command) {\n    if (ignoreMissing) {\n      return {\n        command: '',\n        /* c8 ignore next */\n        args: execArgs.args ?? [],\n        cwd: options.cwd,\n        status: 0,\n        signal: null,\n        stdout: empty,\n        stderr: empty,\n        // `as` to workaround \"could be instantiated with arbitrary type\".\n        // it's private and used in 2 places, we know that it isn't.\n      } as R\n    }\n    throw error('Script not defined in package.json', {\n      name: arg0,\n      cwd: options.cwd,\n      args: options.args,\n      path: pjPath,\n      manifest: pj,\n    })\n  }\n\n  const precommand = !options.ignorePrePost && scripts[`pre${arg0}`]\n  const pre =\n    precommand ?\n      await execImpl({\n        arg0: precommand,\n        ...execArgs,\n        'script-shell': shell,\n        args: [],\n        env: {\n          ...execArgs.env,\n          npm_package_json: pjPath,\n          npm_lifecycle_event: `pre${arg0}`,\n          npm_lifecycle_script: precommand,\n        },\n      })\n    : undefined\n  if (pre && (pre.status || pre.signal)) {\n    return pre as RunImplResult<R>\n  }\n  const result: RunImplResult<R> = await execImpl({\n    arg0: command,\n    ...execArgs,\n    'script-shell': shell,\n    env: {\n      ...execArgs.env,\n      npm_package_json: pjPath,\n      npm_lifecycle_event: arg0,\n      npm_lifecycle_script: command,\n    },\n  })\n  result.pre = pre\n  if (result.signal || result.status) {\n    return result\n  }\n\n  const postcommand = !options.ignorePrePost && scripts[`post${arg0}`]\n  if (!postcommand) return result\n\n  const post = await execImpl({\n    arg0: postcommand,\n    ...execArgs,\n    'script-shell': shell,\n    args: [],\n    env: {\n      ...execArgs.env,\n      npm_package_json: pjPath,\n      npm_lifecycle_event: `post${arg0}`,\n      npm_lifecycle_script: postcommand,\n    },\n  })\n\n  if (post.status || post.signal) {\n    const { status, signal } = post\n    return Object.assign(result, { post, status, signal })\n  }\n  result.post = post\n  return result\n}\n\n/**\n * Execute an arbitrary command in the background\n */\nexport const exec = async (\n  options: ExecOptions,\n): Promise<SpawnResultStdioStrings> => {\n  const {\n    arg0,\n    args = [],\n    cwd,\n    env = {},\n    projectRoot,\n    'script-shell': shell = false,\n    color = false,\n    signal,\n    ...spawnOptions\n  } = options\n\n  const p = promiseSpawn(arg0, args, {\n    ...spawnOptions,\n    shell,\n    stdio: 'pipe',\n    stdioString: true,\n    cwd,\n    env: await addPaths(\n      projectRoot,\n      cwd,\n      {\n        ...process.env,\n        ...env,\n        FORCE_COLOR: color ? '1' : '0',\n      },\n      arg0,\n    ),\n    windowsHide: true,\n  })\n  proxySignals(p.process)\n  return await p\n}\n\n/**\n * Execute an arbitrary command in the foreground\n */\nexport const execFG = async (\n  options: ExecOptions,\n): Promise<SpawnResultNoStdio> => {\n  const {\n    arg0,\n    args = [],\n    cwd,\n    projectRoot,\n    env = {},\n    'script-shell': shell = false,\n    color = true,\n    signal,\n    ...spawnOptions\n  } = options\n\n  const processEnv = await addPaths(\n    projectRoot,\n    cwd,\n    {\n      ...process.env,\n      ...env,\n      FORCE_COLOR: color ? '1' : '0',\n    },\n    arg0,\n  )\n\n  return new Promise<SpawnResultNoStdio>(res => {\n    foregroundChild(\n      arg0,\n      args,\n      {\n        ...spawnOptions,\n        shell,\n        cwd,\n        env: processEnv,\n      },\n      (status, signal) => {\n        res({\n          command: arg0,\n          args,\n          cwd,\n          stdout: null,\n          stderr: null,\n          status,\n          signal,\n        })\n        return false\n      },\n    )\n  })\n}\n\nconst runExecImpl = async <\n  R extends SpawnResultNoStdio | SpawnResultStdioStrings,\n>(\n  options: RunExecOptions,\n  runImpl: (options: RunOptions) => Promise<RunImplResult<R>>,\n  execImpl: (options: ExecOptions) => Promise<R>,\n): Promise<R | RunImplResult<R>> => {\n  const { arg0, packageJson = new PackageJson(), ...args } = options\n  const pj = packageJson.read(options.cwd)\n  const { scripts } = pj\n  const command = scripts?.[arg0]\n  if (command) {\n    return runImpl({ ...args, packageJson, arg0 })\n  } else {\n    return execImpl({ ...args, arg0 })\n  }\n}\n\n/**\n * If the arg0 is a defined package.json script, then run(), otherwise exec()\n */\nexport const runExec = async (\n  options: RunExecOptions,\n): Promise<RunResult | SpawnResultStdioStrings> =>\n  runExecImpl<SpawnResultStdioStrings>(options, run, exec)\n\n/**\n * If the arg0 is a defined package.json script, then runFG(), otherwise\n * execFG()\n */\nexport const runExecFG = async (\n  options: RunExecOptions,\n): Promise<RunFGResult | SpawnResultNoStdio> =>\n  runExecImpl<SpawnResultNoStdio>(options, runFG, execFG)\n\n// Export shim utilities\nexport {\n  getNodeGypShim,\n  getNodeGypShimDir,\n  hasNodeGypReference,\n} from './aliasRunner.ts'\n"]}

package/dist/esm/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}