@adamlui/minify.js 1.4.8 → 1.4.10

package/README.md

@@ -19,11 +19,11 @@
 
 ### Recursively minify all JavaScript files.
 
-<a href="https://www.npmjs.com/package/@adamlui/minify.js"><img height=31 src="https://img.shields.io/npm/dt/%40adamlui%2Fminify.js?logo=npm&color=af68ff&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://www.npmjs.com/package/@adamlui/minify.js"><img height=31 src="https://img.shields.io/npm/dm/%40adamlui%2Fminify.js?logo=npm&color=af68ff&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="#%EF%B8%8F-mit-license"><img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://github.com/adamlui/js-utils/releases/tag/minify.js-1.4.8"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.4.8-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/minify.js-1.4.10"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.4.10-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/@adamlui/minify.js?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/%40adamlui%2Fminify.js?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:minify.js/minify.js"><img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Aminify.js%2Fminify.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
+<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:minify.js/src/minify.js"><img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Aminify.js%2Fsrc%2Fminify.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
 
 <img src="https://github.com/adamlui/js-utils/blob/main/minify.js/media/images/minify.js-docs-demo.png">
 
@@ -145,7 +145,7 @@ Info commands:
 
 You can also import **minify.js** into your app to use its API methods, both as an ECMAScript module or a CommonJS module.
 
-#### ESM:
+#### ESM*:
 
 ```js
 import * as minifyJS from '@adamlui/minify.js';
@@ -157,6 +157,8 @@ import * as minifyJS from '@adamlui/minify.js';
 const minifyJS = require('@adamlui/minify.js');
 ```
 
+###### _*Node.js version 14 or higher required_
+
 #
 
 ### `minify(input[, options])`
@@ -255,6 +257,6 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 <img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
 
-<a href="https://github.com/adamlui/js-utils">**Home**</a> /
+<a href="https://github.com/adamlui/js-utils">**JavaScript utilities**</a> /
 <a href="https://github.com/adamlui/js-utils/discussions">Discuss</a> /
 <a href="#-minifyjs">Back to top ↑</a>

package/dist/cli.min.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+const n=require(__dirname.match(/src/)?"./minify":"./minify.min"),o=require("fs"),s=require("path"),r="",t="",l="",e="",c={},a={dryRun:/^--?(?:n|dry-?run)$/,includeDotFolders:/^--?(?:dd?|(?:include-?)?dot-?(?:folder|dir(?:ector(?:y|ie))?)s?=?(?:true|1)?)$/,includeDotFiles:/^--?(?:df|D|(?:include-?)?dot-?files?=?(?:true|1)?)$/,noRecursion:/^--?(?:R|(?:disable|no)-?recursi(?:on|ve)|recursi(?:on|ve)=(?:false|0))$/,noMangle:/^--?(?:M|(?:disable|no)-?mangle|mangle=(?:false|0))$/,quietMode:/^--?q(?:uiet)?(?:-?mode)?$/,help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/};if(process.argv.forEach(i=>{var e;i.startsWith("-")&&((e=Object.keys(a).find(e=>a[e].test(i)))?c[e]=!0:(console.error(`
+${t}ERROR: Arg [${i}] not recognized.`+r),console.info(`
+${l}Valid arguments are below.`+r),d(["configOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>a.help.test(e)))d();else if(process.argv.some(e=>a.version.test(e)))console.info("v"+require("./package.json").version);else{const[f="",m=""]=process.argv.slice(2).filter(e=>!e.startsWith("-")).map(e=>e.replace(/^\/*/,"")),u=s.resolve(process.cwd(),f),h=(f&&!o.existsSync(u)&&(console.error(`
+${t}Error: First argument can only be an existing file or directory.`+`
+${u} does not exist.`+r+`
+
+${e}Example valid command: 
+» minify-js . output.min.js`+r+`
+
+${l}For all command options: 
+» minify-js --help`+r),process.exit(1)),f.endsWith(".js")?[u]:n.findJS(u,{recursive:!c.noRecursion,verbose:!c.quietMode}));if(c.dryRun)0<h.length?(console.info(`
+${l}JS files to be minified:`+r),h.forEach(e=>console.info(e))):console.info(l+`
+No JS files will be minified.`+r);else{const p=[],g=h.map(e=>{var i=n.minify(e,{verbose:!c.quietMode,mangle:!c.noMangle});return i.error&&p.push(e),i}).filter(e=>!e.error);g?.forEach(({code:e,srcPath:i})=>{var n=s.join(s.dirname(i),(/so?u?rce?$/.test(s.dirname(i))?"../":"")+(m.endsWith(".js")?s.dirname(m):m||"min")),i=(m.endsWith(".js")&&f.endsWith(".js")?s.basename(m).replace(/(\.min)?\.js$/,""):s.basename(i,".js"))+".min.js",i=s.join(n,i);o.existsSync(n)||o.mkdirSync(n,{recursive:!0}),o.writeFileSync(i,e,"utf8")}),0<g?.length?(i(`
+${e}Minification complete!`+r),i(`${g.length} file${1<g.length?"s":""} minified.`)):i(l+"No unminified JavaScript files processed."+r),0<p.length&&(i(`
+`+t+p.length+" file"+(1<p.length?"s":"")+" failed to minify:"+r),p.forEach(e=>i(e)))}}function d(e=["cmdFormat","pathArgs","configOptions","infoCmds"]){const i={cmdFormat:[`
+${l}minify-js [inputPath] [outputPath] [options]`+r],pathArgs:["\nPath arguments:"," [inputPath]                 Path to JS file or directory containing JS files to be minified, relative to the current working directory."," [outputPath]                Path to file or directory where minified files will be stored, relative to original file location (if not provided, min/ is used)."],configOptions:["\nConfig options:"," -n, --dry-run               Don't actually minify the file(s), just show if they will be processed."," -d, --include-dotfolders    Include dotfolders in file search."," -D, --include-dotfiles      Include dotfiles in file search."," -R, --no-recursion          Disable recursive file searching."," -M, --no-mangle             Disable mangling names."," -q, --quiet                 Suppress all logging except errors."],infoCmds:["\nInfo commands:"," -h, --help                  Display help screen."," -v, --version               Show version number."]};e.forEach(e=>{i[e]?.forEach(e=>{{const o=process.stdout.columns||80,s=[],i=e.match(/\S+|\s+/g);let n="";i.forEach(e=>{var i=o-(0===s.length?0:29);n.length+e.length>i&&(s.push(0===s.length?n:n.trimStart()),n=""),n+=e}),s.push(0===s.length?n:n.trimStart()),s.forEach((e,i)=>console.info(0===i?e:" ".repeat(29)+e))}})})}function i(e){c.quietMode||console.info(e)}

package/dist/minify.min.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+const t=require("fs"),l=require("path"),i=require("uglify-js");function c(o,s={}){var e={recursive:!0,verbose:!0,dotFolders:!1,dotFiles:!1};if("string"!=typeof o)return console.error("findJS() » ERROR: 1st arg <searchDir> must be a string.");var r=l.resolve(process.cwd(),o);if(t.existsSync(r)){if(f(s,e,"findJS('assets/js', { verbose: false, dotFolders: true })")){s={...e,...s};const i=t.readdirSync(o),n=[];return s.verbose&&!s.isRecursing&&console.info("findJS() » Searching for unminified JS files..."),i.forEach(e=>{var r=l.resolve(o,e);t.statSync(r).isDirectory()&&"node_modules"!=e&&(s.dotFolders||!e.startsWith("."))&&s.recursive?n.push(...c(r,{...s,isRecursing:!0})):!/\.js(?<!\.min\.js)$/.test(e)||!s.dotFiles&&e.startsWith(".")||n.push(r)}),!s.isRecursing&&s.verbose&&(console.info("findJS() » Search complete! "+(0===n.length?"No":n.length)+` file${1<n.length?"s":""} found.`),"minify"===c.caller.name||require.main.filename.endsWith("cli.js")||console.info("findJS() » Check returned array.")),s.isRecursing||0<n.length?n:[]}}else console.error("findJS() » ERROR: 1st arg <searchDir> must be an existing directory."),console.error(`findJS() » ${r} does not exist.`)}function e(e,o={}){var r={recursive:!0,verbose:!0,dotFolders:!1,dotFiles:!1,mangle:!0};if("string"!=typeof e)return console.error("minify() » ERROR: 1st arg <input> must be a string.");if(f(o,r,"minify('assets/js', { recursive: false, mangle: false })")){const s={mangle:!!(o={...r,...o}).mangle&&{toplevel:!0}};return t.existsSync(e)?e.endsWith(".js")?(o.verbose&&console.info(`minify() » Minifying ${e}...`),(r=i.minify(t.readFileSync(e,"utf8"),s)).error&&console.error("minify() » ERROR: "+r.error.message),{code:r.code,srcPath:l.resolve(process.cwd(),e),error:r.error}):c(e,{recursive:o.recursive,verbose:o.verbose,dotFolders:o.dotFolders,dotFiles:o.dotFiles})?.map(e=>{o.verbose&&console.info(`minify() » Minifying ${e}...`);var r=t.readFileSync(e,"utf8"),r=i.minify(r,s);return r.error&&console.error("minify() » ERROR: "+r.error.message),{code:r.code,srcPath:e,error:r.error}}).filter(e=>!e.error):(o.verbose&&console.info("minify() » Minifying passed source code..."),(r=i.minify(e,s)).error&&console.error("minify() » ERROR: "+r.error.message),{code:r.code,srcPath:void 0,error:r.error})}}function f(e,r,o){const s=(f.caller?.name||"validateOptions")+"() » ",i=JSON.stringify(r,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),n=Object.keys(r).join(", "),t=Object.keys(r).filter(e=>"boolean"==typeof r[e]),l=Object.keys(r).filter(e=>Number.isInteger(r[e]));var c=()=>{console.info(s+`Valid options: [ ${n} ]`),console.info(s+"If omitted, default settings are: "+i)};if("object"!=typeof e)return console.error(s+"ERROR: [options] can only be an object of key/values."),console.info(s+"Example valid call: "+o),c(),!1;for(const a in e){if("isRecursing"!=a&&!Object.prototype.hasOwnProperty.call(r,a))return console.error(s+`ERROR: \`${a}\` is an invalid option.`),c(),!1;if(t.includes(a)&&"boolean"!=typeof e[a])return console.error(s+`ERROR: [${a}] option can only be \`true\` or \`false\`.`),!1;if(l.includes(a)&&(e[a]=parseInt(e[a],10),isNaN(e[a])||e[a]<1))return console.error(s+`ERROR: [${a}] option can only be an integer > 0.`),!1}return!0}module.exports={minify:e,findJS:c};

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "@adamlui/minify.js",
-  "version": "1.4.8",
+  "version": "1.4.10",
   "description": "Recursively minify all JavaScript files",
   "author": {
     "name": "Adam Lui",
     "email": "adam@kudoai.com",
     "url": "https://github.com/adamlui"
   },
-  "homepage": "https://github.com/adamlui/js-utils",
+  "homepage": "https://js-utils.com/minify.js",
   "license": "MIT",
-  "main": "minify.js",
+  "main": "dist/minify.min.js",
+  "files": [
+    "dist",
+    "docs/",
+    "!docs/*/"
+  ],
   "bin": {
-    "minifyjs": "minify.js",
-    "minify-js": "minify.js"
+    "minifyjs": "dist/cli.min.js",
+    "minify-js": "dist/cli.min.js"
   },
   "directories": {
     "lib": ".",
@@ -21,6 +26,7 @@
   },
   "scripts": {
     "test": "bash utils/test/minify-cli.test.sh",
+    "build": "node src/cli src dist",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
     "bump:major": "bash utils/bump.sh major",
@@ -44,7 +50,7 @@
     "utils"
   ],
   "bugs": {
-    "url": "https://github.com/adamlui/js-utils/issues"
+    "url": "https://js-utils.com/issues"
   },
   "dependencies": {
     "uglify-js": "^3.17.4"

package/minify.js

@@ -1,293 +0,0 @@
-#!/usr/bin/env node
-
-// Import LIBS
-const fs = require('fs'),
-      path = require('path'),
-      uglifyJS = require('uglify-js');
-
-// Define MAIN functions
-
-function findJS(searchDir, options = {}) {
-
-    // Init options
-    const defaultOptions = {
-        recursive: true,   // recursively search for nested files in searchDir passed
-        verbose: true,     // enable logging
-        dotFolders: false, // include dotfolders in file search
-        dotFiles: false    // include dotfiles in file search
-    };
-    options = { ...defaultOptions, ...options };
-
-    // Validate searchDir
-    if (typeof searchDir !== 'string') return console.error(
-            'findJS() » ERROR: 1st arg <searchDir> must be a string.');
-    else { // verify searchDir path existence
-        const searchPath = path.resolve(process.cwd(), searchDir);
-        if (!fs.existsSync(searchPath)) return console.error(
-            'findJS() » ERROR: 1st arg <searchDir> must be an existing directory.\n'
-          + `findJS() » ${ searchPath } does not exist.`);
-    }
-
-    // Validate options
-    for (const key in options) {
-        if (!Object.prototype.hasOwnProperty.call(defaultOptions, key))
-            if (key !== 'isRecursing') return console.error(
-                `findJS() » ERROR: \`${ key }\` is an invalid option.\n`
-              + `findJS() » Valid options: [ ${ Object.keys(defaultOptions).join(', ') } ]`);
-        else if (typeof options[key] !== 'boolean') return console.error(
-                `findJS() » ERROR: [${ key }] option can only be set to \`true\` or \`false\`.`);
-    }
-
-    // Search for unminified JS
-    const dirFiles = fs.readdirSync(searchDir), jsFiles = [];
-    if (options.verbose && !options.isRecursing) console.info(
-        '\nfindJS() » Searching for unminified JS files...');
-    dirFiles.forEach(file => {
-        const filePath = path.resolve(searchDir, file);
-        if (fs.statSync(filePath).isDirectory() && file != 'node_modules'
-            && (options.dotFolders || !file.startsWith('.')) && options.recursive)
-                jsFiles.push( // recursively find unminified JS in eligible dir
-                    ...findJS(filePath, { ...options, isRecursing: true }));
-        else if (/\.js(?<!\.min\.js)$/.test(file)
-            && (options.dotFiles || !file.startsWith('.')))
-                jsFiles.push(filePath); // store eligible unminified JS file for returning
-    });
-
-    // Log/return final result
-    if (!options.isRecursing && options.verbose) console.info(
-            'findJS() » Search complete! ' + ( jsFiles.length === 0 ? 'No' : jsFiles.length )
-                + ` file${ jsFiles.length > 1 ? 's' : '' } found.`
-        + ( findJS.caller.name !== 'minify' && require.main !== module ?
-          '\nfindJS() » Check returned array.' : '' ));
-    return options.isRecursing || jsFiles.length > 0 ? jsFiles : [];
-}
-
-function minify(input, options = {}) {
-
-    // Init options
-    const defaultOptions = {
-        recursive: true,   // recursively search for nested files if dir path passed
-        verbose: true,     // enable logging
-        dotFolders: false, // include dotfolders in file search
-        dotFiles: false,   // include dotfiles in file search
-        mangle: true       // shorten var names (typically to one character)
-    };
-    options = { ...defaultOptions, ...options };
-
-    // Validate input
-    if (typeof input !== 'string') return console.error(
-        'minify() » ERROR: 1st arg <input> must be a string.');
-
-    // Validate options
-    for (const key in options) {
-        if (!Object.prototype.hasOwnProperty.call(defaultOptions, key)) return console.error(
-            `minify() » ERROR: \`${ key }\` is an invalid option.\n`
-          + `minify() » Valid options: [ ${ Object.keys(defaultOptions).join(', ') } ]`);
-        else if (typeof options[key] !== 'boolean') return console.error(
-            `minify() » ERROR: [${ key }] option can only be set to \`true\` or \`false\`.`);
-    }
-
-    // Minify JS based on input
-    const minifyOptions = { mangle: options.mangle ? { toplevel: true } : false };
-    if (fs.existsSync(input)) { // minify based on path arg
-        if (input.endsWith('.js')) { // file path passed
-            if (options.verbose) console.info(`minify() » Minifying ${ input }...`);
-            const minifyResult = uglifyJS.minify(fs.readFileSync(input, 'utf8'), minifyOptions);
-            if (minifyResult.error) console.error(`minify() » ERROR: ${ minifyResult.error.message }`);
-            return { code: minifyResult.code, srcPath: path.resolve(process.cwd(), input),
-                     error: minifyResult.error };
-        } else { // dir path passed
-            return findJS(input, { recursive: options.recursive, verbose: options.verbose,
-                                   dotFolders: options.dotFolders, dotFiles: options.dotFiles 
-                })?.map(jsPath => { // minify found JS files
-                    if (options.verbose) console.info(`minify() » Minifying ${ jsPath }...`);
-                    const srcCode = fs.readFileSync(jsPath, 'utf8'),
-                          minifyResult = uglifyJS.minify(srcCode, minifyOptions);
-                    if (minifyResult.error) console.error(`minify() » ERROR: ${ minifyResult.error.message }`);
-                    return { code: minifyResult.code, srcPath: jsPath, error: minifyResult.error };
-                }).filter(data => !data.error); // filter out failed minifications
-        }
-    } else { // minify based on src code arg
-        if (options.verbose) console.info('minify() » Minifying passed source code...');
-        const minifyResult = uglifyJS.minify(input, minifyOptions);
-        if (minifyResult.error) console.error(`minify() » ERROR: ${ minifyResult.error.message }`);
-
-        return { code: minifyResult.code, srcPath: undefined, error: minifyResult.error };
-    }
-}
-
-// EXPORT main functions if script was required
-if (require.main !== module) module.exports = { minify, findJS };
-
-else { // run as CLI utility
-
-    // Init UI colors
-    const nc = '\x1b[0m',    // no color
-          br = '\x1b[1;91m', // bright red
-          by = '\x1b[1;33m', // bright yellow
-          bg = '\x1b[1;92m'; // bright green
-
-    // Load FLAG settings
-    const config = {};
-    const argRegex = {
-        'dryRun': /^--?(?:n|dry-?run)$/,
-        'includeDotFolders': /^--?(?:dd?|(?:include-?)?dot-?(?:folder|dir(?:ector(?:y|ie))?)s?=?(?:true|1)?)$/,
-        'includeDotFiles': /^--?(?:df|D|(?:include-?)?dot-?files?=?(?:true|1)?)$/,
-        'noRecursion': /^--?(?:R|(?:disable|no)-?recursi(?:on|ve)|recursi(?:on|ve)=(?:false|0))$/,
-        'noMangle': /^--?(?:M|(?:disable|no)-?mangle|mangle=(?:false|0))$/,
-        'quietMode': /^--?q(?:uiet)?(?:-?mode)?$/,
-        'help': /^--?h(?:elp)?$/,
-        'version': /^--?ve?r?s?i?o?n?$/
-    };
-    process.argv.forEach(arg => {
-        if (!arg.startsWith('-')) return;
-        const matchedFlag = Object.keys(argRegex).find(flag => argRegex[flag].test(arg));
-        if (matchedFlag) config[matchedFlag] = true;
-        else {
-            console.error(`\n${br}ERROR: Arg [${ arg }] not recognized.${nc}`);
-            console.info(`\n${by}Valid arguments are below.${nc}`);
-            printHelpSections(['configOptions', 'infoCmds']);
-            process.exit(1);
-    }});
-
-    // Show HELP screen if -h or --help passed
-    if (process.argv.some(arg => argRegex.help.test(arg))) printHelpSections();
-
-    // Show VERSION number if -v or --version passed
-    else if (process.argv.some(arg => argRegex.version.test(arg)))
-        console.info('v' + require('./package.json').version);
-
-    else { // run MAIN routine
-
-        // Init I/O args
-        const [inputArg = '', outputArg = ''] = ( // default to empty strings for error-less handling
-            process.argv.slice(2) // exclude executable and script paths
-                .filter(arg => !arg.startsWith('-')) // exclude flags
-                .map(arg => arg.replace(/^\/*/, '')) // clean leading slashes to avoid parsing system root
-        );
-
-        // Validate input arg (output arg can be anything)
-        const inputPath = path.resolve(process.cwd(), inputArg);
-        if (inputArg && !fs.existsSync(inputPath)) {
-            console.error(`\n${br}Error: First argument can only be an existing file or directory.`
-                + `\n${ inputPath } does not exist.${nc}`
-                + `\n\n${bg}Example valid command: \n>> minify-js . output.min.js${nc}`
-                + `\n\n${by}For all command options: \n>> minify-js --help${nc}`);
-            process.exit(1);
-        }
-
-        // Find all eligible JavaScript files or arg-passed file
-        const unminnedJSfiles = inputArg.endsWith('.js') ? [inputPath]
-            : findJS(inputPath, { recursive: !config.noRecursion, verbose: !config.quietMode });
-
-        if (config.dryRun) { // -n or --dry-run passed
-            if (unminnedJSfiles.length > 0) { // print files to be processed
-                console.info(`\n${by}JS files to be minified:${nc}`);
-                unminnedJSfiles.forEach(file => console.info(file));
-            } else console.info(`${by}\nNo JS files will be minified.${nc}`);
-
-        } else { // actually minify JavaScript files
-
-            // Build array of minification data
-            const failedPaths = [];
-            const minifyData = unminnedJSfiles.map(jsPath => {
-                const minifyResult = minify(jsPath, { verbose: !config.quietMode, mangle: !config.noMangle });
-                if (minifyResult.error) failedPaths.push(jsPath);
-                return minifyResult;
-            }).filter(minifyResult => !minifyResult.error); // filter out failed minifications
-
-            // Write array data to files
-            minifyData?.forEach(({ code, srcPath }) => {
-                const outputDir = path.join(
-                    path.dirname(srcPath), // path of file to be minified
-                    /so?u?rce?$/.test(path.dirname(srcPath)) ? (
-                        '../' + ( outputArg || 'min' ) // + ../outputArg|min/ if in *(src|source)/
-                    ) : outputArg.endsWith('.js') ? path.dirname(outputArg) // or path from file output arg
-                      : outputArg || 'min' // or path from folder outputArg or min/ if no outputArg passed
-                );
-                const outputFilename = (
-                    outputArg.endsWith('.js') && inputArg.endsWith('.js')
-                        ? path.basename(outputArg).replace(/(\.min)?\.js$/, '')
-                        : path.basename(srcPath, '.js')
-                ) + '.min.js';
-                const outputPath = path.join(outputDir, outputFilename);
-                if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
-                fs.writeFileSync(outputPath, code, 'utf8');
-            });
-
-            // Print final summary
-            if (minifyData?.length > 0) {
-                printIfNotQuiet(`\n${bg}Minification complete!${nc}`);
-                printIfNotQuiet(
-                    `${ minifyData.length } file${ minifyData.length > 1 ? 's' : '' } minified.`);
-            } else printIfNotQuiet(`${by}No unminified JavaScript files processed.${nc}`);
-            if (failedPaths.length > 0) {
-                printIfNotQuiet(`\n${br}`
-                    + `${ failedPaths.length } file${ failedPaths.length > 1 ? 's' : '' }`
-                    + ` failed to minify:${nc}`);
-                failedPaths.forEach(path => printIfNotQuiet(path));
-            }
-        }
-    }
-
-    // Define LOGGING functions
-
-    function printHelpSections(includeSections = ['cmdFormat', 'pathArgs', 'configOptions', 'infoCmds']) {
-        const helpSections = {
-            'cmdFormat': [
-                `\n${by}minify-js [inputPath] [outputPath] [options]${nc}`
-            ],
-            'pathArgs': [
-                '\nPath arguments:',
-                ' [inputPath]                 '
-                    + 'Path to JS file or directory containing JS files to be minified,'
-                    + ' relative to the current working directory.',
-                ' [outputPath]                '
-                    + 'Path to file or directory where minified files will be stored,'
-                    + ' relative to original file location (if not provided, min/ is used).'
-            ],
-            'configOptions': [
-                '\nConfig options:',
-                ' -n, --dry-run               Don\'t actually minify the file(s),'
-                                           + ' just show if they will be processed.',
-                ' -d, --include-dotfolders    Include dotfolders in file search.',
-                ' -D, --include-dotfiles      Include dotfiles in file search.',
-                ' -R, --no-recursion          Disable recursive file searching.',
-                ' -M, --no-mangle             Disable mangling names.',
-                ' -q, --quiet                 Suppress all logging except errors.'
-            ],
-            'infoCmds': [
-                '\nInfo commands:',
-                ' -h, --help                  Display help screen.',
-                ' -v, --version               Show version number.'
-            ]
-        };
-        includeSections.forEach(section => { // print valid arg elems
-            helpSections[section]?.forEach(line => printHelpMsg(line)); });
-
-        function printHelpMsg(msg) { // wrap msg + indent 2nd+ lines (for --help screen)
-            const terminalWidth = process.stdout.columns || 80,
-                  indentation = 29, lines = [], words = msg.match(/\S+|\s+/g);
-
-            // Split msg into lines of appropriate lengths
-            let currentLine = '';
-            words.forEach(word => {
-                const lineLength = terminalWidth - ( lines.length === 0 ? 0 : indentation );
-                if (currentLine.length + word.length > lineLength) { // cap/store it
-                    lines.push(lines.length === 0 ? currentLine : currentLine.trimStart());
-                    currentLine = '';
-                }
-                currentLine += word;
-            });
-            lines.push(lines.length === 0 ? currentLine : currentLine.trimStart());
-
-            // Print formatted msg
-            lines.forEach((line, index) => console.info(
-                index === 0 ? line // print 1st line unindented
-                    : ' '.repeat(indentation) + line // print subsequent lines indented
-            ));
-        }
-    }
-
-    function printIfNotQuiet(msg) { if (!config.quietMode) console.info(msg); }
-}