binary-collections 2.0.11 → 2.0.12

package/binaries/yc.cjs

@@ -0,0 +1,178 @@
+#!/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");
+
+/**
+ * __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);
+
+  if (fs.existsSync(script)) {
+    found = script;
+    break;
+  }
+}
+
+/**
+ * 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");
+
+/**
+ * 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 {
+  cmd = found;
+  args = process.argv.slice(2);
+}
+
+/**
+ * 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/lib/binary-collections/config.cjs

@@ -0,0 +1,126 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// node_modules/tsup/assets/cjs_shims.js
+var init_cjs_shims = __esm({
+  "node_modules/tsup/assets/cjs_shims.js"() {
+  }
+});
+
+// src/utils/findEnvFiles.cjs
+var require_findEnvFiles = __commonJS({
+  "src/utils/findEnvFiles.cjs"(exports2, module2) {
+    init_cjs_shims();
+    var fs = require("fs");
+    var path2 = require("path");
+    var glob = require("glob");
+    var DEFAULT_IGNORES = [
+      "**/node_modules/**",
+      "**/.git/**",
+      "**/.yarn/**",
+      "**/.pnpm/**",
+      "**/dist/**",
+      "**/build/**",
+      "**/coverage/**",
+      "**/vendor/**",
+      "**/tmp/**",
+      "**/.cache/**",
+      "**/assets/**",
+      "**/logs/**",
+      "**/output/**",
+      "**/public/**",
+      "**/static/**",
+      "**/temp/**",
+      "**/backup/**",
+      "**/backups/**",
+      "**/examples/**",
+      "**/docs/**",
+      "**/tests/**",
+      "**/__tests__/**",
+      "**/spec/**",
+      "**/__specs__/**",
+      "**/scripts/**",
+      "**/bin/**",
+      "**/hooks/**",
+      "**/config/**",
+      "**/configs/**",
+      "**/settings/**",
+      "**/.vscode/**",
+      "**/.idea/**"
+    ];
+    function findEnvFiles(startDir = process.cwd(), filter) {
+      const found = /* @__PURE__ */ new Set();
+      function addFile(file) {
+        const normalized = path2.normalize(file);
+        if (typeof filter === "function" && !filter(normalized)) {
+          return;
+        }
+        found.add(normalized);
+      }
+      let current = path2.resolve(startDir);
+      while (true) {
+        const envPath = path2.join(current, ".env");
+        if (fs.existsSync(envPath)) {
+          addFile(envPath);
+        }
+        const parent = path2.dirname(current);
+        if (parent === current) {
+          break;
+        }
+        current = parent;
+      }
+      const files = glob.globSync("**/.env*", {
+        cwd: startDir,
+        absolute: true,
+        nodir: true,
+        ignore: DEFAULT_IGNORES
+      });
+      for (const file of files) {
+        addFile(file);
+      }
+      return [...found];
+    }
+    function findEnvWithToken2(startDir = process.cwd(), tokenName = "GITHUB_TOKEN") {
+      const envFiles = findEnvFiles(startDir);
+      return envFiles.find((file) => {
+        try {
+          const content = fs.readFileSync(file, "utf-8");
+          const regex = new RegExp(`^\\s*${tokenName}\\s*=`, "m");
+          return regex.test(content);
+        } catch (err) {
+          console.warn(`Failed to read ${file}: ${err instanceof Error ? err.message : String(err)}`);
+          return false;
+        }
+      });
+    }
+    module2.exports = {
+      DEFAULT_IGNORES,
+      findEnvFiles,
+      findEnvWithToken: findEnvWithToken2,
+      default: findEnvFiles
+    };
+  }
+});
+
+// src/binary-collections/config.cjs
+init_cjs_shims();
+var path = require("path");
+var { findEnvWithToken } = require_findEnvFiles();
+require("dotenv").config({ path: findEnvWithToken(), quiet: true, overwrite: true });
+function getTempDir() {
+  return process.env.TEMP_DIR || path.join(process.cwd(), "tmp");
+}
+function getTempPath(...segments) {
+  return path.join(getTempDir(), ...segments);
+}
+var TEMP_BASE_DIR = getTempDir();
+module.exports = {
+  getTempDir,
+  getTempPath,
+  TEMP_BASE_DIR
+};

package/lib/binary-collections/config.mjs

@@ -0,0 +1,7 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import {
+  require_config
+} from "../chunk-G5UUEWUO.mjs";
+import "../chunk-H44UWUFY.mjs";
+import "../chunk-QQ4A6DLD.mjs";
+export default require_config();

package/lib/binary-collections/executeScript.cjs

@@ -0,0 +1,19 @@
+// src/binary-collections/executeScript.cjs
+var { spawn } = require("child_process");
+function executeScript(scriptPath, args) {
+  console.log(`\u{1F527} Executing script: ${scriptPath} args: ${args.join(" ")}
+`);
+  const child = spawn("node", [scriptPath, ...args], {
+    stdio: "inherit",
+    shell: true
+  });
+  child.on("error", (error) => {
+    console.error(`\u274C Error executing script: ${error.message}`);
+    process.exit(1);
+  });
+  child.on("close", (code) => {
+    process.exit(code);
+  });
+}
+module.exports = executeScript;
+module.exports.default = executeScript;

package/lib/binary-collections/executeScript.d.cts

@@ -0,0 +1,12 @@
+export = executeScript;
+/**
+ * Executes a script file using Node.js with the provided arguments
+ * @function executeScript
+ * @param {string} scriptPath - The absolute path to the script file to execute
+ * @param {string[]} args - Array of arguments to pass to the script
+ * @returns {void} Exits the process when the script execution completes
+ */
+declare function executeScript(scriptPath: string, args: string[]): void;
+declare namespace executeScript {
+    export { executeScript as default };
+}

package/lib/binary-collections/executeScript.mjs

@@ -0,0 +1,6 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import {
+  require_executeScript
+} from "../chunk-PXBMHE7O.mjs";
+import "../chunk-QQ4A6DLD.mjs";
+export default require_executeScript();

package/lib/binary-collections/findScript.cjs

@@ -0,0 +1,284 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "binary-collections",
+      version: "2.0.12",
+      description: "Utility to clean any programming caches and more",
+      keywords: [
+        "cache",
+        "cleaner",
+        "utility"
+      ],
+      homepage: "https://www.webmanajemen.com/",
+      bugs: {
+        url: "https://github.com/dimaslanjaka/bin/issues"
+      },
+      license: "MIT",
+      author: {
+        name: "dimaslanjaka",
+        email: "dimaslanjaka@gmail.com",
+        url: "https://webmanajemen.com"
+      },
+      type: "module",
+      main: "lib/index.js",
+      exports: {
+        ".": {
+          require: {
+            default: "./lib/index.cjs",
+            types: "./lib/index.d.ts"
+          },
+          import: {
+            default: "./lib/index.mjs",
+            types: "./lib/index.d.mts"
+          }
+        },
+        "./package.json": "./package.json"
+      },
+      types: "lib/index.d.ts",
+      files: [
+        "binaries",
+        "lib",
+        "package.json",
+        "readme.md",
+        ".puppeterrc.cjs",
+        "requirements.txt"
+      ],
+      scripts: {
+        build: "tsc -b tsconfig.build.json && npm run build-tsup && npm run build-exports",
+        "build-exports": "node -r ts-node/register -r dotenv/config build.exports.mjs",
+        "build-packages": "yarn workspaces foreach --worktree --exclude=binary-collections --no-private run build",
+        "build-rollup": "rollup -c rollup.config.js",
+        "build-tsup": "node build.tsup.js",
+        clean: "rimraf lib tmp/dist binaries",
+        pack: "node packer.cjs --yarn --filename=bin",
+        prepare: "husky",
+        "puppeteer:browser": "npx -y puppeteer browsers install chrome",
+        test: "test-cjs",
+        "test-coverage": "npm test --coverage --detectOpenHandles",
+        "test-esm": "test-esm",
+        "test-nrs": "npm test -- nrs build-**",
+        "test-watch": "npm test --watch",
+        "update:ncu": "npx npm-check-updates -u --enginesNode --root -x jest -x @types/jest -x babel-jest -x @babel/core -x @babel/preset-env -x @babel/preset-typescript -x ts-jest -x eslint -x @eslint/eslintrc -x @eslint/js -x @typescript-eslint/eslint-plugin -x @typescript-eslint/parser -x eslint-config-prettier -x eslint-plugin-prettier -x typescript-eslint -x prettier -x typescript -x ts-node -x @yarnpkg/core",
+        "update:packer": "curl -L https://github.com/dimaslanjaka/nodejs-package-types/raw/main/packer.js > packer.cjs"
+      },
+      repository: {
+        type: "git",
+        url: "git+https://github.com/dimaslanjaka/bin"
+      },
+      dependencies: {
+        "@yarnpkg/core": "^4.7.0",
+        "ansi-colors": "^4.1.3",
+        axios: "^1.16.1",
+        "cross-spawn": "https://github.com/dimaslanjaka/node-cross-spawn/raw/78b09a1f799430fb251c1b438ec56ce7957674f4/release/cross-spawn.tgz",
+        dotenv: "^17.4.2",
+        "fs-extra": "^11.3.5",
+        "git-command-helper": "https://github.com/dimaslanjaka/git-command-helper/raw/ed17f70eb7444d24bd8eb984a4afe9fd64652838/release/git-command-helper.tgz",
+        glob: "^13.0.6",
+        minimatch: "^10.2.5",
+        minimist: "^1.2.8",
+        "ps-node": "^0.1.6",
+        puppeteer: "^25.0.4",
+        "puppeteer-extra": "^3.3.6",
+        "puppeteer-extra-plugin-stealth": "^2.11.2",
+        "sbg-utility": "https://github.com/dimaslanjaka/static-blog-generator/raw/44e5c7b79b4e60f8c2d34857c27b8ce677d7493e/packages/sbg-utility/release/sbg-utility.tgz",
+        upath: "^3.0.7",
+        yaml: "^2.9.0",
+        yarn: "^1.22.22"
+      },
+      devDependencies: {
+        "@babel/core": "^7.29.0",
+        "@babel/plugin-syntax-import-assertions": "^7.28.6",
+        "@babel/preset-env": "^7.29.2",
+        "@babel/preset-typescript": "^7.28.5",
+        "@dimaslanjaka/eslint-base-config": "^1.0.1",
+        "@rollup/plugin-babel": "^7.0.0",
+        "@rollup/plugin-commonjs": "^29.0.2",
+        "@rollup/plugin-json": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^16.0.3",
+        "@types/babel__core": "^7",
+        "@types/babel__preset-env": "^7",
+        "@types/fs-extra": "^11",
+        "@types/jest": "^30.0.0",
+        "@types/minimist": "^1",
+        "@types/mocha": "^10.0.10",
+        "@types/node": "^25.9.1",
+        "@types/ps-node": "^0",
+        "babel-jest": "^30.4.1",
+        "browser-sync": "^3.0.4",
+        "cross-env": "^10.1.0",
+        globals: "^17.6.0",
+        gulp: "^5.0.1",
+        husky: "^9.1.7",
+        jest: "^30.4.2",
+        "lint-staged": "^17.0.5",
+        marked: "^18.0.4",
+        rimraf: "^6.1.3",
+        rollup: "^4.60.4",
+        "ts-jest": "^29.4.9",
+        "ts-node": "^10.9.2",
+        tsup: "^8.5.1",
+        typescript: "^6.0.3"
+      },
+      directories: {
+        lib: "lib",
+        bin: "binaries"
+      },
+      workspaces: [
+        "packages/*"
+      ],
+      packageManager: "yarn@4.9.2",
+      resolutions: {
+        "@types/through2": "https://github.com/dimaslanjaka/nodejs-package-types/raw/refs/heads/through2/release/types-through2.tgz",
+        "cross-spawn": "https://github.com/dimaslanjaka/node-cross-spawn/raw/78b09a1f799430fb251c1b438ec56ce7957674f4/release/cross-spawn.tgz",
+        "git-command-helper": "https://github.com/dimaslanjaka/git-command-helper/raw/ed17f70eb7444d24bd8eb984a4afe9fd64652838/release/git-command-helper.tgz",
+        "sbg-utility": "https://github.com/dimaslanjaka/static-blog-generator/raw/44e5c7b79b4e60f8c2d34857c27b8ce677d7493e/packages/sbg-utility/release/sbg-utility.tgz",
+        "@dimaslanjaka/eslint-base-config": "https://github.com/dimaslanjaka/eslint-base-config/raw/69ca996fdeaac42c93dd590124996eff58b5d6c2/release/dimaslanjaka-eslint-base-config.tgz"
+      },
+      bin: {
+        "binary-collections": "lib/binary-collections.cjs",
+        "binary-executor": "binaries/binary-executor.cjs",
+        changelog: "lib/changelog.cjs",
+        chatgpt: "lib/free-chatgpt.cjs",
+        "clean-github-actions-cache": "lib/clean-github-actions-caches-cli.cjs",
+        "clean-github-actions-caches": "lib/clean-github-actions-caches-cli.cjs",
+        "clean-nodemodule": "binaries/clean-nodemodule.cjs",
+        "clean-nodemodules": "binaries/clean-nodemodules.cjs",
+        "clear-gh-caches": "lib/clean-github-actions-caches-cli.cjs",
+        "clear-github-actions-cache": "lib/clean-github-actions-caches-cli.cjs",
+        "clear-github-actions-caches": "lib/clean-github-actions-caches-cli.cjs",
+        copy: "lib/file/copy-cli.cjs",
+        "copy-file": "lib/file/copy-cli.cjs",
+        "del-gradle": "lib/del-gradle.cjs",
+        "del-node-modules": "lib/del-node-modules.cjs",
+        "del-nodemodules": "lib/del-node-modules.cjs",
+        "del-ps": "lib/del-ps.cjs",
+        "del-yarn-caches": "lib/del-yarn-caches.cjs",
+        "del-yarncaches": "lib/del-yarn-caches.cjs",
+        dev: "binaries/dev.cjs",
+        "dir-tree": "lib/print-directory-tree.cjs",
+        empty: "binaries/empty.cjs",
+        "exec-node": "lib/node-executor.cjs",
+        "execute-node": "lib/node-executor.cjs",
+        "find-node-modules": "lib/find-node-modules-cli.cjs",
+        "free-chatgpt": "lib/free-chatgpt.cjs",
+        "git-diff": "lib/git-diff-cli.cjs",
+        "git-fix": "lib/git-fix.cjs",
+        "git-purge": "lib/git-purge.cjs",
+        "git-reduce-size": "binaries/git-reduce-size.cjs",
+        "git-undo-commit": "lib/git/undo-commit.cjs",
+        "git-undo-staged": "lib/git/undo-staged.cjs",
+        javakill: "binaries/javakill.cjs",
+        "kill-night-crows": "lib/kill-night-crows.cjs",
+        "kill-process": "binaries/kill-process.cjs",
+        move: "lib/file/move-cli.cjs",
+        "move-file": "lib/file/move-cli.cjs",
+        "node-cache-cleaner": "lib/node-cache-cleaner-cli.cjs",
+        "node-copy": "lib/file/copy-cli.cjs",
+        "node-exec": "lib/node-executor.cjs",
+        "node-executor": "lib/node-executor.cjs",
+        "node-move": "lib/file/move-cli.cjs",
+        nodekill: "binaries/nodekill.cjs",
+        "npm-run-series": "lib/npm-run-series.cjs",
+        nrs: "lib/npm-run-series.cjs",
+        "package-resolutions-updater": "lib/package-resolutions-updater-cli.cjs",
+        "php-cs-fixer-staged": "lib/php-cs-fixer-staged.cjs",
+        "pkg-res-updater": "lib/package-resolutions-updater-cli.cjs",
+        "pkg-resolutions-updater": "lib/package-resolutions-updater-cli.cjs",
+        "print-directory-tree": "lib/print-directory-tree.cjs",
+        "print-tree": "lib/print-directory-tree.cjs",
+        prod: "binaries/prod.cjs",
+        py: "binaries/py.cjs",
+        "remove-module": "lib/remove-module.cjs",
+        "remove-node-module": "lib/rm-node-module-cli.cjs",
+        "remove-node-modules": "lib/rm-node-module-cli.cjs",
+        "rm-node-module": "lib/rm-node-module-cli.cjs",
+        "rm-node-modules": "lib/rm-node-module-cli.cjs",
+        rmfind: "binaries/rmfind.cjs",
+        rmpath: "lib/rmpath.cjs",
+        rmx: "binaries/rmx.cjs",
+        "run-s": "lib/npm-run-series.cjs",
+        "run-series": "lib/npm-run-series.cjs",
+        "submodule-install": "lib/submodule-install.cjs",
+        "submodule-remove": "lib/submodule-remove-cli.cjs",
+        "submodule-token": "binaries/submodule-token.cjs",
+        "test-cjs": "binaries/test-cjs.cjs",
+        "test-esm": "binaries/test-esm.cjs",
+        "undo-commit": "lib/git/undo-commit.cjs",
+        "undo-last-commit": "lib/git/undo-commit.cjs",
+        "undo-staged": "lib/git/undo-staged.cjs",
+        "y-install": "lib/yarn-per-branch-lock-installer.cjs",
+        "yarn-clean": "binaries/yarn-clean.cjs",
+        "yarn-install": "lib/yarn-per-branch-lock-installer.cjs",
+        "yarn-per-branch-lock-installer": "lib/yarn-per-branch-lock-installer.cjs",
+        "yarn-reinstall": "lib/yarn-reinstall.cjs",
+        yc: "binaries/yc.cjs"
+      }
+    };
+  }
+});
+
+// src/binary-collections/findScript.cjs
+var { glob } = require("glob");
+var path = require("upath");
+var fs = require("fs-extra");
+var pkgJson = require_package();
+function findScript(scriptName, searchDir = null) {
+  if (!searchDir) searchDir = path.join(__dirname, "..");
+  let result;
+  const ignorePatterns = [
+    `**/*config*.{cjs,js,mjs}`,
+    `**/utils.{cjs,js,mjs}`,
+    `**/index.{cjs,js,mjs}`,
+    `**/chunk-*.{cjs,js,mjs}`,
+    `**/*.d.{ts,cts,mts}`
+    // ignore TypeScript declaration files
+  ];
+  try {
+    const pattern = `${scriptName}.{cjs,js,mjs}`;
+    const files = glob.sync(pattern, {
+      cwd: searchDir,
+      ignore: ignorePatterns,
+      absolute: true
+    });
+    if (files.length > 0) {
+      result = files[0];
+    } else {
+      if (pkgJson.bin[scriptName]) {
+        const find = [
+          path.join(searchDir, pkgJson.bin[scriptName]),
+          path.join(process.cwd(), "node_modules/binary-collections", pkgJson.bin[scriptName]),
+          path.join(__dirname, pkgJson.bin[scriptName]),
+          path.join(path.join(__dirname, ".."), pkgJson.bin[scriptName]),
+          path.join(path.join(__dirname, "../.."), pkgJson.bin[scriptName])
+        ];
+        const filtered = find.filter((file) => fs.existsSync(file));
+        if (filtered.length > 0) {
+          result = filtered[0];
+        } else {
+          console.warn(`\u26A0\uFE0F  Script "${scriptName}" not found in ${searchDir}.`);
+          console.warn(`\u{1F50D} Searched for: ${pattern} in ${searchDir}`);
+        }
+      }
+    }
+  } catch (error) {
+    console.error(`\u{1F50D} Error searching for script: ${error.message}`);
+  }
+  if (result && !result.includes("-cli")) {
+    const ext = path.extname(result);
+    const filename = path.basename(result, ext);
+    const cliFile = path.join(path.dirname(result), `${filename}-cli${ext}`);
+    if (fs.existsSync(cliFile)) {
+      result = cliFile;
+      console.log(`\u{1F50D} Found CLI version: ${cliFile}`);
+    }
+  }
+  return result;
+}
+module.exports = findScript;
+module.exports.default = findScript;

package/lib/binary-collections/findScript.d.cts

@@ -0,0 +1,12 @@
+export = findScript;
+/**
+ * Searches for a script file by name in the specified directory
+ * @function findScript
+ * @param {string} scriptName - The name of the script to find (without extension)
+ * @param {string|null} [searchDir=null] - The directory to search in. Defaults to the parent `src` directory when not provided
+ * @returns {string|undefined} The absolute path to the found script file, or undefined if not found
+ */
+declare function findScript(scriptName: string, searchDir?: string | null): string | undefined;
+declare namespace findScript {
+    export { findScript as default };
+}

package/lib/binary-collections/findScript.mjs

@@ -0,0 +1,7 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import {
+  require_findScript
+} from "../chunk-NCZPTKDV.mjs";
+import "../chunk-ZOWVMII3.mjs";
+import "../chunk-QQ4A6DLD.mjs";
+export default require_findScript();