@adamlui/minify.js 1.4.3 → 1.4.4

package/README.md

@@ -18,9 +18,9 @@
 
 ### 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&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-red.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://www.npmjs.com/package/@adamlui/minify.js?activeTab=versions"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.4.3-fc7811.svg?logo=icinga&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/dt/%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://www.npmjs.com/package/@adamlui/minify.js?activeTab=versions"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.4.4-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>
 
@@ -28,34 +28,38 @@
 
 <br>
 
-<img height=8px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
+<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
 
 ## ⚡ Installation
 
 As a **global utility**:
 
 ```
-npm install -g @adamlui/minify.js
+$ npm install -g @adamlui/minify.js
 ```
 
 As a **dev dependency** (e.g. for build scripts), from your project root:
 
 ```
-npm install -D @adamlui/minify.js
+$ npm install -D @adamlui/minify.js
 ```
 
 As a **runtime dependency** (e.g. for on-the-fly minification), from your project root:
 
 ```
-npm install @adamlui/minify.js
+$ npm install @adamlui/minify.js
 ```
 
+<br>
+
+<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
+
 ## 💻 Command line usage
 
 The basic **global command** is:
 
 ```
-minify-js
+$ minify-js
 ```
 
 **💡 Note:** Pass `-n` or `--dry-run` to only see what files will be processed.
@@ -65,7 +69,7 @@ minify-js
 To specify **input/output** paths:
    
 ```
-minify-js [input_path] [output_path]
+$ minify-js [input_path] [output_path]
 ```
 
 - `[input_path]`: Path to JS file or directory containing JS files to be minified, relative to the current working directory.
@@ -84,57 +88,59 @@ To use as a **package script**, in your project's `package.json`:
 ```
 
 Replace `<minify-js-cmd>` with `minify-js` + optional args. Then, `npm run build:js` can be used to run the command.
-<br><br>
+
+#
 
 ### Example commands
 
 Minify all JavaScript files in the **current directory** (outputs to `min/`):
 
 ```
-minify-js
+$ minify-js
 ```
 
 Minify all JavaScript files in a **specific directory** (outputs to `path/to/your/directory/min/`):
 
 ```
-minify-js path/to/your/directory
+$ minify-js path/to/your/directory
 ```
 
 Minify a **specific file** (outputs to `path/to/your/min/file.min.js`):
 
 ```
-minify-js path/to/your/file.js
+$ minify-js path/to/your/file.js
 ```
 
 Specify both **input and output** directories (outputs to `output_folder/`):
 
 ```
-minify-js input_folder output_folder
+$ minify-js input_folder output_folder
 ```
 
-### Command line options
-
-#### Config options:
+#
 
-Flag                           | Description
--------------------------------|-------------------------------------------------------------------------
-`-n` or `--dry-run`            | Don't actually minify the file(s), just show if they will be processed.
-`-d` or `--include-dotfolders` | Include dotfolders in file search.
-`-D` or `--include-dotfiles`   | Include dotfiles in file search.
-`-R` or `--no-recursion`       | Disable recursive file searching.
-`-M` or `--no-mangle`          | Disable mangling names.
-`-q` or `--quiet`              | Suppress all logging except errors.
+### Command line options
 
-#### Info commands:
+```
+Config 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.
 
-Command             | Description
---------------------|----------------------
-`-h` or `--help`    | Display help screen.
-`-v` or `--version` | Show version number.
+Info commands:
+ -h, --help                  Display help screen.
+ -v, --version               Show version number.
+```
 
 <br>
 
-## 🔌 API reference
+<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
+
+## 🔌 API usage
 
 You can also import **minify.js** into your app to use its API methods, both as an ECMAScript module or a CommonJS module.
 
@@ -150,17 +156,20 @@ import * as minifyJS from '@adamlui/minify.js';
 const minifyJS = require('@adamlui/minify.js');
 ```
 
-### minify(input, options)
+#
+
+### `minify(input[, options])`
 
-This function minifies JavaScript code based on the string input supplied.
+Minifies JavaScript code based on the string input supplied.
 
 If **source code** is passed, it is directly minified, then an object containing `srcPath` + `code` + `error` is returned:
 
 ```js
 const srcCode = 'function add(first, second) { return first + second; }',
       minifyResult = minifyJS.minify(srcCode);
-console.log(minifyResult.error); // runtime error, or `undefined` if no error
-console.log(minifyResult.code);  // minified output: function add(n,d){return n+d}
+
+console.log(minifyResult.error); // outputs runtime error, or `undefined` if no error
+console.log(minifyResult.code);  // outputs minified JS: function add(n,d){return n+d}
 ```
 
 If a **file path** is passed, the file's code is loaded then minified, returning an object like above.
@@ -168,17 +177,19 @@ If a **file path** is passed, the file's code is loaded then minified, returning
 If a **directory path** is passed, JavaScript files are searched for (recursively by default), each one's code is loaded then minified, then an array of objects containing `srcPath` + `code` + `error` is returned:
 
 ```js
-const results = minifyJS.minify('.');
-results.forEach(result =>
-    console.log(result.srcPath)); // paths to JS files in working directory + all nested directories
-console.log(results[1].code);     // minified code of 2nd JS file if found, or `undefined` if not found
+// Outputs paths to source JS files in working directory + all nested directories
+const minifyResults = minifyJS.minify('.');
+minifyResults.forEach(result => console.log(result.srcPath));
+
+// Outputs minified code of 2nd JS file if found, or `undefined` if not found
+console.log(minifyResults[1].code);
 ```
 
 Options are boolean, passed as object properties. For example:
 
 ```js
+// Returns data object where dotfiles are also processed if `input` is a path
 minifyJS.minify(input, { dotFiles: true });
-// returns data object where dotfiles are also processed if `input` is a path
 ```
 
 Possible parameters (and their default settings) are:
@@ -191,17 +202,17 @@ Name         | Desciption                                              | Default
 `dotFiles`   | Include dotfiles in file search.                        | `false`
 `mangle`     | Shorten variable names (typically to one character).    | `true`
 
-<br>
+#
 
-### findJS(searchDir, options)
+### `findJS(searchDir[, options])`
 
-This function searches for all unminified JavaScript files within the `searchDir` string passed (useful for discovering what files [`minify()`](#minifyinput-options) will process) and returns an array containing their filepaths.
+Searches for all unminified JavaScript files within the `searchDir` string passed (useful for discovering what files [`minify()`](#minifyinput-options) will process) and returns an array containing their filepaths.
 
 Options are boolean, passed as object properties. For example:
 
 ```js
+// Returns array containing filepaths to unminified JS files in exactly `searchDir`
 minifyJS.findJS(searchDir, { recursive: false });
-// returns array containing filepaths to unminified JS files in exactly `searchDir`
 ```
 
 Possible parameters (and their default settings) are:
@@ -215,10 +226,7 @@ Name         | Desciption                                              | Default
 
 <br>
 
-## 💖 Support
-
-Please consider [giving a GitHub ⭐](https://github.com/adamlui/js-utils) if this helped you!
-<br><br>
+<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
 
 ## 🏛️ MIT License
 

package/minify.js

@@ -87,46 +87,36 @@ else { // run as CLI tool
           bg = '\x1b[1;92m'; // bright green
 
     // Load FLAG settings
-    const config = {
-        dryRun: process.argv.some(arg => /^--?(?:n|dry-?run)$/.test(arg)),
-        includeDotFolders: process.argv.some(arg =>
-            /^--?(?:dd?|(?:include-?)?dot-?(?:folder|dir(?:ector(?:y|ie))?)s?=?(?:true|1)?)$/.test(arg)),
-        includeDotFiles: process.argv.some(arg =>
-            /^--?(?:df|D|(?:include-?)?dot-?files?=?(?:true|1)?)$/.test(arg)),
-        noRecursion: process.argv.some(arg =>
-            /^--?(?:R|(?:disable|no)-?recursion|recursion=(?:false|0))$/.test(arg)),
-        noMangle: process.argv.some(arg =>
-            /^--?(?:M|(?:disable|no)-?mangle|mangle=(?:false|0))$/.test(arg)),
-        quietMode: process.argv.some(arg => /^--?q(?:uiet)?(?:-?mode)?$/.test(arg))
+    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)-?recursion|recursion=(?: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}`);
+            printHelpScreen(['configOptions', 'infoCmds']);
+            process.exit(1);
+    }});
 
     // Show HELP screen if -h or --help passed
-    if (process.argv.some(arg => /^--?h(?:elp)?$/.test(arg))) {
-        printHelp(`\n${by}minify-js [inputPath] [outputPath] [options]${nc}`);
-        printHelp('\nPath arguments:');
-        printHelp(' [inputPath]                 '
-            + 'Path to JS file or directory containing JS files to be minified,'
-            + ' relative to the current working directory.');
-        printHelp(' [outputPath]                '
-            + 'Path to file or directory where minified files will be stored,'
-            + ' relative to original file location (if not provided, min/ is used).');
-        printHelp('\nConfig options:');
-        printHelp(' -n, --dry-run               Don\'t actually minify the file(s),'
-            + ' just show if they will be processed.');
-        printHelp(' -d, --include-dotfolders    Include dotfolders in file search.');
-        printHelp(' -D, --include-dotfiles      Include dotfiles in file search.');
-        printHelp(' -R, --no-recursion          Disable recursive file searching.');
-        printHelp(' -M, --no-mangle             Disable mangling names.');
-        printHelp(' -q, --quiet                 Suppress all logging except errors.');
-        printHelp('\nInfo commands:');
-        printHelp(' -h, --help                  Display this help screen.');
-        printHelp(' -v, --version               Show version number.');
+    if (process.argv.some(arg => argRegex.help.test(arg))) printHelpScreen();
 
     // Show VERSION number if -v or --version passed
-    } else if (process.argv.some(arg => /^--?ve?r?s?i?o?n?$/.test(arg))) {
+    else if (process.argv.some(arg => argRegex.version.test(arg)))
         console.info('v' + require('./package.json').version);
 
-    } else { // run MAIN routine
+    else { // run MAIN routine
 
         // Init I/O args
         const [inputArg = '', outputArg = ''] = ( // default to empty strings for error-less handling
@@ -200,7 +190,7 @@ else { // run as CLI tool
 
     // Define LOGGING functions
 
-    function printHelp(msg) { // wrap msg + indent 2nd+ lines (for --help screen)
+    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);
 
@@ -223,5 +213,39 @@ else { // run as CLI tool
         ));
     }
 
+    function printHelpScreen(includeSections = ['sampleCmd', 'pathArgs', 'configOptions', 'infoCmds']) {
+        const sections = {
+            'sampleCmd': [
+                `\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
+            if (sections[section]) sections[section].forEach(line => printHelpMsg(line)); });
+    }
+
     function printIfNotQuiet(msg) { if (!config.quietMode) console.info(msg); }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamlui/minify.js",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "description": "Recursively minify all JavaScript files",
   "author": {
     "name": "Adam Lui",