binary-collections 2.0.11 → 2.0.13

package/binaries/yc.cjs

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+/**
+ * Built-in Node.js modules:
+ *
+ * - child_process:
+ *   Used to launch external scripts/programs.
+ *
+ * - path:
+ *   Safely handles file paths across operating systems.
+ *
+ * - fs:
+ *   Used to check whether files exist.
+ */
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const which = require('which');
+const { isWindows } = require('../src/utils/isWindows.js');
+
+/**
+ * __dirname
+ *   Absolute directory path of this launcher script.
+ *
+ * __filename
+ *   Absolute path of this launcher file itself.
+ *
+ * base
+ *   Filename without extension.
+ *
+ * Example:
+ *   File = "/tools/mytool.js"
+ *
+ *   binDir = "/tools"
+ *   base   = "mytool"
+ */
+const binDir = __dirname;
+const base = path.basename(__filename, path.extname(__filename));
+
+/**
+ * Determine which script extensions to search for
+ * based on the current operating system.
+ *
+ * Windows:
+ *   .cmd
+ *   .bat
+ *   .ps1
+ *   .vbs
+ *
+ * Linux/macOS:
+ *   .sh
+ *   executable file without extension
+ */
+const candidates = process.platform === 'win32' ? ['.cmd', '.bat', '.ps1', '.vbs'] : ['.sh', ''];
+
+/**
+ * Search for the first matching script
+ * in the same directory as this launcher.
+ *
+ * Example:
+ *   If base = "mytool"
+ *
+ *   Windows checks:
+ *     mytool.cmd
+ *     mytool.bat
+ *     mytool.ps1
+ *     mytool.vbs
+ *
+ *   Linux/macOS checks:
+ *     mytool.sh
+ *     mytool
+ */
+let found = null;
+
+for (const ext of candidates) {
+  const script = path.join(binDir, base + ext);
+  const exists = fs.existsSync(script);
+  // console.log(`Checking for ${script}: ${exists ? 'found' : 'not found'}`);
+  if (exists) {
+    found = script;
+    break;
+  }
+}
+
+/**
+ * If no matching script was found,
+ * try check if `bash` is available and if so, check for a .sh script.
+ */
+if (!found) {
+  try {
+    spawnSync('bash', ['--version'], { stdio: 'ignore' });
+    const bashScript = [path.join(binDir, base), path.join(binDir, base + '.sh')].find((script) =>
+      fs.existsSync(script)
+    );
+    if (bashScript) {
+      found = bashScript;
+    }
+  } catch {
+    // bash is not available, do nothing
+  }
+}
+
+/**
+ * If no matching script was found,
+ * print an error and exit with failure code 1.
+ */
+if (!found) {
+  console.error(`No script found for ${base} in ${binDir}`);
+  process.exit(1);
+}
+
+/**
+ * Detect special script types
+ * that require a shell/interpreter.
+ */
+const isPs1 = found.endsWith('.ps1');
+const isCmd = found.endsWith('.cmd');
+const isUnixShell = found.endsWith('.sh') || path.extname(found) === '';
+
+/**
+ * cmd
+ *   The executable program to launch.
+ *
+ * args
+ *   Arguments passed to the executable.
+ */
+let cmd, args;
+
+/**
+ * PowerShell scripts:
+ *
+ * Run through powershell.exe because .ps1 files
+ * are not directly executable like binaries.
+ *
+ * Flags:
+ *   -NoProfile
+ *     Prevent loading user profile scripts.
+ *
+ *   -ExecutionPolicy Bypass
+ *     Allow script execution even if policy blocks it.
+ *
+ *   -File
+ *     Specifies the script to execute.
+ *
+ * process.argv.slice(2)
+ *   Forward all user-provided command-line arguments.
+ */
+if (isPs1) {
+  cmd = 'powershell.exe';
+
+  args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', found, ...process.argv.slice(2)];
+
+  /**
+   * CMD batch files:
+   *
+   * Run through cmd.exe using:
+   *   /c
+   * which means:
+   *   "execute command and terminate"
+   */
+} else if (isCmd) {
+  cmd = 'cmd.exe';
+
+  args = ['/c', found, ...process.argv.slice(2)];
+
+  /**
+   * Other scripts:
+   *
+   * Usually:
+   *   - shell scripts (.sh)
+   *   - executable binaries
+   *
+   * These can be executed directly.
+   */
+} else if (isUnixShell) {
+  // Capture shebang scripts (no extension) and .sh scripts
+  const shebang = fs.readFileSync(found, 'utf8').split('\n')[0].trim();
+  const interpreter = shebang.startsWith('#!')
+    ? shebang
+        .slice(2)
+        .trim()
+        .replace(/^\/usr\/bin\/env\s+/, '')
+        .replace(/^\/bin\/env\s+/, '')
+        .replace(/^\/usr\/bin\//, '')
+        .replace(/^\/bin\//, '')
+    : null;
+
+  if (interpreter) {
+    const resolvedOrNull = which.sync(interpreter, { nothrow: true });
+    if (!resolvedOrNull) {
+      if (['bash', 'sh'].includes(interpreter) && isWindows()) {
+        const locationsToCheck = [
+          'C:\\Program Files\\Git\\usr\\bin',
+          'C:\\Program Files\\Git\\bin',
+          'C:\\Program Files (x86)\\Git\\usr\\bin',
+          'C:\\msys64\\usr\\bin',
+          'C:\\msys64\\bin',
+          'C:\\cygwin64\\bin',
+          'C:\\cygwin\\bin',
+          'C:\\MinGW\\bin',
+          'C:\\MinGW\\msys\\1.0\\bin'
+        ];
+        for (const location of locationsToCheck) {
+          const potentialPath = path.join(location, 'bash.exe');
+          if (fs.existsSync(potentialPath)) {
+            cmd = potentialPath;
+            args = [found, ...process.argv.slice(2)];
+            break;
+          }
+        }
+      }
+    } else {
+      cmd = resolvedOrNull || interpreter;
+      args = [found, ...process.argv.slice(2)];
+    }
+  } else {
+    cmd = found;
+    args = process.argv.slice(2);
+  }
+} else {
+  cmd = found;
+  args = process.argv.slice(2);
+}
+
+console.log(
+  `Executing: ${path.isAbsolute(cmd) ? path.relative(process.cwd(), cmd) : cmd} ${args
+    .map((f) => {
+      if (path.isAbsolute(f)) return path.relative(process.cwd(), f);
+      return f;
+    })
+    .join(' ')}`
+);
+
+/**
+ * Execute the selected script synchronously.
+ *
+ * stdio: "inherit"
+ *   Shares the current terminal with the child process,
+ *   so stdout/stderr/input behave normally.
+ *
+ * spawnSync waits until the child process exits.
+ */
+const result = spawnSync(cmd, args, {
+  stdio: 'inherit'
+});
+
+/**
+ * Exit using the same exit code
+ * returned by the child process.
+ *
+ * If result.status is null/undefined,
+ * default to exit code 1.
+ */
+process.exit(result.status ?? 1);

package/binaries/ycw

@@ -0,0 +1,256 @@
+#!/bin/bash
+set -u
+
+cwd="$(pwd)"
+max_jobs=4
+
+usage() {
+  cat <<'EOF'
+Usage: ycw [options]
+
+Clean node_modules directories across a Yarn monorepo (workspaces-aware).
+
+This tool:
+  - Automatically detects monorepo root via package.json "workspaces"
+  - Expands workspace globs (e.g. packages/*)
+  - Removes node_modules in root + all workspace packages
+  - Runs partial cleanup in parallel for speed
+
+Options:
+  -h, --help              Show this help message and exit
+  -c, --concurrent <num>  Maximum parallel jobs (default: 4)
+
+Behavior:
+  • Root is detected by scanning upward for package.json with "workspaces"
+  • Workspace patterns are read from package.json (no jq required)
+  • node_modules folders are removed in two phases:
+       1. Partial cleanup (letter-based parallel deletion)
+       2. Final full removal of remaining node_modules directories
+
+Notes:
+  - Designed for Yarn workspaces monorepos
+  - Safe fallback: if no root is detected, current directory is used
+  - Uses rm -rf (destructive operation)
+
+Example:
+  ycw
+  ycw --help
+  ycw -c 8
+
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help) usage; exit 0 ;;
+    -c|--concurrent) max_jobs="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+# colors
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+GRAY='\033[0;90m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+timestamp() {
+  date "+%Y-%m-%d %H:%M:%S"
+}
+
+relative_path() {
+  local path="$1"
+  path="${path#"$cwd"/}"
+  [[ "$path" == "$cwd" ]] && path="."
+  echo "$path"
+}
+
+log() {
+  local level="$1"
+  shift
+
+  local color="$NC"
+  case "$level" in
+    OK) color="$GREEN" ;;
+    FAIL) color="$RED" ;;
+    SKIP) color="$GRAY" ;;
+    INFO) color="$BLUE" ;;
+  esac
+
+  echo -e "[${GRAY}$(timestamp)${NC}] [${color}${level}${NC}] $*"
+}
+
+# -----------------------------------
+# find project root (NO GIT)
+# -----------------------------------
+find_root() {
+  local dir="$cwd"
+
+  while [[ "$dir" != "/" ]]; do
+    if [[ -f "$dir/package.json" ]] && grep -q '"workspaces"' "$dir/package.json" 2>/dev/null; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+
+  echo "$cwd"
+}
+
+ROOT="$(find_root)"
+cwd="$ROOT"
+
+log INFO "Using root: $(relative_path "$ROOT")"
+
+# -----------------------------------
+# parse workspaces from package.json
+# -----------------------------------
+get_workspaces() {
+  local pkg="$ROOT/package.json"
+
+  # naive JSON parsing (no jq required)
+  # supports:
+  # "workspaces": ["packages/*"] OR { "packages": [] }
+
+  grep -oP '"workspaces"\s*:\s*\K\[[^\]]+\]' "$pkg" 2>/dev/null |
+  tr -d '[]"' |
+  tr ',' '\n' |
+  sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
+}
+
+# -----------------------------------
+# expand glob patterns safely
+# -----------------------------------
+expand_glob() {
+  local pattern="$1"
+
+  for dir in $pattern; do
+    [[ -d "$dir" ]] && echo "$ROOT/$dir"
+  done
+}
+
+# -----------------------------------
+# collect node_modules targets
+# -----------------------------------
+declare -a NODE_MODULES_TARGETS
+
+# root
+NODE_MODULES_TARGETS+=("$ROOT/node_modules")
+
+# workspaces
+while IFS= read -r pattern; do
+  [[ -z "$pattern" ]] && continue
+
+  while IFS= read -r ws; do
+    NODE_MODULES_TARGETS+=("$ws/node_modules")
+  done < <(expand_glob "$pattern")
+
+done < <(get_workspaces)
+
+# -----------------------------------
+# deduplicate
+# -----------------------------------
+declare -A seen
+declare -a unique
+
+for t in "${NODE_MODULES_TARGETS[@]}"; do
+  [[ -z "$t" ]] && continue
+  [[ -n "${seen[$t]:-}" ]] && continue
+  seen["$t"]=1
+  unique+=("$t")
+done
+
+NODE_MODULES_TARGETS=("${unique[@]}")
+
+# -----------------------------------
+# cleanup function
+# -----------------------------------
+cleanup_letter() {
+  local base="$1"
+  local letter="$2"
+
+  [[ -d "$base" ]] || return 0
+
+  shopt -s nullglob
+
+  local targets=(
+    "${base}/${letter}"*
+    "${base}/@types/${letter}"*
+    "${base}/@${letter}"*
+  )
+
+  local removed_any=0
+
+  for path in "${targets[@]}"; do
+    [[ -e "$path" ]] || continue
+
+    local rel
+    rel="$(relative_path "$path")"
+
+    if rm -rf "$path"; then
+      log OK "$rel"
+      removed_any=1
+    else
+      log FAIL "$rel"
+    fi
+  done
+
+  if (( removed_any == 0 )); then
+    log SKIP "$(relative_path "$base") '${letter}'"
+  fi
+}
+
+# export for parallel
+export -f cleanup_letter
+export -f log
+export -f timestamp
+export -f relative_path
+export cwd GREEN RED GRAY BLUE NC ROOT
+
+log INFO "Detected ${#NODE_MODULES_TARGETS[@]} node_modules directories"
+
+for t in "${NODE_MODULES_TARGETS[@]}"; do
+  log INFO "$(relative_path "$t")"
+done
+
+# -----------------------------------
+# parallel deletion
+# -----------------------------------
+running=0
+
+for base in "${NODE_MODULES_TARGETS[@]}"; do
+  for letter in $(printf "%s\n" {a..z} | shuf); do
+
+    cleanup_letter "$base" "$letter" &
+
+    ((running++))
+
+    if (( running >= max_jobs )); then
+      wait -n
+      ((running--))
+    fi
+
+  done
+done
+
+wait
+
+# -----------------------------------
+# final cleanup
+# -----------------------------------
+log INFO "Removing remaining node_modules directories"
+
+for target in "${NODE_MODULES_TARGETS[@]}"; do
+  [[ -e "$target" ]] || continue
+
+  rel="$(relative_path "$target")"
+
+  if rm -rf "$target"; then
+    log OK "$rel"
+  else
+    log FAIL "$rel"
+  fi
+done
+
+log INFO "Done"