binary-collections 2.0.12 → 2.0.14

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"

package/binaries/ycw.cjs

@@ -0,0 +1,323 @@
+#!/usr/bin/env node
+'use strict';
+
+var require$$0 = require('child_process');
+var require$$1 = require('path');
+var require$$2 = require('fs');
+var require$$3 = require('which');
+
+function getDefaultExportFromCjs (x) {
+	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+}
+
+function getAugmentedNamespace(n) {
+  if (Object.prototype.hasOwnProperty.call(n, '__esModule')) return n;
+  var f = n.default;
+	if (typeof f == "function") {
+		var a = function a () {
+			var isInstance = false;
+      try {
+        isInstance = this instanceof a;
+      } catch (e) {}
+			if (isInstance) {
+        return Reflect.construct(f, arguments, this.constructor);
+			}
+			return f.apply(this, arguments);
+		};
+		a.prototype = f.prototype;
+  } else a = {};
+  Object.defineProperty(a, '__esModule', {value: true});
+	Object.keys(n).forEach(function (k) {
+		var d = Object.getOwnPropertyDescriptor(n, k);
+		Object.defineProperty(a, k, d.get ? d : {
+			enumerable: true,
+			get: function () {
+				return n[k];
+			}
+		});
+	});
+	return a;
+}
+
+var binaryExecutor$1 = {};
+
+/**
+ * Determines if the current platform is Windows
+ * @returns {boolean} true if running on Windows, false otherwise
+ */
+function isWindows() {
+  return process.platform === 'win32' || /^(msys|cygwin)$/.test(process.env.OSTYPE || '');
+}
+
+var isWindows$1 = /*#__PURE__*/Object.freeze({
+	__proto__: null,
+	isWindows: isWindows
+});
+
+var require$$4 = /*@__PURE__*/getAugmentedNamespace(isWindows$1);
+
+var hasRequiredBinaryExecutor;
+
+function requireBinaryExecutor () {
+	if (hasRequiredBinaryExecutor) return binaryExecutor$1;
+	hasRequiredBinaryExecutor = 1;
+	/**
+	 * 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$$0;
+	const path = require$$1;
+	const fs = require$$2;
+	const which = require$$3;
+	const { isWindows } = require$$4;
+
+	/**
+	 * __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);
+	return binaryExecutor$1;
+}
+
+var binaryExecutorExports = requireBinaryExecutor();
+var binaryExecutor = /*@__PURE__*/getDefaultExportFromCjs(binaryExecutorExports);
+
+module.exports = binaryExecutor;
+//# sourceMappingURL=binary-executor.cjs.map

package/docs-src/binary-collections.md

@@ -0,0 +1,34 @@
+## Binary Collections (Main Dispatcher)
+
+The main entry point that dynamically finds and executes other scripts by name.
+
+### Usage
+
+```bash
+npx --legacy-peer-deps -y binary-collections <script-name> [...args]
+```
+
+### Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `list` | List all available scripts |
+| `<script-name>` | Find and execute a script by name |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+npx --legacy-peer-deps -y binary-collections list
+npx --legacy-peer-deps -y binary-collections git-diff -s
+npx --legacy-peer-deps -y binary-collections del-node-modules --force
+npx --legacy-peer-deps -y binary-collections find-node-modules
+```
+
+### Development
+
+When developing locally, use `bc <commandName>` (`bin/bc` on Unix or `bin/bc.cmd` on Windows). Its usage is the same as `binary-collections <commandName>`.
+
+### Source
+
+See [`src/binary-collections.cjs`](../src/binary-collections.cjs) & [`bin/bc`](../bin/bc).

package/docs-src/changelog.md

@@ -0,0 +1,26 @@
+## Changelog Generator
+
+Generates a `CHANGELOG.md` file from git commit history, grouped by version bumps.
+
+### Usage
+
+```bash
+changelog
+```
+
+### Description
+
+- Analyzes git commit history looking for version bumps
+- Groups commits by version
+- Skips dependabot and irrelevant commits
+- Outputs the original git log to `tmp/original.md` for reference
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+
+### Source
+
+See [`src/changelog.cjs`](../src/changelog.cjs)