@vlandoss/clibuddy 0.0.5 → 0.0.6-git-8d85703.0

package/dist/index.cjs

@@ -36,6 +36,7 @@ __export(index_exports, {
   createPkgService: () => createPkgService,
   createShellService: () => createShellService,
   cwd: () => cwd,
+  getPreferLocal: () => getPreferLocal,
   getVersion: () => getVersion,
   isProcessOutput: () => isProcessOutput,
   isRaw: () => isRaw,
@@ -53,7 +54,9 @@ var colors = {
   blueBright: safe(import_chalk.default.blueBright),
   redBright: safe(import_chalk.default.redBright),
   greenBright: safe(import_chalk.default.greenBright),
-  bold: safe(import_chalk.default.bold)
+  bold: safe(import_chalk.default.bold),
+  muted: safe(import_chalk.default.dim),
+  link: safe(import_chalk.default.underline)
 };
 
 // src/services/pkg.ts
@@ -128,16 +131,28 @@ async function createPkgService(cwd2) {
 
 // src/services/shell/create.ts
 var import_node_fs2 = __toESM(require("fs"), 1);
-var import_node_path2 = __toESM(require("path"), 1);
 
 // src/services/shell/shell.ts
+var import_zx2 = require("zx");
+
+// src/services/shell/utils.ts
+var import_node_path2 = __toESM(require("path"), 1);
 var import_zx = require("zx");
+function isProcessOutput(value) {
+  return value instanceof import_zx.ProcessOutput;
+}
+var getLocalBinPath = (dirPath) => import_node_path2.default.join(dirPath, "node_modules", ".bin");
+function getPreferLocal(localBaseBinPath) {
+  return !localBaseBinPath ? void 0 : Array.isArray(localBaseBinPath) ? localBaseBinPath.map(getLocalBinPath) : [localBaseBinPath].map(getLocalBinPath);
+}
+
+// src/services/shell/shell.ts
 var ShellService = class _ShellService {
   #shell;
   #options;
   constructor(options) {
     this.#options = Object.freeze(options);
-    this.#shell = (0, import_zx.$)(options);
+    this.#shell = (0, import_zx2.$)(options);
   }
   get options() {
     return this.#options;
@@ -145,6 +160,12 @@ var ShellService = class _ShellService {
   get $() {
     return this.#shell;
   }
+  child(options) {
+    return new _ShellService({
+      ...this.#options,
+      ...options
+    });
+  }
   quiet(options) {
     return this.child({
       ...options,
@@ -152,15 +173,20 @@ var ShellService = class _ShellService {
     });
   }
   at(cwd2, options) {
+    const getLocals = (locals) => (
+      // NOTE: the boolean handling is done outside when determining preferLocal
+      typeof locals === "boolean" ? [] : typeof locals === "undefined" ? [] : Array.isArray(locals) ? locals : [locals]
+    );
+    const cwdPreferLocal = getPreferLocal(cwd2);
+    const preferLocal = options?.preferLocal === false ? false : [
+      ...getLocals(this.#options.preferLocal),
+      ...getLocals(options?.preferLocal),
+      ...cwdPreferLocal ? cwdPreferLocal : []
+    ];
     return this.child({
       ...options,
-      cwd: cwd2
-    });
-  }
-  child(options) {
-    return new _ShellService({
-      ...this.#options,
-      ...options
+      cwd: cwd2,
+      preferLocal
     });
   }
 };
@@ -174,7 +200,6 @@ function quote(arg) {
   return arg.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\f/g, "\\f").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t").replace(/\v/g, "\\v").replace(/\0/g, "\\0");
 }
 var isRaw = (arg) => typeof arg === "object" && arg !== null && "stdout" in arg && typeof arg.stdout === "string";
-var getLocalBinPath = (dirPath) => import_node_path2.default.join(dirPath, "node_modules", ".bin");
 function defaultQuote(arg) {
   if (typeof arg === "string") {
     return quote(arg);
@@ -185,7 +210,7 @@ function defaultQuote(arg) {
   throw TypeError(`Unsupported argument type: ${typeof arg}`);
 }
 function createShellService(options = {}) {
-  const preferLocal = !options.localBaseBinPath ? void 0 : Array.isArray(options.localBaseBinPath) ? options.localBaseBinPath.map(getLocalBinPath) : [options.localBaseBinPath].map(getLocalBinPath);
+  const preferLocal = getPreferLocal(options.localBaseBinPath);
   return new ShellService({
     verbose: true,
     cwd,
@@ -195,12 +220,6 @@ function createShellService(options = {}) {
   });
 }
 
-// src/services/shell/utils.ts
-var import_zx2 = require("zx");
-function isProcessOutput(value) {
-  return value instanceof import_zx2.ProcessOutput;
-}
-
 // src/version.ts
 function getVersion(pkg) {
   return process.env.VERSION || pkg.packageJson.version;
@@ -213,6 +232,7 @@ function getVersion(pkg) {
   createPkgService,
   createShellService,
   cwd,
+  getPreferLocal,
   getVersion,
   isProcessOutput,
   isRaw,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/colors.ts","../src/services/pkg.ts","../src/services/shell/create.ts","../src/services/shell/shell.ts","../src/services/shell/utils.ts","../src/version.ts"],"sourcesContent":["export * from \"./colors\";\nexport * from \"./services\";\nexport * from \"./version\";\n","import chalk, { type ChalkInstance } from \"chalk\";\nimport supportsColor from \"supports-color\";\n\n// https://no-color.org/\nconst colorIsSupported = () => supportsColor.stdout && !process.env.NO_COLOR;\n\nconst identity = <T>(x: T) => x;\nconst safe = (style: ChalkInstance) => (colorIsSupported() ? style : identity);\n\nexport const colors = {\n  blueBright: safe(chalk.blueBright),\n  redBright: safe(chalk.redBright),\n  greenBright: safe(chalk.greenBright),\n  bold: safe(chalk.bold),\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findWorkspacePackages, type Project } from \"@pnpm/workspace.find-packages\";\nimport { readWorkspaceManifest } from \"@pnpm/workspace.read-manifest\";\nimport { type NormalizedPackageJson, readPackageUp } from \"read-package-up\";\n\nexport type { Project };\n\nexport class PkgService {\n  #packageJson: NormalizedPackageJson;\n  #dirPath: string;\n\n  get dirPath() {\n    return this.#dirPath;\n  }\n\n  get packageJson() {\n    return this.#packageJson;\n  }\n\n  constructor(packageJson: NormalizedPackageJson, pkgPath: string) {\n    this.#packageJson = packageJson;\n    this.#dirPath = path.dirname(pkgPath);\n  }\n\n  info() {\n    return {\n      packageJson: this.#packageJson,\n      dirPath: this.#dirPath,\n    };\n  }\n\n  hasFile(name: string, dir?: string) {\n    const filepath = dir ? path.join(dir, name) : this.#fromApp(name);\n    return fs.existsSync(filepath);\n  }\n\n  isMonorepo() {\n    return this.#packageJson.workspaces !== undefined || this.#hasPnpmWorkspace();\n  }\n\n  async getWorkspaceProjects() {\n    let patterns: string[];\n\n    if (this.#hasPnpmWorkspace()) {\n      const manifest = await readWorkspaceManifest(this.#dirPath);\n\n      if (!manifest) {\n        throw new Error(\"Can't read pnpm workspace manifest\");\n      }\n\n      patterns = manifest.packages;\n    } else {\n      patterns = Array.isArray(this.#packageJson.workspaces)\n        ? this.#packageJson.workspaces\n        : (this.#packageJson.workspaces?.packages ?? []);\n    }\n\n    if (!Array.isArray(patterns) || patterns.some((p) => typeof p !== \"string\")) {\n      throw new Error(\"Invalid workspace patterns\");\n    }\n\n    const projects = await findWorkspacePackages(this.#dirPath, {\n      patterns,\n    });\n\n    const excludeRoot = (projects: Project[]) => {\n      return projects.filter((project) => project.rootDir !== this.#dirPath);\n    };\n\n    return excludeRoot(projects);\n  }\n\n  #hasPnpmWorkspace() {\n    return this.hasFile(\"pnpm-workspace.yaml\");\n  }\n\n  #fromApp(...args: string[]) {\n    return path.join(this.#dirPath, ...args);\n  }\n}\n\nexport async function createPkgService(cwd: string): Promise<PkgService | null> {\n  const searchResult = await readPackageUp({ cwd });\n\n  if (!searchResult) {\n    return null;\n  }\n\n  const { packageJson, path } = searchResult;\n\n  return new PkgService(packageJson, path);\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ShellService } from \"./shell\";\nimport type { CreateOptions } from \"./types\";\n\nexport const cwd = fs.realpathSync(process.cwd());\n\n// Inspired by https://dub.sh/6tiHVgn\nexport function quote(arg: string) {\n  if (/^[\\w./:=@-]+$/i.test(arg) || arg === \"\") {\n    return arg;\n  }\n\n  return arg\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\\f/g, \"\\\\f\")\n    .replace(/\\n/g, \"\\\\n\")\n    .replace(/\\r/g, \"\\\\r\")\n    .replace(/\\t/g, \"\\\\t\")\n    .replace(/\\v/g, \"\\\\v\")\n    .replace(/\\0/g, \"\\\\0\");\n}\n\nexport const isRaw = (arg: unknown): arg is { stdout: string } =>\n  typeof arg === \"object\" && arg !== null && \"stdout\" in arg && typeof arg.stdout === \"string\";\n\nconst getLocalBinPath = (dirPath: string) => path.join(dirPath, \"node_modules\", \".bin\");\n\nfunction defaultQuote(arg: unknown) {\n  if (typeof arg === \"string\") {\n    return quote(arg);\n  }\n\n  if (isRaw(arg)) {\n    return arg.stdout;\n  }\n\n  throw TypeError(`Unsupported argument type: ${typeof arg}`);\n}\n\nexport function createShellService(options: CreateOptions = {}) {\n  const preferLocal = !options.localBaseBinPath\n    ? undefined\n    : Array.isArray(options.localBaseBinPath)\n      ? options.localBaseBinPath.map(getLocalBinPath)\n      : [options.localBaseBinPath].map(getLocalBinPath);\n\n  return new ShellService({\n    verbose: true,\n    cwd,\n    preferLocal,\n    quote: defaultQuote,\n    ...options,\n  });\n}\n","import { $ as make$ } from \"zx\";\nimport type { Shell, ShellOptions } from \"./types\";\n\nexport class ShellService {\n  #shell: Shell;\n  #options: ShellOptions;\n\n  constructor(options: ShellOptions) {\n    this.#options = Object.freeze(options);\n    this.#shell = make$(options);\n  }\n\n  get options() {\n    return this.#options;\n  }\n\n  get $() {\n    return this.#shell;\n  }\n\n  quiet(options?: ShellOptions) {\n    return this.child({\n      ...options,\n      verbose: false,\n    });\n  }\n\n  at(cwd: string, options?: ShellOptions) {\n    return this.child({\n      ...options,\n      cwd,\n    });\n  }\n\n  child(options: ShellOptions) {\n    return new ShellService({\n      ...this.#options,\n      ...options,\n    });\n  }\n}\n","import { ProcessOutput } from \"zx\";\n\nexport function isProcessOutput(value: unknown): value is ProcessOutput {\n  return value instanceof ProcessOutput;\n}\n","import type { PkgService } from \"./services\";\n\nexport function getVersion(pkg: PkgService) {\n  return process.env.VERSION || pkg.packageJson.version;\n}\n"],"mappings":"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","names":["supportsColor","chalk","import_workspace","path","fs","projects","cwd","import_node_fs","import_node_path","make$","cwd","fs","path","import_zx"]}
+{"version":3,"sources":["../src/index.ts","../src/colors.ts","../src/services/pkg.ts","../src/services/shell/create.ts","../src/services/shell/shell.ts","../src/services/shell/utils.ts","../src/version.ts"],"sourcesContent":["export * from \"./colors\";\nexport * from \"./services\";\nexport * from \"./version\";\n","import chalk, { type ChalkInstance } from \"chalk\";\nimport supportsColor from \"supports-color\";\n\n// https://no-color.org/\nconst colorIsSupported = () => supportsColor.stdout && !process.env.NO_COLOR;\n\nconst identity = <T>(x: T) => x;\nconst safe = (style: ChalkInstance) => (colorIsSupported() ? style : identity);\n\nexport const colors = {\n  blueBright: safe(chalk.blueBright),\n  redBright: safe(chalk.redBright),\n  greenBright: safe(chalk.greenBright),\n  bold: safe(chalk.bold),\n  muted: safe(chalk.dim),\n  link: safe(chalk.underline),\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findWorkspacePackages, type Project } from \"@pnpm/workspace.find-packages\";\nimport { readWorkspaceManifest } from \"@pnpm/workspace.read-manifest\";\nimport { type NormalizedPackageJson, readPackageUp } from \"read-package-up\";\n\nexport type { Project };\n\nexport class PkgService {\n  #packageJson: NormalizedPackageJson;\n  #dirPath: string;\n\n  get dirPath() {\n    return this.#dirPath;\n  }\n\n  get packageJson() {\n    return this.#packageJson;\n  }\n\n  constructor(packageJson: NormalizedPackageJson, pkgPath: string) {\n    this.#packageJson = packageJson;\n    this.#dirPath = path.dirname(pkgPath);\n  }\n\n  info() {\n    return {\n      packageJson: this.#packageJson,\n      dirPath: this.#dirPath,\n    };\n  }\n\n  hasFile(name: string, dir?: string) {\n    const filepath = dir ? path.join(dir, name) : this.#fromApp(name);\n    return fs.existsSync(filepath);\n  }\n\n  isMonorepo() {\n    return this.#packageJson.workspaces !== undefined || this.#hasPnpmWorkspace();\n  }\n\n  async getWorkspaceProjects() {\n    let patterns: string[];\n\n    if (this.#hasPnpmWorkspace()) {\n      const manifest = await readWorkspaceManifest(this.#dirPath);\n\n      if (!manifest) {\n        throw new Error(\"Can't read pnpm workspace manifest\");\n      }\n\n      patterns = manifest.packages;\n    } else {\n      patterns = Array.isArray(this.#packageJson.workspaces)\n        ? this.#packageJson.workspaces\n        : (this.#packageJson.workspaces?.packages ?? []);\n    }\n\n    if (!Array.isArray(patterns) || patterns.some((p) => typeof p !== \"string\")) {\n      throw new Error(\"Invalid workspace patterns\");\n    }\n\n    const projects = await findWorkspacePackages(this.#dirPath, {\n      patterns,\n    });\n\n    const excludeRoot = (projects: Project[]) => {\n      return projects.filter((project) => project.rootDir !== this.#dirPath);\n    };\n\n    return excludeRoot(projects);\n  }\n\n  #hasPnpmWorkspace() {\n    return this.hasFile(\"pnpm-workspace.yaml\");\n  }\n\n  #fromApp(...args: string[]) {\n    return path.join(this.#dirPath, ...args);\n  }\n}\n\nexport async function createPkgService(cwd: string): Promise<PkgService | null> {\n  const searchResult = await readPackageUp({ cwd });\n\n  if (!searchResult) {\n    return null;\n  }\n\n  const { packageJson, path } = searchResult;\n\n  return new PkgService(packageJson, path);\n}\n","import fs from \"node:fs\";\nimport { ShellService } from \"./shell\";\nimport type { CreateOptions } from \"./types\";\nimport { getPreferLocal } from \"./utils\";\n\nexport const cwd = fs.realpathSync(process.cwd());\n\n// Inspired by https://dub.sh/6tiHVgn\nexport function quote(arg: string) {\n  if (/^[\\w./:=@-]+$/i.test(arg) || arg === \"\") {\n    return arg;\n  }\n\n  return arg\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\\f/g, \"\\\\f\")\n    .replace(/\\n/g, \"\\\\n\")\n    .replace(/\\r/g, \"\\\\r\")\n    .replace(/\\t/g, \"\\\\t\")\n    .replace(/\\v/g, \"\\\\v\")\n    .replace(/\\0/g, \"\\\\0\");\n}\n\nexport const isRaw = (arg: unknown): arg is { stdout: string } =>\n  typeof arg === \"object\" && arg !== null && \"stdout\" in arg && typeof arg.stdout === \"string\";\n\nfunction defaultQuote(arg: unknown) {\n  if (typeof arg === \"string\") {\n    return quote(arg);\n  }\n\n  if (isRaw(arg)) {\n    return arg.stdout;\n  }\n\n  throw TypeError(`Unsupported argument type: ${typeof arg}`);\n}\n\nexport function createShellService(options: CreateOptions = {}) {\n  const preferLocal = getPreferLocal(options.localBaseBinPath);\n\n  return new ShellService({\n    verbose: true,\n    cwd,\n    preferLocal,\n    quote: defaultQuote,\n    ...options,\n  });\n}\n","import { $ as make$ } from \"zx\";\nimport type { Shell, ShellOptions } from \"./types\";\nimport { getPreferLocal } from \"./utils\";\n\nexport class ShellService {\n  #shell: Shell;\n  #options: ShellOptions;\n\n  constructor(options: ShellOptions) {\n    this.#options = Object.freeze(options);\n    this.#shell = make$(options);\n  }\n\n  get options() {\n    return this.#options;\n  }\n\n  get $() {\n    return this.#shell;\n  }\n\n  child(options: ShellOptions) {\n    return new ShellService({\n      ...this.#options,\n      ...options,\n    });\n  }\n\n  quiet(options?: ShellOptions) {\n    return this.child({\n      ...options,\n      verbose: false,\n    });\n  }\n\n  at(cwd: string, options?: ShellOptions) {\n    const getLocals = (locals: boolean | string | string[] | undefined) =>\n      // NOTE: the boolean handling is done outside when determining preferLocal\n      typeof locals === \"boolean\" ? [] : typeof locals === \"undefined\" ? [] : Array.isArray(locals) ? locals : [locals];\n\n    const cwdPreferLocal = getPreferLocal(cwd);\n\n    const preferLocal =\n      options?.preferLocal === false\n        ? false\n        : [\n            ...getLocals(this.#options.preferLocal),\n            ...getLocals(options?.preferLocal),\n            ...(cwdPreferLocal ? cwdPreferLocal : []),\n          ];\n\n    return this.child({\n      ...options,\n      cwd,\n      preferLocal,\n    });\n  }\n}\n","import path from \"node:path\";\nimport { ProcessOutput } from \"zx\";\n\nexport function isProcessOutput(value: unknown): value is ProcessOutput {\n  return value instanceof ProcessOutput;\n}\n\nconst getLocalBinPath = (dirPath: string) => path.join(dirPath, \"node_modules\", \".bin\");\n\nexport function getPreferLocal(localBaseBinPath: string | Array<string> | undefined) {\n  return !localBaseBinPath\n    ? undefined\n    : Array.isArray(localBaseBinPath)\n      ? localBaseBinPath.map(getLocalBinPath)\n      : [localBaseBinPath].map(getLocalBinPath);\n}\n","import type { PkgService } from \"./services\";\n\nexport function getVersion(pkg: PkgService) {\n  return process.env.VERSION || pkg.packageJson.version;\n}\n"],"mappings":"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","names":["supportsColor","chalk","import_workspace","path","fs","projects","cwd","import_node_fs","import_zx","import_node_path","path","make$","cwd","fs"]}

package/dist/index.d.cts

@@ -10,6 +10,8 @@ declare const colors: {
     redBright: (<T>(x: T) => T) | ChalkInstance;
     greenBright: (<T>(x: T) => T) | ChalkInstance;
     bold: (<T>(x: T) => T) | ChalkInstance;
+    muted: (<T>(x: T) => T) | ChalkInstance;
+    link: (<T>(x: T) => T) | ChalkInstance;
 };
 
 declare class PkgService {
@@ -38,9 +40,9 @@ declare class ShellService {
     constructor(options: ShellOptions);
     get options(): Partial<zx.Options>;
     get $(): Shell;
+    child(options: ShellOptions): ShellService;
     quiet(options?: ShellOptions): ShellService;
     at(cwd: string, options?: ShellOptions): ShellService;
-    child(options: ShellOptions): ShellService;
 }
 
 declare const cwd: string;
@@ -51,7 +53,8 @@ declare const isRaw: (arg: unknown) => arg is {
 declare function createShellService(options?: CreateOptions): ShellService;
 
 declare function isProcessOutput(value: unknown): value is ProcessOutput;
+declare function getPreferLocal(localBaseBinPath: string | Array<string> | undefined): string[] | undefined;
 
 declare function getVersion(pkg: PkgService): string;
 
-export { type CreateOptions, PkgService, type Shell, type ShellOptions, ShellService, colors, createPkgService, createShellService, cwd, getVersion, isProcessOutput, isRaw, quote };
+export { type CreateOptions, PkgService, type Shell, type ShellOptions, ShellService, colors, createPkgService, createShellService, cwd, getPreferLocal, getVersion, isProcessOutput, isRaw, quote };

package/dist/index.d.ts

@@ -10,6 +10,8 @@ declare const colors: {
     redBright: (<T>(x: T) => T) | ChalkInstance;
     greenBright: (<T>(x: T) => T) | ChalkInstance;
     bold: (<T>(x: T) => T) | ChalkInstance;
+    muted: (<T>(x: T) => T) | ChalkInstance;
+    link: (<T>(x: T) => T) | ChalkInstance;
 };
 
 declare class PkgService {
@@ -38,9 +40,9 @@ declare class ShellService {
     constructor(options: ShellOptions);
     get options(): Partial<zx.Options>;
     get $(): Shell;
+    child(options: ShellOptions): ShellService;
     quiet(options?: ShellOptions): ShellService;
     at(cwd: string, options?: ShellOptions): ShellService;
-    child(options: ShellOptions): ShellService;
 }
 
 declare const cwd: string;
@@ -51,7 +53,8 @@ declare const isRaw: (arg: unknown) => arg is {
 declare function createShellService(options?: CreateOptions): ShellService;
 
 declare function isProcessOutput(value: unknown): value is ProcessOutput;
+declare function getPreferLocal(localBaseBinPath: string | Array<string> | undefined): string[] | undefined;
 
 declare function getVersion(pkg: PkgService): string;
 
-export { type CreateOptions, PkgService, type Shell, type ShellOptions, ShellService, colors, createPkgService, createShellService, cwd, getVersion, isProcessOutput, isRaw, quote };
+export { type CreateOptions, PkgService, type Shell, type ShellOptions, ShellService, colors, createPkgService, createShellService, cwd, getPreferLocal, getVersion, isProcessOutput, isRaw, quote };

package/dist/index.js

@@ -8,7 +8,9 @@ var colors = {
   blueBright: safe(chalk.blueBright),
   redBright: safe(chalk.redBright),
   greenBright: safe(chalk.greenBright),
-  bold: safe(chalk.bold)
+  bold: safe(chalk.bold),
+  muted: safe(chalk.dim),
+  link: safe(chalk.underline)
 };
 
 // src/services/pkg.ts
@@ -83,10 +85,22 @@ async function createPkgService(cwd2) {
 
 // src/services/shell/create.ts
 import fs2 from "fs";
-import path2 from "path";
 
 // src/services/shell/shell.ts
 import { $ as make$ } from "zx";
+
+// src/services/shell/utils.ts
+import path2 from "path";
+import { ProcessOutput } from "zx";
+function isProcessOutput(value) {
+  return value instanceof ProcessOutput;
+}
+var getLocalBinPath = (dirPath) => path2.join(dirPath, "node_modules", ".bin");
+function getPreferLocal(localBaseBinPath) {
+  return !localBaseBinPath ? void 0 : Array.isArray(localBaseBinPath) ? localBaseBinPath.map(getLocalBinPath) : [localBaseBinPath].map(getLocalBinPath);
+}
+
+// src/services/shell/shell.ts
 var ShellService = class _ShellService {
   #shell;
   #options;
@@ -100,6 +114,12 @@ var ShellService = class _ShellService {
   get $() {
     return this.#shell;
   }
+  child(options) {
+    return new _ShellService({
+      ...this.#options,
+      ...options
+    });
+  }
   quiet(options) {
     return this.child({
       ...options,
@@ -107,15 +127,20 @@ var ShellService = class _ShellService {
     });
   }
   at(cwd2, options) {
+    const getLocals = (locals) => (
+      // NOTE: the boolean handling is done outside when determining preferLocal
+      typeof locals === "boolean" ? [] : typeof locals === "undefined" ? [] : Array.isArray(locals) ? locals : [locals]
+    );
+    const cwdPreferLocal = getPreferLocal(cwd2);
+    const preferLocal = options?.preferLocal === false ? false : [
+      ...getLocals(this.#options.preferLocal),
+      ...getLocals(options?.preferLocal),
+      ...cwdPreferLocal ? cwdPreferLocal : []
+    ];
     return this.child({
       ...options,
-      cwd: cwd2
-    });
-  }
-  child(options) {
-    return new _ShellService({
-      ...this.#options,
-      ...options
+      cwd: cwd2,
+      preferLocal
     });
   }
 };
@@ -129,7 +154,6 @@ function quote(arg) {
   return arg.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\f/g, "\\f").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t").replace(/\v/g, "\\v").replace(/\0/g, "\\0");
 }
 var isRaw = (arg) => typeof arg === "object" && arg !== null && "stdout" in arg && typeof arg.stdout === "string";
-var getLocalBinPath = (dirPath) => path2.join(dirPath, "node_modules", ".bin");
 function defaultQuote(arg) {
   if (typeof arg === "string") {
     return quote(arg);
@@ -140,7 +164,7 @@ function defaultQuote(arg) {
   throw TypeError(`Unsupported argument type: ${typeof arg}`);
 }
 function createShellService(options = {}) {
-  const preferLocal = !options.localBaseBinPath ? void 0 : Array.isArray(options.localBaseBinPath) ? options.localBaseBinPath.map(getLocalBinPath) : [options.localBaseBinPath].map(getLocalBinPath);
+  const preferLocal = getPreferLocal(options.localBaseBinPath);
   return new ShellService({
     verbose: true,
     cwd,
@@ -150,12 +174,6 @@ function createShellService(options = {}) {
   });
 }
 
-// src/services/shell/utils.ts
-import { ProcessOutput } from "zx";
-function isProcessOutput(value) {
-  return value instanceof ProcessOutput;
-}
-
 // src/version.ts
 function getVersion(pkg) {
   return process.env.VERSION || pkg.packageJson.version;
@@ -167,6 +185,7 @@ export {
   createPkgService,
   createShellService,
   cwd,
+  getPreferLocal,
   getVersion,
   isProcessOutput,
   isRaw,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/colors.ts","../src/services/pkg.ts","../src/services/shell/create.ts","../src/services/shell/shell.ts","../src/services/shell/utils.ts","../src/version.ts"],"sourcesContent":["import chalk, { type ChalkInstance } from \"chalk\";\nimport supportsColor from \"supports-color\";\n\n// https://no-color.org/\nconst colorIsSupported = () => supportsColor.stdout && !process.env.NO_COLOR;\n\nconst identity = <T>(x: T) => x;\nconst safe = (style: ChalkInstance) => (colorIsSupported() ? style : identity);\n\nexport const colors = {\n  blueBright: safe(chalk.blueBright),\n  redBright: safe(chalk.redBright),\n  greenBright: safe(chalk.greenBright),\n  bold: safe(chalk.bold),\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findWorkspacePackages, type Project } from \"@pnpm/workspace.find-packages\";\nimport { readWorkspaceManifest } from \"@pnpm/workspace.read-manifest\";\nimport { type NormalizedPackageJson, readPackageUp } from \"read-package-up\";\n\nexport type { Project };\n\nexport class PkgService {\n  #packageJson: NormalizedPackageJson;\n  #dirPath: string;\n\n  get dirPath() {\n    return this.#dirPath;\n  }\n\n  get packageJson() {\n    return this.#packageJson;\n  }\n\n  constructor(packageJson: NormalizedPackageJson, pkgPath: string) {\n    this.#packageJson = packageJson;\n    this.#dirPath = path.dirname(pkgPath);\n  }\n\n  info() {\n    return {\n      packageJson: this.#packageJson,\n      dirPath: this.#dirPath,\n    };\n  }\n\n  hasFile(name: string, dir?: string) {\n    const filepath = dir ? path.join(dir, name) : this.#fromApp(name);\n    return fs.existsSync(filepath);\n  }\n\n  isMonorepo() {\n    return this.#packageJson.workspaces !== undefined || this.#hasPnpmWorkspace();\n  }\n\n  async getWorkspaceProjects() {\n    let patterns: string[];\n\n    if (this.#hasPnpmWorkspace()) {\n      const manifest = await readWorkspaceManifest(this.#dirPath);\n\n      if (!manifest) {\n        throw new Error(\"Can't read pnpm workspace manifest\");\n      }\n\n      patterns = manifest.packages;\n    } else {\n      patterns = Array.isArray(this.#packageJson.workspaces)\n        ? this.#packageJson.workspaces\n        : (this.#packageJson.workspaces?.packages ?? []);\n    }\n\n    if (!Array.isArray(patterns) || patterns.some((p) => typeof p !== \"string\")) {\n      throw new Error(\"Invalid workspace patterns\");\n    }\n\n    const projects = await findWorkspacePackages(this.#dirPath, {\n      patterns,\n    });\n\n    const excludeRoot = (projects: Project[]) => {\n      return projects.filter((project) => project.rootDir !== this.#dirPath);\n    };\n\n    return excludeRoot(projects);\n  }\n\n  #hasPnpmWorkspace() {\n    return this.hasFile(\"pnpm-workspace.yaml\");\n  }\n\n  #fromApp(...args: string[]) {\n    return path.join(this.#dirPath, ...args);\n  }\n}\n\nexport async function createPkgService(cwd: string): Promise<PkgService | null> {\n  const searchResult = await readPackageUp({ cwd });\n\n  if (!searchResult) {\n    return null;\n  }\n\n  const { packageJson, path } = searchResult;\n\n  return new PkgService(packageJson, path);\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ShellService } from \"./shell\";\nimport type { CreateOptions } from \"./types\";\n\nexport const cwd = fs.realpathSync(process.cwd());\n\n// Inspired by https://dub.sh/6tiHVgn\nexport function quote(arg: string) {\n  if (/^[\\w./:=@-]+$/i.test(arg) || arg === \"\") {\n    return arg;\n  }\n\n  return arg\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\\f/g, \"\\\\f\")\n    .replace(/\\n/g, \"\\\\n\")\n    .replace(/\\r/g, \"\\\\r\")\n    .replace(/\\t/g, \"\\\\t\")\n    .replace(/\\v/g, \"\\\\v\")\n    .replace(/\\0/g, \"\\\\0\");\n}\n\nexport const isRaw = (arg: unknown): arg is { stdout: string } =>\n  typeof arg === \"object\" && arg !== null && \"stdout\" in arg && typeof arg.stdout === \"string\";\n\nconst getLocalBinPath = (dirPath: string) => path.join(dirPath, \"node_modules\", \".bin\");\n\nfunction defaultQuote(arg: unknown) {\n  if (typeof arg === \"string\") {\n    return quote(arg);\n  }\n\n  if (isRaw(arg)) {\n    return arg.stdout;\n  }\n\n  throw TypeError(`Unsupported argument type: ${typeof arg}`);\n}\n\nexport function createShellService(options: CreateOptions = {}) {\n  const preferLocal = !options.localBaseBinPath\n    ? undefined\n    : Array.isArray(options.localBaseBinPath)\n      ? options.localBaseBinPath.map(getLocalBinPath)\n      : [options.localBaseBinPath].map(getLocalBinPath);\n\n  return new ShellService({\n    verbose: true,\n    cwd,\n    preferLocal,\n    quote: defaultQuote,\n    ...options,\n  });\n}\n","import { $ as make$ } from \"zx\";\nimport type { Shell, ShellOptions } from \"./types\";\n\nexport class ShellService {\n  #shell: Shell;\n  #options: ShellOptions;\n\n  constructor(options: ShellOptions) {\n    this.#options = Object.freeze(options);\n    this.#shell = make$(options);\n  }\n\n  get options() {\n    return this.#options;\n  }\n\n  get $() {\n    return this.#shell;\n  }\n\n  quiet(options?: ShellOptions) {\n    return this.child({\n      ...options,\n      verbose: false,\n    });\n  }\n\n  at(cwd: string, options?: ShellOptions) {\n    return this.child({\n      ...options,\n      cwd,\n    });\n  }\n\n  child(options: ShellOptions) {\n    return new ShellService({\n      ...this.#options,\n      ...options,\n    });\n  }\n}\n","import { ProcessOutput } from \"zx\";\n\nexport function isProcessOutput(value: unknown): value is ProcessOutput {\n  return value instanceof ProcessOutput;\n}\n","import type { PkgService } from \"./services\";\n\nexport function getVersion(pkg: PkgService) {\n  return process.env.VERSION || pkg.packageJson.version;\n}\n"],"mappings":";AAAA,OAAO,WAAmC;AAC1C,OAAO,mBAAmB;AAG1B,IAAM,mBAAmB,MAAM,cAAc,UAAU,CAAC,QAAQ,IAAI;AAEpE,IAAM,WAAW,CAAI,MAAS;AAC9B,IAAM,OAAO,CAAC,UAA0B,iBAAiB,IAAI,QAAQ;AAE9D,IAAM,SAAS;AAAA,EACpB,YAAY,KAAK,MAAM,UAAU;AAAA,EACjC,WAAW,KAAK,MAAM,SAAS;AAAA,EAC/B,aAAa,KAAK,MAAM,WAAW;AAAA,EACnC,MAAM,KAAK,MAAM,IAAI;AACvB;;;ACdA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,6BAA2C;AACpD,SAAS,6BAA6B;AACtC,SAAqC,qBAAqB;AAInD,IAAM,aAAN,MAAiB;AAAA,EACtB;AAAA,EACA;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,cAAc;AAChB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,aAAoC,SAAiB;AAC/D,SAAK,eAAe;AACpB,SAAK,WAAW,KAAK,QAAQ,OAAO;AAAA,EACtC;AAAA,EAEA,OAAO;AACL,WAAO;AAAA,MACL,aAAa,KAAK;AAAA,MAClB,SAAS,KAAK;AAAA,IAChB;AAAA,EACF;AAAA,EAEA,QAAQ,MAAc,KAAc;AAClC,UAAM,WAAW,MAAM,KAAK,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,IAAI;AAChE,WAAO,GAAG,WAAW,QAAQ;AAAA,EAC/B;AAAA,EAEA,aAAa;AACX,WAAO,KAAK,aAAa,eAAe,UAAa,KAAK,kBAAkB;AAAA,EAC9E;AAAA,EAEA,MAAM,uBAAuB;AAC3B,QAAI;AAEJ,QAAI,KAAK,kBAAkB,GAAG;AAC5B,YAAM,WAAW,MAAM,sBAAsB,KAAK,QAAQ;AAE1D,UAAI,CAAC,UAAU;AACb,cAAM,IAAI,MAAM,oCAAoC;AAAA,MACtD;AAEA,iBAAW,SAAS;AAAA,IACtB,OAAO;AACL,iBAAW,MAAM,QAAQ,KAAK,aAAa,UAAU,IACjD,KAAK,aAAa,aACjB,KAAK,aAAa,YAAY,YAAY,CAAC;AAAA,IAClD;AAEA,QAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,KAAK,CAAC,MAAM,OAAO,MAAM,QAAQ,GAAG;AAC3E,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,UAAM,WAAW,MAAM,sBAAsB,KAAK,UAAU;AAAA,MAC1D;AAAA,IACF,CAAC;AAED,UAAM,cAAc,CAACA,cAAwB;AAC3C,aAAOA,UAAS,OAAO,CAAC,YAAY,QAAQ,YAAY,KAAK,QAAQ;AAAA,IACvE;AAEA,WAAO,YAAY,QAAQ;AAAA,EAC7B;AAAA,EAEA,oBAAoB;AAClB,WAAO,KAAK,QAAQ,qBAAqB;AAAA,EAC3C;AAAA,EAEA,YAAY,MAAgB;AAC1B,WAAO,KAAK,KAAK,KAAK,UAAU,GAAG,IAAI;AAAA,EACzC;AACF;AAEA,eAAsB,iBAAiBC,MAAyC;AAC9E,QAAM,eAAe,MAAM,cAAc,EAAE,KAAAA,KAAI,CAAC;AAEhD,MAAI,CAAC,cAAc;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,aAAa,MAAAC,MAAK,IAAI;AAE9B,SAAO,IAAI,WAAW,aAAaA,KAAI;AACzC;;;AC5FA,OAAOC,SAAQ;AACf,OAAOC,WAAU;;;ACDjB,SAAS,KAAK,aAAa;AAGpB,IAAM,eAAN,MAAM,cAAa;AAAA,EACxB;AAAA,EACA;AAAA,EAEA,YAAY,SAAuB;AACjC,SAAK,WAAW,OAAO,OAAO,OAAO;AACrC,SAAK,SAAS,MAAM,OAAO;AAAA,EAC7B;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,IAAI;AACN,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,SAAwB;AAC5B,WAAO,KAAK,MAAM;AAAA,MAChB,GAAG;AAAA,MACH,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA,EAEA,GAAGC,MAAa,SAAwB;AACtC,WAAO,KAAK,MAAM;AAAA,MAChB,GAAG;AAAA,MACH,KAAAA;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,SAAuB;AAC3B,WAAO,IAAI,cAAa;AAAA,MACtB,GAAG,KAAK;AAAA,MACR,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ADnCO,IAAM,MAAMC,IAAG,aAAa,QAAQ,IAAI,CAAC;AAGzC,SAAS,MAAM,KAAa;AACjC,MAAI,iBAAiB,KAAK,GAAG,KAAK,QAAQ,IAAI;AAC5C,WAAO;AAAA,EACT;AAEA,SAAO,IACJ,QAAQ,OAAO,MAAM,EACrB,QAAQ,MAAM,KAAK,EACnB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK,EACpB,QAAQ,OAAO,KAAK;AACzB;AAEO,IAAM,QAAQ,CAAC,QACpB,OAAO,QAAQ,YAAY,QAAQ,QAAQ,YAAY,OAAO,OAAO,IAAI,WAAW;AAEtF,IAAM,kBAAkB,CAAC,YAAoBC,MAAK,KAAK,SAAS,gBAAgB,MAAM;AAEtF,SAAS,aAAa,KAAc;AAClC,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO,MAAM,GAAG;AAAA,EAClB;AAEA,MAAI,MAAM,GAAG,GAAG;AACd,WAAO,IAAI;AAAA,EACb;AAEA,QAAM,UAAU,8BAA8B,OAAO,GAAG,EAAE;AAC5D;AAEO,SAAS,mBAAmB,UAAyB,CAAC,GAAG;AAC9D,QAAM,cAAc,CAAC,QAAQ,mBACzB,SACA,MAAM,QAAQ,QAAQ,gBAAgB,IACpC,QAAQ,iBAAiB,IAAI,eAAe,IAC5C,CAAC,QAAQ,gBAAgB,EAAE,IAAI,eAAe;AAEpD,SAAO,IAAI,aAAa;AAAA,IACtB,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP,GAAG;AAAA,EACL,CAAC;AACH;;;AEvDA,SAAS,qBAAqB;AAEvB,SAAS,gBAAgB,OAAwC;AACtE,SAAO,iBAAiB;AAC1B;;;ACFO,SAAS,WAAW,KAAiB;AAC1C,SAAO,QAAQ,IAAI,WAAW,IAAI,YAAY;AAChD;","names":["projects","cwd","path","fs","path","cwd","fs","path"]}
+{"version":3,"sources":["../src/colors.ts","../src/services/pkg.ts","../src/services/shell/create.ts","../src/services/shell/shell.ts","../src/services/shell/utils.ts","../src/version.ts"],"sourcesContent":["import chalk, { type ChalkInstance } from \"chalk\";\nimport supportsColor from \"supports-color\";\n\n// https://no-color.org/\nconst colorIsSupported = () => supportsColor.stdout && !process.env.NO_COLOR;\n\nconst identity = <T>(x: T) => x;\nconst safe = (style: ChalkInstance) => (colorIsSupported() ? style : identity);\n\nexport const colors = {\n  blueBright: safe(chalk.blueBright),\n  redBright: safe(chalk.redBright),\n  greenBright: safe(chalk.greenBright),\n  bold: safe(chalk.bold),\n  muted: safe(chalk.dim),\n  link: safe(chalk.underline),\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findWorkspacePackages, type Project } from \"@pnpm/workspace.find-packages\";\nimport { readWorkspaceManifest } from \"@pnpm/workspace.read-manifest\";\nimport { type NormalizedPackageJson, readPackageUp } from \"read-package-up\";\n\nexport type { Project };\n\nexport class PkgService {\n  #packageJson: NormalizedPackageJson;\n  #dirPath: string;\n\n  get dirPath() {\n    return this.#dirPath;\n  }\n\n  get packageJson() {\n    return this.#packageJson;\n  }\n\n  constructor(packageJson: NormalizedPackageJson, pkgPath: string) {\n    this.#packageJson = packageJson;\n    this.#dirPath = path.dirname(pkgPath);\n  }\n\n  info() {\n    return {\n      packageJson: this.#packageJson,\n      dirPath: this.#dirPath,\n    };\n  }\n\n  hasFile(name: string, dir?: string) {\n    const filepath = dir ? path.join(dir, name) : this.#fromApp(name);\n    return fs.existsSync(filepath);\n  }\n\n  isMonorepo() {\n    return this.#packageJson.workspaces !== undefined || this.#hasPnpmWorkspace();\n  }\n\n  async getWorkspaceProjects() {\n    let patterns: string[];\n\n    if (this.#hasPnpmWorkspace()) {\n      const manifest = await readWorkspaceManifest(this.#dirPath);\n\n      if (!manifest) {\n        throw new Error(\"Can't read pnpm workspace manifest\");\n      }\n\n      patterns = manifest.packages;\n    } else {\n      patterns = Array.isArray(this.#packageJson.workspaces)\n        ? this.#packageJson.workspaces\n        : (this.#packageJson.workspaces?.packages ?? []);\n    }\n\n    if (!Array.isArray(patterns) || patterns.some((p) => typeof p !== \"string\")) {\n      throw new Error(\"Invalid workspace patterns\");\n    }\n\n    const projects = await findWorkspacePackages(this.#dirPath, {\n      patterns,\n    });\n\n    const excludeRoot = (projects: Project[]) => {\n      return projects.filter((project) => project.rootDir !== this.#dirPath);\n    };\n\n    return excludeRoot(projects);\n  }\n\n  #hasPnpmWorkspace() {\n    return this.hasFile(\"pnpm-workspace.yaml\");\n  }\n\n  #fromApp(...args: string[]) {\n    return path.join(this.#dirPath, ...args);\n  }\n}\n\nexport async function createPkgService(cwd: string): Promise<PkgService | null> {\n  const searchResult = await readPackageUp({ cwd });\n\n  if (!searchResult) {\n    return null;\n  }\n\n  const { packageJson, path } = searchResult;\n\n  return new PkgService(packageJson, path);\n}\n","import fs from \"node:fs\";\nimport { ShellService } from \"./shell\";\nimport type { CreateOptions } from \"./types\";\nimport { getPreferLocal } from \"./utils\";\n\nexport const cwd = fs.realpathSync(process.cwd());\n\n// Inspired by https://dub.sh/6tiHVgn\nexport function quote(arg: string) {\n  if (/^[\\w./:=@-]+$/i.test(arg) || arg === \"\") {\n    return arg;\n  }\n\n  return arg\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\\f/g, \"\\\\f\")\n    .replace(/\\n/g, \"\\\\n\")\n    .replace(/\\r/g, \"\\\\r\")\n    .replace(/\\t/g, \"\\\\t\")\n    .replace(/\\v/g, \"\\\\v\")\n    .replace(/\\0/g, \"\\\\0\");\n}\n\nexport const isRaw = (arg: unknown): arg is { stdout: string } =>\n  typeof arg === \"object\" && arg !== null && \"stdout\" in arg && typeof arg.stdout === \"string\";\n\nfunction defaultQuote(arg: unknown) {\n  if (typeof arg === \"string\") {\n    return quote(arg);\n  }\n\n  if (isRaw(arg)) {\n    return arg.stdout;\n  }\n\n  throw TypeError(`Unsupported argument type: ${typeof arg}`);\n}\n\nexport function createShellService(options: CreateOptions = {}) {\n  const preferLocal = getPreferLocal(options.localBaseBinPath);\n\n  return new ShellService({\n    verbose: true,\n    cwd,\n    preferLocal,\n    quote: defaultQuote,\n    ...options,\n  });\n}\n","import { $ as make$ } from \"zx\";\nimport type { Shell, ShellOptions } from \"./types\";\nimport { getPreferLocal } from \"./utils\";\n\nexport class ShellService {\n  #shell: Shell;\n  #options: ShellOptions;\n\n  constructor(options: ShellOptions) {\n    this.#options = Object.freeze(options);\n    this.#shell = make$(options);\n  }\n\n  get options() {\n    return this.#options;\n  }\n\n  get $() {\n    return this.#shell;\n  }\n\n  child(options: ShellOptions) {\n    return new ShellService({\n      ...this.#options,\n      ...options,\n    });\n  }\n\n  quiet(options?: ShellOptions) {\n    return this.child({\n      ...options,\n      verbose: false,\n    });\n  }\n\n  at(cwd: string, options?: ShellOptions) {\n    const getLocals = (locals: boolean | string | string[] | undefined) =>\n      // NOTE: the boolean handling is done outside when determining preferLocal\n      typeof locals === \"boolean\" ? [] : typeof locals === \"undefined\" ? [] : Array.isArray(locals) ? locals : [locals];\n\n    const cwdPreferLocal = getPreferLocal(cwd);\n\n    const preferLocal =\n      options?.preferLocal === false\n        ? false\n        : [\n            ...getLocals(this.#options.preferLocal),\n            ...getLocals(options?.preferLocal),\n            ...(cwdPreferLocal ? cwdPreferLocal : []),\n          ];\n\n    return this.child({\n      ...options,\n      cwd,\n      preferLocal,\n    });\n  }\n}\n","import path from \"node:path\";\nimport { ProcessOutput } from \"zx\";\n\nexport function isProcessOutput(value: unknown): value is ProcessOutput {\n  return value instanceof ProcessOutput;\n}\n\nconst getLocalBinPath = (dirPath: string) => path.join(dirPath, \"node_modules\", \".bin\");\n\nexport function getPreferLocal(localBaseBinPath: string | Array<string> | undefined) {\n  return !localBaseBinPath\n    ? undefined\n    : Array.isArray(localBaseBinPath)\n      ? localBaseBinPath.map(getLocalBinPath)\n      : [localBaseBinPath].map(getLocalBinPath);\n}\n","import type { PkgService } from \"./services\";\n\nexport function getVersion(pkg: PkgService) {\n  return process.env.VERSION || pkg.packageJson.version;\n}\n"],"mappings":"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","names":["projects","cwd","path","fs","path","cwd","fs"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlandoss/clibuddy",
-  "version": "0.0.5",
+  "version": "0.0.6-git-8d85703.0",
   "description": "A helper library to create CLIs in Variable Land",
   "homepage": "https://github.com/variableland/dx/tree/main/packages/clibuddy#readme",
   "bugs": {

package/src/colors.ts

@@ -12,4 +12,6 @@ export const colors = {
   redBright: safe(chalk.redBright),
   greenBright: safe(chalk.greenBright),
   bold: safe(chalk.bold),
+  muted: safe(chalk.dim),
+  link: safe(chalk.underline),
 };

package/src/services/shell/create.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
-import path from "node:path";
 import { ShellService } from "./shell";
 import type { CreateOptions } from "./types";
+import { getPreferLocal } from "./utils";
 
 export const cwd = fs.realpathSync(process.cwd());
 
@@ -25,8 +25,6 @@ export function quote(arg: string) {
 export const isRaw = (arg: unknown): arg is { stdout: string } =>
   typeof arg === "object" && arg !== null && "stdout" in arg && typeof arg.stdout === "string";
 
-const getLocalBinPath = (dirPath: string) => path.join(dirPath, "node_modules", ".bin");
-
 function defaultQuote(arg: unknown) {
   if (typeof arg === "string") {
     return quote(arg);
@@ -40,11 +38,7 @@ function defaultQuote(arg: unknown) {
 }
 
 export function createShellService(options: CreateOptions = {}) {
-  const preferLocal = !options.localBaseBinPath
-    ? undefined
-    : Array.isArray(options.localBaseBinPath)
-      ? options.localBaseBinPath.map(getLocalBinPath)
-      : [options.localBaseBinPath].map(getLocalBinPath);
+  const preferLocal = getPreferLocal(options.localBaseBinPath);
 
   return new ShellService({
     verbose: true,

package/src/services/shell/shell.ts

@@ -1,5 +1,6 @@
 import { $ as make$ } from "zx";
 import type { Shell, ShellOptions } from "./types";
+import { getPreferLocal } from "./utils";
 
 export class ShellService {
   #shell: Shell;
@@ -18,6 +19,13 @@ export class ShellService {
     return this.#shell;
   }
 
+  child(options: ShellOptions) {
+    return new ShellService({
+      ...this.#options,
+      ...options,
+    });
+  }
+
   quiet(options?: ShellOptions) {
     return this.child({
       ...options,
@@ -26,16 +34,25 @@ export class ShellService {
   }
 
   at(cwd: string, options?: ShellOptions) {
+    const getLocals = (locals: boolean | string | string[] | undefined) =>
+      // NOTE: the boolean handling is done outside when determining preferLocal
+      typeof locals === "boolean" ? [] : typeof locals === "undefined" ? [] : Array.isArray(locals) ? locals : [locals];
+
+    const cwdPreferLocal = getPreferLocal(cwd);
+
+    const preferLocal =
+      options?.preferLocal === false
+        ? false
+        : [
+            ...getLocals(this.#options.preferLocal),
+            ...getLocals(options?.preferLocal),
+            ...(cwdPreferLocal ? cwdPreferLocal : []),
+          ];
+
     return this.child({
       ...options,
       cwd,
-    });
-  }
-
-  child(options: ShellOptions) {
-    return new ShellService({
-      ...this.#options,
-      ...options,
+      preferLocal,
     });
   }
 }

package/src/services/shell/utils.ts

@@ -1,5 +1,16 @@
+import path from "node:path";
 import { ProcessOutput } from "zx";
 
 export function isProcessOutput(value: unknown): value is ProcessOutput {
   return value instanceof ProcessOutput;
 }
+
+const getLocalBinPath = (dirPath: string) => path.join(dirPath, "node_modules", ".bin");
+
+export function getPreferLocal(localBaseBinPath: string | Array<string> | undefined) {
+  return !localBaseBinPath
+    ? undefined
+    : Array.isArray(localBaseBinPath)
+      ? localBaseBinPath.map(getLocalBinPath)
+      : [localBaseBinPath].map(getLocalBinPath);
+}