@vlandoss/clibuddy 0.0.1

package/README.md

@@ -0,0 +1,9 @@
+# Clibuddy
+
+A helper library to create CLIs in Variable Land
+
+## Installation
+
+```sh
+pnpm add @vlandoss/clibuddy
+```

package/dist/index.cjs

@@ -0,0 +1,158 @@
+"use strict";
+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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PkgService: () => PkgService,
+  ShellService: () => ShellService,
+  colors: () => colors,
+  createPkgService: () => createPkgService,
+  createShellService: () => createShellService,
+  cwd: () => cwd,
+  getVersion: () => getVersion,
+  isRaw: () => isRaw,
+  quote: () => quote
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/colors.ts
+var import_chalk = __toESM(require("chalk"), 1);
+var import_supports_color = __toESM(require("supports-color"), 1);
+var colorIsSupported = () => import_supports_color.default.stdout && !Bun.env.NO_COLOR;
+var identity = (x) => x;
+var safe = (style) => colorIsSupported() ? style : identity;
+var colors = {
+  blueBright: safe(import_chalk.default.blueBright),
+  redBright: safe(import_chalk.default.redBright),
+  greenBright: safe(import_chalk.default.greenBright)
+};
+
+// src/services/pkg.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_read_package_up = require("read-package-up");
+var PkgService = class {
+  #packageJson;
+  #dirPath;
+  get dirPath() {
+    return this.#dirPath;
+  }
+  get packageJson() {
+    return this.#packageJson;
+  }
+  constructor(packageJson, pkgPath) {
+    this.#packageJson = packageJson;
+    this.#dirPath = import_node_path.default.dirname(pkgPath);
+  }
+  hasFile(name) {
+    return import_node_fs.default.existsSync(this.#fromApp(name));
+  }
+  #fromApp(...args) {
+    return import_node_path.default.join(this.#dirPath, ...args);
+  }
+  info() {
+    return {
+      packageJson: this.#packageJson,
+      dirPath: this.#dirPath
+    };
+  }
+};
+async function createPkgService(cwd2) {
+  const searchResult = await (0, import_read_package_up.readPackageUp)({ cwd: cwd2 });
+  if (!searchResult) {
+    return null;
+  }
+  const { packageJson, path: path3 } = searchResult;
+  return new PkgService(packageJson, path3);
+}
+
+// src/services/shell/shell.ts
+var import_zx = require("zx");
+var ShellService = class {
+  #shell;
+  constructor(options) {
+    this.#shell = Object.assign((0, import_zx.$)(options), {
+      quiet: (0, import_zx.$)({ ...options, verbose: false })
+    });
+  }
+  get $() {
+    return this.#shell;
+  }
+};
+
+// src/services/shell/create.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+var cwd = import_node_fs2.default.realpathSync(process.cwd());
+function quote(arg) {
+  if (/^[\w./:=@-]+$/i.test(arg) || arg === "") {
+    return 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);
+  }
+  if (isRaw(arg)) {
+    return arg.stdout;
+  }
+  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);
+  return new ShellService({
+    verbose: true,
+    cwd,
+    preferLocal,
+    quote: defaultQuote,
+    ...options
+  });
+}
+
+// src/version.ts
+function getVersion(pkg) {
+  return Bun.env.VERSION || pkg.packageJson.version;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PkgService,
+  ShellService,
+  colors,
+  createPkgService,
+  createShellService,
+  cwd,
+  getVersion,
+  isRaw,
+  quote
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/colors.ts","../src/services/pkg.ts","../src/services/shell/shell.ts","../src/services/shell/create.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 && !Bun.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};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { type NormalizedPackageJson, readPackageUp } from \"read-package-up\";\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  hasFile(name: string) {\n    return fs.existsSync(this.#fromApp(name));\n  }\n\n  #fromApp(...args: string[]) {\n    return path.join(this.#dirPath, ...args);\n  }\n\n  info() {\n    return {\n      packageJson: this.#packageJson,\n      dirPath: this.#dirPath,\n    };\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 { type Options as ZxOptions, type Shell as ZxShell, $ as make$ } from \"zx\";\n\ntype ShellOptions = Partial<ZxOptions>;\n\nexport type Shell = ZxShell & { quiet: ZxShell };\n\nexport class ShellService {\n  #shell: Shell;\n\n  constructor(options: ShellOptions) {\n    this.#shell = Object.assign(make$(options), {\n      quiet: make$({ ...options, verbose: false }),\n    });\n  }\n\n  get $() {\n    return this.#shell;\n  }\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ShellService } from \"./shell\";\n\ntype CreateOptions = {\n  localBaseBinPath?: string | Array<string>;\n};\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 type { PkgService } from \"./services\";\n\nexport function getVersion(pkg: PkgService) {\n  return Bun.env.VERSION || pkg.packageJson.version;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAA0C;AAC1C,4BAA0B;AAG1B,IAAM,mBAAmB,MAAM,sBAAAA,QAAc,UAAU,CAAC,IAAI,IAAI;AAEhE,IAAM,WAAW,CAAI,MAAS;AAC9B,IAAM,OAAO,CAAC,UAA0B,iBAAiB,IAAI,QAAQ;AAE9D,IAAM,SAAS;AAAA,EACpB,YAAY,KAAK,aAAAC,QAAM,UAAU;AAAA,EACjC,WAAW,KAAK,aAAAA,QAAM,SAAS;AAAA,EAC/B,aAAa,KAAK,aAAAA,QAAM,WAAW;AACrC;;;ACbA,qBAAe;AACf,uBAAiB;AACjB,6BAA0D;AAEnD,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,iBAAAC,QAAK,QAAQ,OAAO;AAAA,EACtC;AAAA,EAEA,QAAQ,MAAc;AACpB,WAAO,eAAAC,QAAG,WAAW,KAAK,SAAS,IAAI,CAAC;AAAA,EAC1C;AAAA,EAEA,YAAY,MAAgB;AAC1B,WAAO,iBAAAD,QAAK,KAAK,KAAK,UAAU,GAAG,IAAI;AAAA,EACzC;AAAA,EAEA,OAAO;AACL,WAAO;AAAA,MACL,aAAa,KAAK;AAAA,MAClB,SAAS,KAAK;AAAA,IAChB;AAAA,EACF;AACF;AAEA,eAAsB,iBAAiBE,MAAyC;AAC9E,QAAM,eAAe,UAAM,sCAAc,EAAE,KAAAA,KAAI,CAAC;AAEhD,MAAI,CAAC,cAAc;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,aAAa,MAAAF,MAAK,IAAI;AAE9B,SAAO,IAAI,WAAW,aAAaA,KAAI;AACzC;;;AC/CA,gBAA6E;AAMtE,IAAM,eAAN,MAAmB;AAAA,EACxB;AAAA,EAEA,YAAY,SAAuB;AACjC,SAAK,SAAS,OAAO,WAAO,UAAAG,GAAM,OAAO,GAAG;AAAA,MAC1C,WAAO,UAAAA,GAAM,EAAE,GAAG,SAAS,SAAS,MAAM,CAAC;AAAA,IAC7C,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,IAAI;AACN,WAAO,KAAK;AAAA,EACd;AACF;;;AClBA,IAAAC,kBAAe;AACf,IAAAC,oBAAiB;AAOV,IAAM,MAAM,gBAAAC,QAAG,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,YAAoB,kBAAAC,QAAK,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;;;ACxDO,SAAS,WAAW,KAAiB;AAC1C,SAAO,IAAI,IAAI,WAAW,IAAI,YAAY;AAC5C;","names":["supportsColor","chalk","path","fs","cwd","make$","import_node_fs","import_node_path","fs","path"]}

package/dist/index.d.cts

@@ -0,0 +1,46 @@
+import { ChalkInstance } from 'chalk';
+import { NormalizedPackageJson } from 'read-package-up';
+import { Shell as Shell$1, Options } from 'zx';
+
+declare const colors: {
+    blueBright: (<T>(x: T) => T) | ChalkInstance;
+    redBright: (<T>(x: T) => T) | ChalkInstance;
+    greenBright: (<T>(x: T) => T) | ChalkInstance;
+};
+
+declare class PkgService {
+    #private;
+    get dirPath(): string;
+    get packageJson(): NormalizedPackageJson;
+    constructor(packageJson: NormalizedPackageJson, pkgPath: string);
+    hasFile(name: string): boolean;
+    info(): {
+        packageJson: NormalizedPackageJson;
+        dirPath: string;
+    };
+}
+declare function createPkgService(cwd: string): Promise<PkgService | null>;
+
+type ShellOptions = Partial<Options>;
+type Shell = Shell$1 & {
+    quiet: Shell$1;
+};
+declare class ShellService {
+    #private;
+    constructor(options: ShellOptions);
+    get $(): Shell;
+}
+
+type CreateOptions = {
+    localBaseBinPath?: string | Array<string>;
+};
+declare const cwd: string;
+declare function quote(arg: string): string;
+declare const isRaw: (arg: unknown) => arg is {
+    stdout: string;
+};
+declare function createShellService(options?: CreateOptions): ShellService;
+
+declare function getVersion(pkg: PkgService): string;
+
+export { PkgService, type Shell, ShellService, colors, createPkgService, createShellService, cwd, getVersion, isRaw, quote };

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import { ChalkInstance } from 'chalk';
+import { NormalizedPackageJson } from 'read-package-up';
+import { Shell as Shell$1, Options } from 'zx';
+
+declare const colors: {
+    blueBright: (<T>(x: T) => T) | ChalkInstance;
+    redBright: (<T>(x: T) => T) | ChalkInstance;
+    greenBright: (<T>(x: T) => T) | ChalkInstance;
+};
+
+declare class PkgService {
+    #private;
+    get dirPath(): string;
+    get packageJson(): NormalizedPackageJson;
+    constructor(packageJson: NormalizedPackageJson, pkgPath: string);
+    hasFile(name: string): boolean;
+    info(): {
+        packageJson: NormalizedPackageJson;
+        dirPath: string;
+    };
+}
+declare function createPkgService(cwd: string): Promise<PkgService | null>;
+
+type ShellOptions = Partial<Options>;
+type Shell = Shell$1 & {
+    quiet: Shell$1;
+};
+declare class ShellService {
+    #private;
+    constructor(options: ShellOptions);
+    get $(): Shell;
+}
+
+type CreateOptions = {
+    localBaseBinPath?: string | Array<string>;
+};
+declare const cwd: string;
+declare function quote(arg: string): string;
+declare const isRaw: (arg: unknown) => arg is {
+    stdout: string;
+};
+declare function createShellService(options?: CreateOptions): ShellService;
+
+declare function getVersion(pkg: PkgService): string;
+
+export { PkgService, type Shell, ShellService, colors, createPkgService, createShellService, cwd, getVersion, isRaw, quote };

package/dist/index.js

@@ -0,0 +1,113 @@
+// src/colors.ts
+import chalk from "chalk";
+import supportsColor from "supports-color";
+var colorIsSupported = () => supportsColor.stdout && !Bun.env.NO_COLOR;
+var identity = (x) => x;
+var safe = (style) => colorIsSupported() ? style : identity;
+var colors = {
+  blueBright: safe(chalk.blueBright),
+  redBright: safe(chalk.redBright),
+  greenBright: safe(chalk.greenBright)
+};
+
+// src/services/pkg.ts
+import fs from "node:fs";
+import path from "node:path";
+import { readPackageUp } from "read-package-up";
+var PkgService = class {
+  #packageJson;
+  #dirPath;
+  get dirPath() {
+    return this.#dirPath;
+  }
+  get packageJson() {
+    return this.#packageJson;
+  }
+  constructor(packageJson, pkgPath) {
+    this.#packageJson = packageJson;
+    this.#dirPath = path.dirname(pkgPath);
+  }
+  hasFile(name) {
+    return fs.existsSync(this.#fromApp(name));
+  }
+  #fromApp(...args) {
+    return path.join(this.#dirPath, ...args);
+  }
+  info() {
+    return {
+      packageJson: this.#packageJson,
+      dirPath: this.#dirPath
+    };
+  }
+};
+async function createPkgService(cwd2) {
+  const searchResult = await readPackageUp({ cwd: cwd2 });
+  if (!searchResult) {
+    return null;
+  }
+  const { packageJson, path: path3 } = searchResult;
+  return new PkgService(packageJson, path3);
+}
+
+// src/services/shell/shell.ts
+import { $ as make$ } from "zx";
+var ShellService = class {
+  #shell;
+  constructor(options) {
+    this.#shell = Object.assign(make$(options), {
+      quiet: make$({ ...options, verbose: false })
+    });
+  }
+  get $() {
+    return this.#shell;
+  }
+};
+
+// src/services/shell/create.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+var cwd = fs2.realpathSync(process.cwd());
+function quote(arg) {
+  if (/^[\w./:=@-]+$/i.test(arg) || arg === "") {
+    return 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);
+  }
+  if (isRaw(arg)) {
+    return arg.stdout;
+  }
+  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);
+  return new ShellService({
+    verbose: true,
+    cwd,
+    preferLocal,
+    quote: defaultQuote,
+    ...options
+  });
+}
+
+// src/version.ts
+function getVersion(pkg) {
+  return Bun.env.VERSION || pkg.packageJson.version;
+}
+export {
+  PkgService,
+  ShellService,
+  colors,
+  createPkgService,
+  createShellService,
+  cwd,
+  getVersion,
+  isRaw,
+  quote
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/colors.ts","../src/services/pkg.ts","../src/services/shell/shell.ts","../src/services/shell/create.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 && !Bun.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};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { type NormalizedPackageJson, readPackageUp } from \"read-package-up\";\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  hasFile(name: string) {\n    return fs.existsSync(this.#fromApp(name));\n  }\n\n  #fromApp(...args: string[]) {\n    return path.join(this.#dirPath, ...args);\n  }\n\n  info() {\n    return {\n      packageJson: this.#packageJson,\n      dirPath: this.#dirPath,\n    };\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 { type Options as ZxOptions, type Shell as ZxShell, $ as make$ } from \"zx\";\n\ntype ShellOptions = Partial<ZxOptions>;\n\nexport type Shell = ZxShell & { quiet: ZxShell };\n\nexport class ShellService {\n  #shell: Shell;\n\n  constructor(options: ShellOptions) {\n    this.#shell = Object.assign(make$(options), {\n      quiet: make$({ ...options, verbose: false }),\n    });\n  }\n\n  get $() {\n    return this.#shell;\n  }\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ShellService } from \"./shell\";\n\ntype CreateOptions = {\n  localBaseBinPath?: string | Array<string>;\n};\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 type { PkgService } from \"./services\";\n\nexport function getVersion(pkg: PkgService) {\n  return Bun.env.VERSION || pkg.packageJson.version;\n}\n"],"mappings":"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","names":["cwd","path","fs","path","fs","path"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@vlandoss/clibuddy",
+  "version": "0.0.1",
+  "description": "A helper library to create CLIs in Variable Land",
+  "homepage": "https://github.com/variableland/dx/tree/main/packages/clibuddy#readme",
+  "bugs": {
+    "url": "https://github.com/variableland/dx/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/variableland/dx.git"
+  },
+  "license": "MIT",
+  "author": "rcrd <rcrd@variable.land>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./test-helpers": {
+      "bun": "./test-helpers/index.ts"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "chalk": "5.4.1",
+    "read-package-up": "11.0.0",
+    "supports-color": "10.0.0",
+    "zx": "8.4.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "rr tsc"
+  }
+}

package/src/colors.ts

@@ -0,0 +1,14 @@
+import chalk, { type ChalkInstance } from "chalk";
+import supportsColor from "supports-color";
+
+// https://no-color.org/
+const colorIsSupported = () => supportsColor.stdout && !Bun.env.NO_COLOR;
+
+const identity = <T>(x: T) => x;
+const safe = (style: ChalkInstance) => (colorIsSupported() ? style : identity);
+
+export const colors = {
+  blueBright: safe(chalk.blueBright),
+  redBright: safe(chalk.redBright),
+  greenBright: safe(chalk.greenBright),
+};

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./colors";
+export * from "./services";
+export * from "./version";

package/src/services/index.ts

@@ -0,0 +1,2 @@
+export * from "./pkg";
+export * from "./shell";

package/src/services/pkg.ts

@@ -0,0 +1,48 @@
+import fs from "node:fs";
+import path from "node:path";
+import { type NormalizedPackageJson, readPackageUp } from "read-package-up";
+
+export class PkgService {
+  #packageJson: NormalizedPackageJson;
+  #dirPath: string;
+
+  get dirPath() {
+    return this.#dirPath;
+  }
+
+  get packageJson() {
+    return this.#packageJson;
+  }
+
+  constructor(packageJson: NormalizedPackageJson, pkgPath: string) {
+    this.#packageJson = packageJson;
+    this.#dirPath = path.dirname(pkgPath);
+  }
+
+  hasFile(name: string) {
+    return fs.existsSync(this.#fromApp(name));
+  }
+
+  #fromApp(...args: string[]) {
+    return path.join(this.#dirPath, ...args);
+  }
+
+  info() {
+    return {
+      packageJson: this.#packageJson,
+      dirPath: this.#dirPath,
+    };
+  }
+}
+
+export async function createPkgService(cwd: string): Promise<PkgService | null> {
+  const searchResult = await readPackageUp({ cwd });
+
+  if (!searchResult) {
+    return null;
+  }
+
+  const { packageJson, path } = searchResult;
+
+  return new PkgService(packageJson, path);
+}

package/src/services/shell/create.ts

@@ -0,0 +1,59 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ShellService } from "./shell";
+
+type CreateOptions = {
+  localBaseBinPath?: string | Array<string>;
+};
+
+export const cwd = fs.realpathSync(process.cwd());
+
+// Inspired by https://dub.sh/6tiHVgn
+export function quote(arg: string) {
+  if (/^[\w./:=@-]+$/i.test(arg) || arg === "") {
+    return 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");
+}
+
+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);
+  }
+
+  if (isRaw(arg)) {
+    return arg.stdout;
+  }
+
+  throw TypeError(`Unsupported argument type: ${typeof arg}`);
+}
+
+export function createShellService(options: CreateOptions = {}) {
+  const preferLocal = !options.localBaseBinPath
+    ? undefined
+    : Array.isArray(options.localBaseBinPath)
+      ? options.localBaseBinPath.map(getLocalBinPath)
+      : [options.localBaseBinPath].map(getLocalBinPath);
+
+  return new ShellService({
+    verbose: true,
+    cwd,
+    preferLocal,
+    quote: defaultQuote,
+    ...options,
+  });
+}

package/src/services/shell/index.ts

@@ -0,0 +1,2 @@
+export * from "./shell";
+export * from "./create";

package/src/services/shell/shell.ts

@@ -0,0 +1,19 @@
+import { type Options as ZxOptions, type Shell as ZxShell, $ as make$ } from "zx";
+
+type ShellOptions = Partial<ZxOptions>;
+
+export type Shell = ZxShell & { quiet: ZxShell };
+
+export class ShellService {
+  #shell: Shell;
+
+  constructor(options: ShellOptions) {
+    this.#shell = Object.assign(make$(options), {
+      quiet: make$({ ...options, verbose: false }),
+    });
+  }
+
+  get $() {
+    return this.#shell;
+  }
+}

package/src/version.ts

@@ -0,0 +1,5 @@
+import type { PkgService } from "./services";
+
+export function getVersion(pkg: PkgService) {
+  return Bun.env.VERSION || pkg.packageJson.version;
+}