binary-collections 2.0.11 → 2.0.13

package/binaries/test-esm.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/test-esm.cmd

@@ -0,0 +1,23 @@
+@echo off
+setlocal
+
+:: Detect GitHub Actions or GitLab CI
+set "CI_ARG="
+
+if defined GITHUB_ACTIONS (
+    set "CI_ARG=--ci"
+)
+
+if defined GITLAB_CI (
+    set "CI_ARG=--ci"
+)
+
+node --experimental-vm-modules node_modules/jest/bin/jest.js ^
+  --runInBand ^
+  --forceExit ^
+  --testTimeout=120000 ^
+  --testPathIgnorePatterns="\\.(ts|js|cjs)$" ^
+  %CI_ARG% ^
+  %*
+
+endlocal

package/binaries/yarn-clean

@@ -29,4 +29,4 @@ fi
 
 echo "Using script: $TARGET"
 
-python "$TARGET" "$@"
+"$SCRIPT_DIR/py" "$TARGET" "$@"

package/binaries/yarn-clean.cjs

@@ -12,9 +12,11 @@
  * - fs:
  *   Used to check whether files exist.
  */
-const { spawnSync } = require("child_process");
-const path = require("path");
-const fs = require("fs");
+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
@@ -49,7 +51,7 @@ const base = path.basename(__filename, path.extname(__filename));
  *   .sh
  *   executable file without extension
  */
-const candidates = process.platform === "win32" ? [".cmd", ".bat", ".ps1", ".vbs"] : [".sh", ""];
+const candidates = process.platform === 'win32' ? ['.cmd', '.bat', '.ps1', '.vbs'] : ['.sh', ''];
 
 /**
  * Search for the first matching script
@@ -72,13 +74,32 @@ let found = null;
 
 for (const ext of candidates) {
   const script = path.join(binDir, base + ext);
-
-  if (fs.existsSync(script)) {
+  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.
@@ -92,8 +113,9 @@ if (!found) {
  * Detect special script types
  * that require a shell/interpreter.
  */
-const isPs1 = found.endsWith(".ps1");
-const isCmd = found.endsWith(".cmd");
+const isPs1 = found.endsWith('.ps1');
+const isCmd = found.endsWith('.cmd');
+const isUnixShell = found.endsWith('.sh') || path.extname(found) === '';
 
 /**
  * cmd
@@ -124,9 +146,9 @@ let cmd, args;
  *   Forward all user-provided command-line arguments.
  */
 if (isPs1) {
-  cmd = "powershell.exe";
+  cmd = 'powershell.exe';
 
-  args = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", found, ...process.argv.slice(2)];
+  args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', found, ...process.argv.slice(2)];
 
   /**
    * CMD batch files:
@@ -137,9 +159,9 @@ if (isPs1) {
    *   "execute command and terminate"
    */
 } else if (isCmd) {
-  cmd = "cmd.exe";
+  cmd = 'cmd.exe';
 
-  args = ["/c", found, ...process.argv.slice(2)];
+  args = ['/c', found, ...process.argv.slice(2)];
 
   /**
    * Other scripts:
@@ -150,11 +172,65 @@ if (isPs1) {
    *
    * 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.
  *
@@ -165,7 +241,7 @@ if (isPs1) {
  * spawnSync waits until the child process exits.
  */
 const result = spawnSync(cmd, args, {
-  stdio: "inherit"
+  stdio: 'inherit'
 });
 
 /**

package/binaries/yarn-clean.cmd

@@ -27,4 +27,4 @@ if "%TARGET%"=="" (
 echo Using script: %TARGET%
 
 REM Run Python script with all arguments
-python "%TARGET%" %*
+"%SCRIPT_DIR%py.cmd" "%TARGET%" %*

package/binaries/yarn-clean.py

@@ -9,6 +9,15 @@ import glob
 from typing import Union
 
 
+# -------------------------
+# IGNORE RULES
+# -------------------------
+IGNORE_DIR_NAMES = {".git", "tmp", "dist", "build", "out", "coverage", ".cache"}
+
+
+# -------------------------
+# DELETE HELPERS
+# -------------------------
 def delete_dir(path: Path) -> tuple[str, Path]:
     shutil.rmtree(path, ignore_errors=True)
     return ("dir", path)
@@ -19,6 +28,9 @@ def delete_file(path: Path) -> tuple[str, Path]:
     return ("file", path)
 
 
+# -------------------------
+# CLEAN FUNCTION
+# -------------------------
 def clean(base_dir: Union[str, Path]) -> None:
     root = Path(base_dir).resolve()
 
@@ -27,14 +39,20 @@ def clean(base_dir: Union[str, Path]) -> None:
 
     print(f"Scanning: {root}")
 
-    # Collect targets
     for current_root, dirs, files in os.walk(root, topdown=True):
         current = Path(current_root)
 
+        # -------------------------
+        # IGNORE DIRECTORIES
+        # -------------------------
+        dirs[:] = [
+            d for d in dirs
+            if d not in IGNORE_DIR_NAMES and not d.startswith(".deploy_")
+        ]
+
+        # Skip node_modules scanning deeper
         if "node_modules" in dirs:
             node_modules_dirs.append(current / "node_modules")
-
-            # Prevent recursive scan into node_modules
             dirs.remove("node_modules")
 
         if "yarn.lock" in files:
@@ -71,15 +89,13 @@ def clean(base_dir: Union[str, Path]) -> None:
     print(f"Deleted yarn.lock:   {deleted_files}")
 
 
+# -------------------------
+# WORKSPACE COLLECTOR
+# -------------------------
 def collect_workspace_dirs(
     start_root: Union[str, Path],
     include_start_root: bool = False,
 ) -> list[Path]:
-    """Return workspace package directories sorted by longest path first.
-
-    This walks workspace globs declared in each package.json it finds,
-    recursively, stopping at directories already visited to avoid cycles.
-    """
     visited = set()
     results = set()
 
@@ -120,7 +136,7 @@ def collect_workspace_dirs(
             for m in matches:
                 p = Path(m)
 
-                # Skip symlinked package directories; do not follow them
+                # skip symlinks
                 if p.is_symlink():
                     continue
 
@@ -129,20 +145,22 @@ def collect_workspace_dirs(
                 if p_res.is_dir() and p_res not in visited:
                     stack.append(p_res)
 
-    return sorted(
-        results,
-        key=lambda p: (len(p.parts), str(p)),
-        reverse=True,
-    )
+    return sorted(results, key=lambda p: (len(p.parts), str(p)), reverse=True)
 
 
+# -------------------------
+# MAIN
+# -------------------------
 if __name__ == "__main__":
     workspace_dirs = collect_workspace_dirs(Path("."))
+
     for d in workspace_dirs:
         if Path(d / "node_modules").is_dir() or (d / "yarn.lock").is_file():
             print(f"Cleaning workspace package: {d}")
             clean(d)
         else:
             print(f"Skipping workspace package (no node_modules or yarn.lock): {d}")
+
+    # root cleanup
     shutil.rmtree(Path(".") / "node_modules", ignore_errors=True)
-    (Path(".") / "yarn.lock").unlink(missing_ok=True)
+    (Path(".") / "yarn.lock").unlink(missing_ok=True)

package/binaries/yc

@@ -0,0 +1,131 @@
+#!/bin/bash
+set -u
+
+cwd="$(pwd)"
+max_jobs=4
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Options:
+  -h, --help               Show this help message
+  -c, --concurrent <num>   Maximum parallel jobs (default: 4)
+
+Description:
+  Clean node_modules directories grouped by letter (a-z) in parallel.
+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}] $*"
+}
+
+cleanup_letter() {
+  local letter="$1"
+
+  shopt -s nullglob
+
+  local targets=(
+    "${cwd}/node_modules/${letter}"*
+    "${cwd}/node_modules/@types/${letter}"*
+    "${cwd}/node_modules/@${letter}"*
+  )
+
+  local removed_any=0
+
+  for path in "${targets[@]}"; do
+    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 "'${letter}'"
+  fi
+}
+
+export -f cleanup_letter
+export -f log
+export -f timestamp
+export -f relative_path
+
+export cwd
+export GREEN RED GRAY BLUE NC
+
+log INFO "Cleaning $(relative_path "${cwd}/node_modules")"
+
+running=0
+
+for letter in $(printf "%s\n" {a..z} | shuf); do
+  cleanup_letter "$letter" &
+
+  ((running++))
+
+  if (( running >= max_jobs )); then
+    wait -n
+    ((running--))
+  fi
+done
+
+wait
+
+log INFO "Removing remaining node_modules"
+
+final_target="${cwd}/node_modules"
+final_rel="$(relative_path "$final_target")"
+
+if rm -rf "$final_target"; then
+  log OK "$final_rel"
+else
+  log FAIL "$final_rel"
+fi
+
+log INFO "Done"