binary-collections 2.0.11 → 2.0.13

package/docs-src/git-fix.md

@@ -0,0 +1,34 @@
+## Git Fix Utility
+
+A comprehensive configuration fixer for cross-platform development. Non-interactive and argument-driven.
+
+### Usage
+
+```bash
+git-fix                        # Apply all default fixes
+git-fix --lf-only              # Force LF line endings only
+git-fix --permissions          # Ignore file permissions only
+git-fix --normalize            # Normalize existing files only
+git-fix --user                 # Configure Git user from env vars
+git-fix --user NAME EMAIL      # Configure Git user with specific values
+```
+
+Options can be combined: `git-fix --lf-only --permissions`
+
+### Features
+
+- Forces LF line endings (`core.autocrlf = false`)
+- Ignores file permission changes (`core.filemode = false`)
+- Sets pull strategy to prevent auto-rebase
+- Creates/updates `.gitattributes`
+- Normalizes existing line endings
+
+### User Configuration
+
+- Uses environment variables: `GITHUB_USER`, `GITHUB_EMAIL` (if no args provided)
+- Use `--user NAME EMAIL` to specify credentials directly
+- Precedence: CLI arguments > environment variables > skip
+
+### Source
+
+See [`src/git-fix.cjs`](../src/git-fix.cjs) & submodules in [`src/git/`](../src/git/)

package/docs-src/git-purge.md

@@ -0,0 +1,17 @@
+## Git Repository Purge
+
+Cleans and optimizes git repositories by pruning reflogs aggressively.
+
+### Usage
+
+```bash
+git-purge
+```
+
+### Description
+
+Aggressively prunes the git reflog in all `.git` directories, helping reduce repository size and improve performance.
+
+### Source
+
+See [`src/git-purge.cjs`](../src/git-purge.cjs)

package/docs-src/git-reduce-size.md

@@ -0,0 +1,17 @@
+## Git Repository Size Reducer
+
+Reduces repository size by cleaning up history.
+
+### Usage
+
+```bash
+git-reduce-size
+```
+
+### Description
+
+Aggressively prunes git reflog and runs garbage collection to reduce the repository size on disk.
+
+### Source
+
+See [`bin/git-reduce-size`](../bin/git-reduce-size)

package/docs-src/git-undo.md

@@ -0,0 +1,21 @@
+## Git Undo Commands
+
+Utilities to undo recent git operations while preserving your changes.
+
+### Available Commands
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `undo-commit` | `undo-last-commit`, `git-undo-commit` | Soft-resets the last commit (`git reset --soft HEAD~1`) |
+| `undo-staged` | `git-undo-staged` | Unstages all staged changes (`git reset HEAD .`) |
+
+### Usage
+
+```bash
+undo-commit    # Undo the last commit, keep changes staged
+undo-staged    # Unstage all staged changes
+```
+
+### Source
+
+See [`src/git/undo-commit.cjs`](../src/git/undo-commit.cjs), [`src/git/undo-staged.cjs`](../src/git/undo-staged.cjs)

package/docs-src/kill-night-crows.md

@@ -0,0 +1,26 @@
+## Night Crows Process Killer
+
+Kills the Night Crows game launcher process tree when the shipping process hangs.
+
+### Usage
+
+```bash
+kill-night-crows
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+
+### Description
+
+- Launches `kill-night-crows.ps1` PowerShell script
+- Watches for Night Crows processes and kills the launcher tree
+- **Windows only**
+- Available as a standalone utility for game development environments
+
+### Source
+
+See [`src/kill-night-crows.mjs`](../src/kill-night-crows.mjs) & [`bin/kill-night-crows.ps1`](../bin/kill-night-crows.ps1)

package/docs-src/node-cache-cleaner.md

@@ -0,0 +1,182 @@
+## Node Cache Cleaner
+
+Cleans NPM, Yarn, and NPX caches in parallel.
+
+### Usage
+
+```bash
+node-cache-cleaner [options]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+
+### Description
+
+- Runs `npm cache clean --force` to clean the NPM cache
+- Runs `yarn cache clean` (or `yarn cache clean --all` for Yarn Berry) to clean the Yarn cache
+- Removes `_npx`, `_cacache`, and `.cache/npx` directories to clean the NPX cache
+- All cache cleaning operations run in parallel via `Promise.allSettled`
+- Exits with code 0 on success, or 1 if any cache clean operation fails
+
+### Source
+
+See [`src/node-cache-cleaner-cli.ts`](../src/node-cache-cleaner-cli.ts) and [`src/node-cache-cleaner/`](../src/node-cache-cleaner/)
+
+---
+
+## Yarn Cache Cleaner (Python)
+
+Python-based utility to clean Yarn caches.
+
+### Usage
+
+```bash
+yarn-clean
+```
+
+### Description
+
+Runs `yarn-clean.py` which locates and cleans Yarn cache directories. Available as a shell wrapper in both bash and batch variants.
+
+### Source
+
+See [`bin/yarn-clean`](../bin/yarn-clean) & [`bin/yarn-clean.py`](../bin/yarn-clean.py)
+
+---
+
+## yc / ycw
+
+Shell scripts to clean `node_modules` directories in parallel.
+
+### Usage
+
+```bash
+yc [options]
+ycw [options]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+| `-c, --concurrent <num>` | Maximum parallel jobs (default: 4) |
+
+### Description
+
+- **`yc`** — Cleans `node_modules` via letter-based parallel deletion of top-level entries (a-z) inside `node_modules/`
+- **`ycw`** — Yarn workspaces–aware variant. Detects monorepo root, expands workspace globs, and cleans `node_modules` across root + all workspace packages in parallel
+
+### Source
+
+See [`bin/yc`](../bin/yc) & [`bin/ycw`](../bin/ycw)
+
+---
+
+## Node Modules Cleaner
+
+Recursively finds and removes `node_modules` directories.
+
+### Aliases
+
+- `del-nodemodules` (default)
+- `del-node-modules`
+
+### Usage
+
+```bash
+del-nodemodules [options]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--force`, `-f` | Actually delete (default is dry-run mode) |
+| `-c, --concurrent N` | Set concurrent removals (default: 2, or CPU count) |
+| `-h, --help` | Show help message |
+
+### Description
+
+- Searches for all `node_modules` directories recursively
+- Also removes `package-lock.json`, `yarn.lock`, and `.yarn/cache` directories
+- By default runs in dry-run mode (shows what would be deleted)
+- Pass `--force` to actually perform deletion
+
+### Source
+
+See [`src/del-node-modules.js`](../src/del-node-modules.js)
+
+---
+
+## Yarn Cache Cleaner
+
+Deletes Yarn cache directories and cached `.gz` files.
+
+### Aliases
+
+- `del-yarncaches` (default)
+- `del-yarn-caches`
+
+### Usage
+
+```bash
+del-yarncaches
+```
+
+### Description
+
+Finds and deletes all `.yarn/cache*` directories and `.yarn/*.gz` files under the current working directory, excluding `.git` and `vendor` directories.
+
+### Source
+
+See [`src/del-yarn-caches.js`](../src/del-yarn-caches.js)
+
+---
+
+## Remove Node Modules (Fast)
+
+Alternative tool for removing `node_modules` — faster for very large projects. Removes subfolders by first-letter in parallel.
+
+### Aliases
+
+- `rm-node-modules` (default)
+- `rm-node-module`
+- `remove-node-modules`
+- `remove-node-module`
+
+### Usage
+
+```bash
+rm-node-modules [options]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--force` | Actually delete (default is dry-run mode) |
+| `-h, --help` | Show help message |
+
+### Description
+
+- Removes `node_modules` subfolders by first-letter in parallel (a-z, A-Z)
+- Writes and executes a temporary shell script (auto-removed after completion)
+- On Windows requires a Unix-compatible shell in `PATH` (e.g., Git Bash or WSL)
+
+### Examples
+
+```bash
+npx --legacy-peer-deps -y binary-collections rm-node-modules
+npx --legacy-peer-deps -y binary-collections rm-node-modules --force
+yarn run rm-node-modules
+```
+
+### Source
+
+See [`src/rm-node-module-cli.cjs`](../src/rm-node-module-cli.cjs) & [`src/rm-node-modules.cjs`](../src/rm-node-modules.cjs)
+

package/docs-src/node-executor.md

@@ -0,0 +1,50 @@
+## Node Executor
+
+Execute scripts in various languages by dispatching to the appropriate runtime based on file extension.
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `node-exec` (default)
+- `exec-node`
+- `execute-node`
+- `node-executor`
+
+### Usage
+
+```bash
+node-exec [options] <file>
+```
+
+### Options
+
+| Flag | Description |
+| :--- | :--- |
+| `-h`, `--help` | Show help |
+| `--exit-code=<code>` | Exit code when file not found or invalid (default: `1`) |
+
+### Supported Extensions
+
+| Extension | Runtime |
+| :-------- | :------ |
+| `.php` | `php` |
+| `.js` | `node` |
+| `.mjs` | `node` |
+| `.cjs` | `node` |
+| `.py` | `python` |
+| `.rb` | `ruby` |
+| `.sh` | `bash` |
+| `.bat` | `cmd` |
+
+### Example
+
+```bash
+node-exec test.php
+node-exec script.js
+node-exec --exit-code=0 missing.php
+```
+
+### Source
+
+See [`src/node-executor.cjs`](../src/node-executor.cjs)

package/docs-src/node-package-packer.md

@@ -0,0 +1,48 @@
+# Node Package Packer
+
+Automated tarball (tgz) creator for release folder. It packs the current package, generates release metadata, and writes a release README alongside the produced tarballs.
+
+## Usage
+
+```bash
+tarball-packer [options]
+```
+
+### One-off Call
+
+You can run the command without installing the library:
+
+```bash
+npx --legacy-peer-deps -y binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz node-package-packer [options]
+```
+
+### Aliases
+
+This command is available under the following aliases:
+
+- `tarball-packer` (default)
+- `node-package-packer`
+- `pack-node-package`
+- `pack-tarball`
+- `build-tarball`
+- `build-package`
+- `build-package-tarball`
+
+### Options
+
+| Flag | Description |
+| :--- | :--- |
+| `-h`, `--help` | Show help message |
+| `-y`, `--yarn` | Force `yarn pack` instead of `npm pack` |
+| `-d`, `--verbose` | Enable verbose output |
+| `--fn`, `--filename` | Set output filename variant |
+
+### Description
+
+- Runs `npm pack` or `yarn pack` to create a tarball in the project root.
+- Copies the tarball into the release folder and writes `metadata.json` with integrity hashes.
+- Generates a release README that lists available tarballs and raw GitHub URLs.
+
+### Source
+
+See [`src/node-package-packer-cli.mjs`](../src/node-package-packer-cli.mjs) (CLI entry point) and [`src/node-package-packer/build-tarball.mjs`](../src/node-package-packer/build-tarball.mjs) (pack workflow).

package/docs-src/npm-run-series.md

@@ -0,0 +1,43 @@
+## NPM Script Runner
+
+Execute multiple npm scripts in series using pattern matching.
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `nrs` (default)
+- `run-s`
+- `run-series`
+- `npm-run-series`
+
+### Usage
+
+```bash
+nrs <glob-pattern-of-script-names> [options]
+```
+
+### Options
+
+| Flag | Description |
+| :--- | :--- |
+| `--yarn` | Use `yarn run` instead of `npm run` |
+| `--verbose`, `-v` | Enable verbose logging |
+
+### Example
+
+Define a script to run all tasks matching a pattern:
+
+```json
+{
+  "scripts": {
+    "build:app": "echo 'building app'",
+    "build:lib": "echo 'building lib'",
+    "build:all": "nrs --yarn --verbose \"build:**\""
+  }
+}
+```
+
+### Source
+
+See [`src/npm-run-series.cjs`](../src/npm-run-series.cjs)

package/docs-src/package-resolutions-updater.md

@@ -0,0 +1,22 @@
+## Package Resolutions Manager
+
+Updates GitHub raw tarball commit SHAs in `package.json` resolutions to the latest commit on each branch.
+
+### Aliases
+
+- `pkg-resolutions-updater` (default)
+- `pkg-res-updater`
+
+### Usage
+
+```bash
+pkg-resolutions-updater
+```
+
+### Description
+
+Scans `package.json` resolutions for GitHub tarball URLs (raw.githubusercontent.com) and updates the commit SHA in each URL to the latest commit on the referenced branch.
+
+### Source
+
+See [`src/package-resolutions-updater.mjs`](../src/package-resolutions-updater.mjs) & [`src/package-resolutions-updater-cli.mjs`](../src/package-resolutions-updater-cli.mjs)

package/docs-src/php-cs-fixer-staged.md

@@ -0,0 +1,19 @@
+## PHP CS Fixer Staged
+
+Runs `php-cs-fixer` on staged PHP files only.
+
+### Usage
+
+```bash
+php-cs-fixer-staged
+```
+
+### Description
+
+- Gets the list of staged PHP files using `git diff --name-only --cached --diff-filter=ACM`
+- Automatically locates `php-cs-fixer` in PATH or common locations (`vendor/bin/`, `bin/`, `tools/`)
+- Runs `php-cs-fixer fix` on only the staged PHP files
+
+### Source
+
+See [`src/php-cs-fixer-staged.cjs`](../src/php-cs-fixer-staged.cjs)

package/docs-src/print-directory-tree.md

@@ -0,0 +1,35 @@
+## Directory Tree Printer
+
+Generates a directory tree structure with file SHA-256 hashes.
+
+### Aliases
+
+- `print-tree` (default)
+- `dir-tree`
+- `print-directory-tree`
+
+### Usage
+
+```bash
+print-tree [options]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-o, --output <file>` | Output file (default: `tmp/directory-structure.txt`) |
+| `--ext <exts>` | Comma-separated list of file extensions to include |
+| `--pattern <glob>` | Glob pattern to include (repeatable) |
+| `--exclude <dirs>` | Directories to exclude |
+| `--override-exclude, -we` | Override default excludes |
+| `--git-add` | Stage output file to git |
+| `-h, --help` | Show help message |
+
+### Description
+
+Scans the current directory recursively, generates a structured tree with SHA-256 hashes for each file, and writes the result to an output file.
+
+### Source
+
+See [`src/print-directory-tree.cjs`](../src/print-directory-tree.cjs)

package/docs-src/print-tarball-tree.md

@@ -0,0 +1,55 @@
+# Tarball Tree Printer
+
+Prints the directory tree structure of a `.tgz` (gzipped tarball) archive to the console.
+
+# Usage
+
+```bash
+print-tarball-tree [options]
+```
+
+### Aliases
+
+- `print-tarball-tree` (default)
+- `tarball-tree`
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-f, --file <path>` | Path to the tarball file |
+| `-h, --help` | Show help message |
+
+### Description
+
+Reads a `.tgz` file (gzipped tar archive), extracts the entry names, and prints them as a hierarchical directory tree using Unicode box-drawing characters (`├──`, `└──`, `│`).
+
+The file path can be given as an absolute path or a relative path (resolved against the current working directory).
+
+If no `--file` argument is provided, the command exits with an error.
+
+If the specified file does not exist, the command exits with an error.
+
+### Examples
+
+Print the tree of a tarball in the current directory:
+
+```bash
+print-tarball-tree --file package.tgz
+```
+
+Print the tree using an absolute path:
+
+```bash
+print-tarball-tree -f /path/to/package.tgz
+```
+
+Using the alias:
+
+```bash
+tarball-tree --file build/package.tgz
+```
+
+# Source
+
+See [`src/print-tarball-tree.mjs`](../src/print-tarball-tree.mjs)

package/docs-src/py.md

@@ -0,0 +1,19 @@
+## Python Script Runner
+
+Runs Python scripts using a managed virtual environment.
+
+### Usage
+
+```bash
+py <script.py> [args...]
+```
+
+### Description
+
+- Automatically manages a Python virtual environment
+- Installs dependencies as needed
+- Runs Python scripts in a consistent, isolated environment
+
+### Source
+
+See [`bin/py`](../bin/py)

package/docs-src/remove-module.md

@@ -0,0 +1,32 @@
+## Remove Module
+
+Removes a module from one or more dependency directories (Node.js, PHP Composer, Python venv).
+
+### Usage
+
+```bash
+remove-module <moduleName> [<moduleName> ...]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--node` | Remove from `node_modules` (default if no flag given) |
+| `--composer` | Remove from `vendor/composer` |
+| `--venv` | Remove from `venv`/`.venv` site-packages |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+remove-module lodash
+remove-module lodash express --node
+remove-module phpunit --composer
+remove-module requests --venv
+remove-module lodash phpunit --node --composer
+```
+
+### Source
+
+See [`src/remove-module.mjs`](../src/remove-module.mjs)

package/docs-src/rmfind-rmx.md

@@ -0,0 +1,21 @@
+## Fast File/Folder Deleters
+
+Shell-based utilities for finding and removing files/directories by name.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `rmfind` | Find and delete files/directories by name using `find` |
+| `rmx` | Fast parallel alphabet-based folder deleter |
+
+### Usage
+
+```bash
+rmfind <name>       # Find and delete items by name
+rmx <path>          # Fast parallel deletion of folder contents
+```
+
+### Source
+
+See [`bin/rmfind`](../bin/rmfind), [`bin/rmx`](../bin/rmx) & [`bin/rmx.cmd`](../bin/rmx.cmd)

package/docs-src/rmpath.md

@@ -0,0 +1,38 @@
+# Remove Path (rmpath)
+
+Fast huge folder deleter using a parallel alphabet-based deletion strategy. Deletes files or folders quickly by breaking down deletions alphabetically, falling back to standard `fs.rmSync` for the top-level target.
+
+## Usage
+
+```bash
+rmpath <file-or-folder-path>
+```
+
+### Aliases
+
+This command is available under the following alias:
+
+- `rmpath` (default)
+
+### Behavior
+
+- **Files**: The specified file is deleted directly.
+- **Folders**: Subentries starting with each letter (a–z, A–Z) are resolved and deleted in parallel patterns. Vowel combinations are also covered for thorough matching.
+- **Fallback**: After alphabet-based deletion, `fs.rmSync` is called on the original target path to clean up any remaining entries.
+
+### Examples
+
+```bash
+# Delete a single file
+rmpath large-file.tmp
+
+# Delete a large directory (e.g., node_modules)
+rmpath ./node_modules
+
+# Delete a directory using an absolute path
+rmpath C:\temp\huge-folder
+```
+
+## Source
+
+See [`src/rmpath-cli.mjs`](../src/rmpath-cli.mjs) (CLI entry point) and [`src/rmpath.mjs`](../src/rmpath.mjs) (core logic).