@socketsecurity/lib 3.5.0 → 4.0.0

package/dist/{argv/quote.js → paths/globs.js}

@@ -17,26 +17,28 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var quote_exports = {};
-__export(quote_exports, {
-  posixQuote: () => posixQuote,
-  win32Quote: () => win32Quote
+var globs_exports = {};
+__export(globs_exports, {
+  LICENSE_GLOB: () => LICENSE_GLOB,
+  LICENSE_GLOB_RECURSIVE: () => LICENSE_GLOB_RECURSIVE,
+  LICENSE_ORIGINAL_GLOB: () => LICENSE_ORIGINAL_GLOB,
+  LICENSE_ORIGINAL_GLOB_RECURSIVE: () => LICENSE_ORIGINAL_GLOB_RECURSIVE,
+  README_GLOB: () => README_GLOB,
+  README_GLOB_RECURSIVE: () => README_GLOB_RECURSIVE
 });
-module.exports = __toCommonJS(quote_exports);
-function posixQuote(arg) {
-  if (!/[\s&|<>$`\\*?[\](){};"'~!#]/.test(arg)) {
-    return arg;
-  }
-  return `'${arg.replace(/'/g, "'\\''")}'`;
-}
-function win32Quote(arg) {
-  if (!/[\s&|<>^%()!"]/.test(arg)) {
-    return arg;
-  }
-  return `"${arg.replace(/"/g, '""')}"`;
-}
+module.exports = __toCommonJS(globs_exports);
+const LICENSE_GLOB = "LICEN[CS]E{[.-]*,}";
+const LICENSE_GLOB_RECURSIVE = "**/LICEN[CS]E{[.-]*,}";
+const LICENSE_ORIGINAL_GLOB = "*.original{.*,}";
+const LICENSE_ORIGINAL_GLOB_RECURSIVE = "**/*.original{.*,}";
+const README_GLOB = "README{.*,}";
+const README_GLOB_RECURSIVE = "**/README{.*,}";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  posixQuote,
-  win32Quote
+  LICENSE_GLOB,
+  LICENSE_GLOB_RECURSIVE,
+  LICENSE_ORIGINAL_GLOB,
+  LICENSE_ORIGINAL_GLOB_RECURSIVE,
+  README_GLOB,
+  README_GLOB_RECURSIVE
 });

package/dist/{path.d.ts → paths/normalize.d.ts}

@@ -347,3 +347,44 @@ export declare function trimLeadingDotSlash(pathLike: string | Buffer | URL): st
  */
 /*@__NO_SIDE_EFFECTS__*/
 export declare function relativeResolve(from: string, to: string): string;
+/**
+ * Convert Windows paths to Unix-style POSIX paths for Git Bash tools.
+ *
+ * Git for Windows tools (like tar, git, etc.) expect POSIX-style paths with
+ * forward slashes and Unix drive letter notation (/c/ instead of C:\).
+ * This function handles the conversion for cross-platform compatibility.
+ *
+ * Conversion rules:
+ * - On Windows: Normalizes separators and converts drive letters
+ *   - `C:\path\to\file` becomes `/c/path/to/file`
+ *   - `D:/Users/name` becomes `/d/Users/name`
+ *   - Drive letters are always lowercase in the output
+ * - On Unix: Returns the path unchanged (passes through normalization)
+ *
+ * This is particularly important for:
+ * - Git Bash tools that interpret `D:\` as a remote hostname
+ * - Cross-platform build scripts using tar, git archive, etc.
+ * - CI/CD environments where Git for Windows is used
+ *
+ * @param {string | Buffer | URL} pathLike - The path to convert
+ * @returns {string} Unix-style POSIX path (e.g., `/c/path/to/file`)
+ *
+ * @example
+ * ```typescript
+ * // Windows drive letter paths
+ * toUnixPath('C:\\path\\to\\file.txt')     // '/c/path/to/file.txt'
+ * toUnixPath('D:/projects/foo/bar')        // '/d/projects/foo/bar'
+ *
+ * // Already forward slashes (still converts drive letter)
+ * toUnixPath('C:/Windows/System32')        // '/c/Windows/System32'
+ *
+ * // Unix paths (unchanged on Unix platforms)
+ * toUnixPath('/home/user/file')            // '/home/user/file'
+ * toUnixPath('/var/log/app.log')           // '/var/log/app.log'
+ *
+ * // UNC paths (Windows network shares)
+ * toUnixPath('\\\\server\\share\\file')    // '//server/share/file'
+ * ```
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function toUnixPath(pathLike: string | Buffer | URL): string;

package/dist/{path.js → paths/normalize.js}

@@ -17,8 +17,8 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var path_exports = {};
-__export(path_exports, {
+var normalize_exports = {};
+__export(normalize_exports, {
   isAbsolute: () => isAbsolute,
   isNodeModules: () => isNodeModules,
   isPath: () => isPath,
@@ -27,11 +27,12 @@ __export(path_exports, {
   pathLikeToString: () => pathLikeToString,
   relativeResolve: () => relativeResolve,
   splitPath: () => splitPath,
+  toUnixPath: () => toUnixPath,
   trimLeadingDotSlash: () => trimLeadingDotSlash
 });
-module.exports = __toCommonJS(path_exports);
+module.exports = __toCommonJS(normalize_exports);
 var import_platform = require("#constants/platform");
-var import_strings = require("./strings");
+var import_strings = require("../strings");
 const CHAR_BACKWARD_SLASH = 92;
 const CHAR_COLON = 58;
 const CHAR_FORWARD_SLASH = 47;
@@ -434,6 +435,17 @@ function relativeResolve(from, to) {
   }
   return /* @__PURE__ */ normalizePath(rel);
 }
+// @__NO_SIDE_EFFECTS__
+function toUnixPath(pathLike) {
+  const normalized = /* @__PURE__ */ normalizePath(pathLike);
+  if (import_platform.WIN32) {
+    return normalized.replace(
+      /^([A-Z]):/i,
+      (_, letter) => `/${letter.toLowerCase()}`
+    );
+  }
+  return normalized;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   isAbsolute,
@@ -444,5 +456,6 @@ function relativeResolve(from, to) {
   pathLikeToString,
   relativeResolve,
   splitPath,
+  toUnixPath,
   trimLeadingDotSlash
 });

package/dist/{packages/paths.js → paths/packages.js}

@@ -17,13 +17,13 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var paths_exports = {};
-__export(paths_exports, {
+var packages_exports = {};
+__export(packages_exports, {
   resolvePackageJsonDirname: () => resolvePackageJsonDirname,
   resolvePackageJsonPath: () => resolvePackageJsonPath
 });
-module.exports = __toCommonJS(paths_exports);
-var import_path = require("../path");
+module.exports = __toCommonJS(packages_exports);
+var import_normalize = require("./normalize");
 let _path;
 // @__NO_SIDE_EFFECTS__
 function getPath() {
@@ -36,17 +36,17 @@ function getPath() {
 function resolvePackageJsonDirname(filepath) {
   if (filepath.endsWith("package.json")) {
     const path = /* @__PURE__ */ getPath();
-    return (0, import_path.normalizePath)(path.dirname(filepath));
+    return (0, import_normalize.normalizePath)(path.dirname(filepath));
   }
-  return (0, import_path.normalizePath)(filepath);
+  return (0, import_normalize.normalizePath)(filepath);
 }
 // @__NO_SIDE_EFFECTS__
 function resolvePackageJsonPath(filepath) {
   if (filepath.endsWith("package.json")) {
-    return (0, import_path.normalizePath)(filepath);
+    return (0, import_normalize.normalizePath)(filepath);
   }
   const path = /* @__PURE__ */ getPath();
-  return (0, import_path.normalizePath)(path.join(filepath, "package.json"));
+  return (0, import_normalize.normalizePath)(path.join(filepath, "package.json"));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/{paths.js → paths/socket.js}

@@ -27,8 +27,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var paths_exports = {};
-__export(paths_exports, {
+var socket_exports = {};
+__export(socket_exports, {
   getOsHomeDir: () => getOsHomeDir,
   getOsTmpDir: () => getOsTmpDir,
   getSocketAppCacheDir: () => getSocketAppCacheDir,
@@ -44,14 +44,17 @@ __export(paths_exports, {
   getUserHomeDir: () => getUserHomeDir,
   invalidateCache: () => invalidateCache
 });
-module.exports = __toCommonJS(paths_exports);
+module.exports = __toCommonJS(socket_exports);
 var os = __toESM(require("os"));
 var path = __toESM(require("path"));
+var import_github = require("#constants/github");
+var import_socket = require("#constants/socket");
 var import_home = require("#env/home");
-var import_socket = require("#env/socket");
+var import_socket2 = require("#env/socket");
 var import_windows = require("#env/windows");
-var import_path = require("./path");
-var import_rewire = require("./paths/rewire");
+var import_dirnames = require("./dirnames");
+var import_normalize = require("./normalize");
+var import_rewire = require("./rewire");
 function getOsHomeDir() {
   return (0, import_rewire.getPathValue)("homedir", () => os.homedir());
 }
@@ -64,96 +67,57 @@ function getSocketHomePath() {
 let _cachedSocketUserDir;
 function getSocketUserDir() {
   if (_cachedSocketUserDir === void 0) {
-    _cachedSocketUserDir = (0, import_path.normalizePath)(
-      path.join(
-        getUserHomeDir(),
-        /*@__INLINE__*/
-        require("#constants/paths").DOT_SOCKET_DIR
-      )
+    _cachedSocketUserDir = (0, import_normalize.normalizePath)(
+      path.join(getUserHomeDir(), import_dirnames.DOT_SOCKET_DIR)
     );
   }
   return _cachedSocketUserDir;
 }
 function getSocketAppDir(appName) {
-  return (0, import_path.normalizePath)(
-    path.join(
-      getSocketUserDir(),
-      `${/*@__INLINE__*/
-      require("#constants/socket").SOCKET_APP_PREFIX}${appName}`
-    )
+  return (0, import_normalize.normalizePath)(
+    path.join(getSocketUserDir(), `${import_socket.SOCKET_APP_PREFIX}${appName}`)
   );
 }
 let _cachedSocketCacacheDir;
 function getSocketCacacheDir() {
   if (_cachedSocketCacacheDir === void 0) {
-    if ((0, import_socket.getSocketCacacheDir)()) {
-      _cachedSocketCacacheDir = (0, import_path.normalizePath)(
-        (0, import_socket.getSocketCacacheDir)()
+    if ((0, import_socket2.getSocketCacacheDir)()) {
+      _cachedSocketCacacheDir = (0, import_normalize.normalizePath)(
+        (0, import_socket2.getSocketCacacheDir)()
       );
     } else {
-      _cachedSocketCacacheDir = (0, import_path.normalizePath)(
-        path.join(
-          getSocketUserDir(),
-          `${/*@__INLINE__*/
-          require("#constants/socket").SOCKET_APP_PREFIX}cacache`
-        )
+      _cachedSocketCacacheDir = (0, import_normalize.normalizePath)(
+        path.join(getSocketUserDir(), `${import_socket.SOCKET_APP_PREFIX}cacache`)
       );
     }
   }
   return _cachedSocketCacacheDir;
 }
 function getSocketDlxDir() {
-  if ((0, import_socket.getSocketDlxDirEnv)()) {
-    return (0, import_path.normalizePath)((0, import_socket.getSocketDlxDirEnv)());
+  if ((0, import_socket2.getSocketDlxDirEnv)()) {
+    return (0, import_normalize.normalizePath)((0, import_socket2.getSocketDlxDirEnv)());
   }
-  return (0, import_path.normalizePath)(
-    path.join(
-      getSocketUserDir(),
-      `${/*@__INLINE__*/
-      require("#constants/socket").SOCKET_APP_PREFIX}${/*@__INLINE__*/
-      require("#constants/socket").SOCKET_DLX_APP_NAME}`
-    )
+  return (0, import_normalize.normalizePath)(
+    path.join(getSocketUserDir(), `${import_socket.SOCKET_APP_PREFIX}${import_socket.SOCKET_DLX_APP_NAME}`)
   );
 }
 function getSocketAppCacheDir(appName) {
-  return (0, import_path.normalizePath)(
-    path.join(
-      getSocketAppDir(appName),
-      /*@__INLINE__*/
-      require("#constants/paths").CACHE_DIR
-    )
-  );
+  return (0, import_normalize.normalizePath)(path.join(getSocketAppDir(appName), import_dirnames.CACHE_DIR));
 }
 function getSocketAppCacheTtlDir(appName) {
-  return (0, import_path.normalizePath)(
-    path.join(
-      getSocketAppCacheDir(appName),
-      /*@__INLINE__*/
-      require("#constants/paths").CACHE_TTL_DIR
-    )
-  );
+  return (0, import_normalize.normalizePath)(path.join(getSocketAppCacheDir(appName), import_dirnames.CACHE_TTL_DIR));
 }
 function getSocketCliDir() {
-  return getSocketAppDir(
-    /*@__INLINE__*/
-    require("#constants/socket").SOCKET_CLI_APP_NAME
-  );
+  return getSocketAppDir(import_socket.SOCKET_CLI_APP_NAME);
 }
 function getSocketRegistryDir() {
-  return getSocketAppDir(
-    /*@__INLINE__*/
-    require("#constants/socket").SOCKET_REGISTRY_APP_NAME
-  );
+  return getSocketAppDir(import_socket.SOCKET_REGISTRY_APP_NAME);
 }
 function getSocketRegistryGithubCacheDir() {
-  return (0, import_path.normalizePath)(
+  return (0, import_normalize.normalizePath)(
     path.join(
-      getSocketAppCacheTtlDir(
-        /*@__INLINE__*/
-        require("#constants/socket").SOCKET_REGISTRY_APP_NAME
-      ),
-      /*@__INLINE__*/
-      require("#constants/github").CACHE_GITHUB_DIR
+      getSocketAppCacheTtlDir(import_socket.SOCKET_REGISTRY_APP_NAME),
+      import_github.CACHE_GITHUB_DIR
     )
   );
 }

package/dist/sea.js

@@ -23,10 +23,10 @@ __export(sea_exports, {
   isSeaBinary: () => isSeaBinary
 });
 module.exports = __toCommonJS(sea_exports);
-var import_path = require("./path");
+var import_normalize = require("./paths/normalize");
 let _isSea;
 function getSeaBinaryPath() {
-  return isSeaBinary() && process.argv[0] ? (0, import_path.normalizePath)(process.argv[0]) : void 0;
+  return isSeaBinary() && process.argv[0] ? (0, import_normalize.normalizePath)(process.argv[0]) : void 0;
 }
 function isSeaBinary() {
   if (_isSea === void 0) {

package/dist/shadow.js

@@ -22,7 +22,7 @@ __export(shadow_exports, {
   shouldSkipShadow: () => shouldSkipShadow
 });
 module.exports = __toCommonJS(shadow_exports);
-var import_path = require("./path");
+var import_normalize = require("./paths/normalize");
 function shouldSkipShadow(binPath, options) {
   const { cwd = process.cwd(), win32 = false } = {
     __proto__: null,
@@ -35,9 +35,9 @@ function shouldSkipShadow(binPath, options) {
   if (userAgent?.includes("exec") || userAgent?.includes("npx") || userAgent?.includes("dlx")) {
     return true;
   }
-  const normalizedCwd = (0, import_path.normalizePath)(cwd);
+  const normalizedCwd = (0, import_normalize.normalizePath)(cwd);
   const npmCache = process.env["npm_config_cache"];
-  if (npmCache && normalizedCwd.includes((0, import_path.normalizePath)(npmCache))) {
+  if (npmCache && normalizedCwd.includes((0, import_normalize.normalizePath)(npmCache))) {
     return true;
   }
   const tempPatterns = [

package/dist/sorts.js

@@ -1,8 +1,10 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,6 +18,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var sorts_exports = {};
 __export(sorts_exports, {
@@ -26,6 +36,8 @@ __export(sorts_exports, {
   naturalSorter: () => naturalSorter
 });
 module.exports = __toCommonJS(sorts_exports);
+var fastSort = __toESM(require("./external/fast-sort.js"));
+var semver = __toESM(require("./external/semver.js"));
 let _localeCompare;
 // @__NO_SIDE_EFFECTS__
 function localeCompare(x, y) {
@@ -59,7 +71,6 @@ let _naturalSorter;
 // @__NO_SIDE_EFFECTS__
 function naturalSorter(arrayToSort) {
   if (_naturalSorter === void 0) {
-    const fastSort = require("./external/fast-sort.js");
     _naturalSorter = fastSort.createNewSortInstance({
       comparer: naturalCompare
     });
@@ -72,7 +83,6 @@ function compareStr(a, b) {
 }
 // @__NO_SIDE_EFFECTS__
 function compareSemver(a, b) {
-  const semver = require("./external/semver.js");
   const validA = semver.valid(a);
   const validB = semver.valid(b);
   if (!validA && !validB) {

package/dist/spawn.d.ts

@@ -4,25 +4,27 @@ type BufferEncoding = globalThis.BufferEncoding;
  * Options for spawning a child process with promise-based completion.
  *
  * @property {string | undefined} cwd - Current working directory for the process
- * @property {boolean | undefined} stdioString - Convert stdio output to strings (default: `true`)
- * @property {StdioType | undefined} stdio - Stdio configuration (`'pipe'`, `'ignore'`, `'inherit'`, or array)
  * @property {NodeJS.ProcessEnv | undefined} env - Environment variables for the process
+ * @property {number | undefined} gid - Group identity of the process (POSIX only)
  * @property {boolean | string | undefined} shell - Whether to run command in shell, or path to shell
  * @property {AbortSignal | undefined} signal - Signal to abort the process
+ * @property {StdioType | undefined} stdio - Stdio configuration (`'pipe'`, `'ignore'`, `'inherit'`, or array)
+ * @property {boolean | undefined} stdioString - Convert stdio output to strings (default: `true`)
  * @property {number | undefined} timeout - Maximum time in milliseconds before killing the process
  * @property {number | undefined} uid - User identity of the process (POSIX only)
- * @property {number | undefined} gid - Group identity of the process (POSIX only)
+ * @property {boolean | undefined} windowsVerbatimArguments - Don't quote or escape arguments on Windows (requires shell: true). Use when you need exact argument control. Default: false
  */
 export type PromiseSpawnOptions = {
     cwd?: string | undefined;
-    stdioString?: boolean | undefined;
-    stdio?: StdioType | undefined;
     env?: NodeJS.ProcessEnv | undefined;
+    gid?: number | undefined;
     shell?: boolean | string | undefined;
     signal?: AbortSignal | undefined;
+    stdio?: StdioType | undefined;
+    stdioString?: boolean | undefined;
     timeout?: number | undefined;
     uid?: number | undefined;
-    gid?: number | undefined;
+    windowsVerbatimArguments?: boolean | undefined;
 };
 /**
  * Result returned by {@link spawn} when the child process completes.
@@ -266,17 +268,18 @@ interface WritableStreamType {
  * Options for spawning a child process with {@link spawn}.
  * Extends Node.js spawn options with additional Socket-specific functionality.
  *
- * @property {import('./spinner').Spinner | undefined} spinner - Spinner instance to pause during execution
- * @property {boolean | undefined} stdioString - Convert output to strings (default: `true`)
- * @property {boolean | undefined} stripAnsi - Remove ANSI codes from output (default: `true`)
  * @property {string | URL | undefined} cwd - Current working directory
  * @property {NodeJS.ProcessEnv | undefined} env - Environment variables
- * @property {StdioType | undefined} stdio - Stdio configuration
+ * @property {number | undefined} gid - Group identity (POSIX)
  * @property {boolean | string | undefined} shell - Run command in shell
- * @property {number | undefined} timeout - Timeout in milliseconds
  * @property {AbortSignal | undefined} signal - Abort signal
+ * @property {import('./spinner').Spinner | undefined} spinner - Spinner instance to pause during execution
+ * @property {StdioType | undefined} stdio - Stdio configuration
+ * @property {boolean | undefined} stdioString - Convert output to strings (default: `true`)
+ * @property {boolean | undefined} stripAnsi - Remove ANSI codes from output (default: `true`)
+ * @property {number | undefined} timeout - Timeout in milliseconds
  * @property {number | undefined} uid - User identity (POSIX)
- * @property {number | undefined} gid - Group identity (POSIX)
+ * @property {boolean | undefined} windowsVerbatimArguments - Don't quote or escape arguments on Windows (requires shell: true). Use when you need exact argument control. Default: false
  */
 export type SpawnOptions = import('./objects').Remap<NodeSpawnOptions & {
     spinner?: import('./spinner').Spinner | undefined;

package/dist/spawn.js

@@ -1,8 +1,10 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,6 +18,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var spawn_exports = {};
 __export(spawn_exports, {
@@ -26,7 +36,11 @@ __export(spawn_exports, {
 });
 module.exports = __toCommonJS(spawn_exports);
 var import_process = require("#constants/process");
+var import_promise_spawn = __toESM(require("./external/@npmcli/promise-spawn"));
+var import_node_path = __toESM(require("node:path"));
 var import_arrays = require("./arrays");
+var import_bin = require("./bin");
+var import_normalize = require("./paths/normalize");
 var import_objects = require("./objects");
 var import_strings = require("./strings");
 const abortSignal = (0, import_process.getAbortSignal)();
@@ -40,22 +54,6 @@ function getChildProcess() {
   }
   return _child_process;
 }
-let _npmCliPromiseSpawn;
-// @__NO_SIDE_EFFECTS__
-function getNpmcliPromiseSpawn() {
-  if (_npmCliPromiseSpawn === void 0) {
-    _npmCliPromiseSpawn = require("./external/@npmcli/promise-spawn.js");
-  }
-  return _npmCliPromiseSpawn;
-}
-let _path;
-// @__NO_SIDE_EFFECTS__
-function getPath() {
-  if (_path === void 0) {
-    _path = require("node:path");
-  }
-  return _path;
-}
 // @__NO_SIDE_EFFECTS__
 function isSpawnError(value) {
   if (value === null || typeof value !== "object") {
@@ -85,27 +83,32 @@ function stripAnsiFromSpawnResult(result) {
   return res;
 }
 function spawn(cmd, args, options, extra) {
-  const shell = (0, import_objects.getOwn)(options, "shell");
-  const WIN32 = process.platform === "win32";
-  let actualCmd = cmd;
-  if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {
-    const path = /* @__PURE__ */ getPath();
-    actualCmd = path.basename(actualCmd, path.extname(actualCmd));
-  }
   const {
     spinner: optionsSpinner = spinner,
     stripAnsi: shouldStripAnsi = true,
-    ...spawnOptions
+    ...rawSpawnOptions
   } = { __proto__: null, ...options };
   const spinnerInstance = optionsSpinner;
-  const { env, stdio, stdioString = true } = spawnOptions;
+  const spawnOptions = { __proto__: null, ...rawSpawnOptions };
+  const { env, shell, stdio, stdioString = true } = spawnOptions;
+  const cwd = spawnOptions.cwd ? String(spawnOptions.cwd) : void 0;
+  let actualCmd = cmd;
+  if (!(0, import_normalize.isPath)(cmd)) {
+    const resolved = (0, import_bin.whichSync)(cmd, { cwd, nothrow: true });
+    if (resolved && typeof resolved === "string") {
+      actualCmd = resolved;
+    }
+  }
+  const WIN32 = process.platform === "win32";
+  if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {
+    actualCmd = import_node_path.default.basename(actualCmd, import_node_path.default.extname(actualCmd));
+  }
   const wasSpinning = !!spinnerInstance?.isSpinning;
   const shouldStopSpinner = wasSpinning && !/* @__PURE__ */ isStdioType(stdio, "ignore") && !/* @__PURE__ */ isStdioType(stdio, "pipe");
   const shouldRestartSpinner = shouldStopSpinner;
   if (shouldStopSpinner) {
     spinnerInstance.stop();
   }
-  const npmCliPromiseSpawn = /* @__PURE__ */ getNpmcliPromiseSpawn();
   const envToUse = env ? {
     __proto__: null,
     ...process.env,
@@ -119,11 +122,12 @@ function spawn(cmd, args, options, extra) {
     stdio: spawnOptions.stdio,
     stdioString,
     shell: spawnOptions.shell,
+    windowsVerbatimArguments: spawnOptions.windowsVerbatimArguments,
     timeout: spawnOptions.timeout,
     uid: spawnOptions.uid,
     gid: spawnOptions.gid
   };
-  const spawnPromise = npmCliPromiseSpawn(
+  const spawnPromise = (0, import_promise_spawn.default)(
     actualCmd,
     args ? [...args] : [],
     promiseSpawnOpts,
@@ -163,12 +167,20 @@ function spawn(cmd, args, options, extra) {
   return newSpawnPromise;
 }
 function spawnSync(cmd, args, options) {
+  let actualCmd = cmd;
+  if (!(0, import_normalize.isPath)(cmd)) {
+    const resolved = (0, import_bin.whichSync)(cmd, {
+      cwd: (0, import_objects.getOwn)(options, "cwd"),
+      nothrow: true
+    });
+    if (resolved && typeof resolved === "string") {
+      actualCmd = resolved;
+    }
+  }
   const shell = (0, import_objects.getOwn)(options, "shell");
   const WIN32 = process.platform === "win32";
-  let actualCmd = cmd;
   if (WIN32 && shell && windowsScriptExtRegExp.test(actualCmd)) {
-    const path = /* @__PURE__ */ getPath();
-    actualCmd = path.basename(actualCmd, path.extname(actualCmd));
+    actualCmd = import_node_path.default.basename(actualCmd, import_node_path.default.extname(actualCmd));
   }
   const { stripAnsi: shouldStripAnsi = true, ...rawSpawnOptions } = {
     __proto__: null,

package/dist/spinner.d.ts

@@ -7,9 +7,9 @@ import type { ColorInherit, ColorRgb, ColorValue } from './colors';
 import type { ShimmerColorGradient, ShimmerConfig, ShimmerDirection, ShimmerState } from './effects/text-shimmer';
 /**
  * Symbol types for status messages.
- * Maps to log symbols: fail (✗), info (ℹ), reason (∴), skip (↻), success (✓), warn (⚠).
+ * Maps to log symbols: fail (✗), info (ℹ), skip (↻), success (✓), warn (⚠).
  */
-export type SymbolType = 'fail' | 'info' | 'reason' | 'skip' | 'success' | 'warn';
+export type SymbolType = 'fail' | 'info' | 'skip' | 'success' | 'warn';
 /**
  * Progress tracking information for display in spinner.
  * Used by `progress()` and `progressStep()` methods to show animated progress bars.
@@ -101,10 +101,6 @@ export type Spinner = {
     progress(current: number, total: number, unit?: string | undefined): Spinner;
     /** Increment progress by specified amount (default: 1) */
     progressStep(amount?: number): Spinner;
-    /** Show reasoning (∴) message without stopping the spinner */
-    reason(text?: string | undefined, ...extras: unknown[]): Spinner;
-    /** Show reasoning (∴) message and stop the spinner, auto-clearing the line */
-    reasonAndStop(text?: string | undefined, ...extras: unknown[]): Spinner;
     /** Set complete shimmer configuration */
     setShimmer(config: ShimmerConfig): Spinner;
     /** Show skip (↻) message without stopping the spinner */