@adamlui/scss-to-css 1.7.0 → 1.7.1

package/README.md

@@ -10,7 +10,9 @@
         <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/hi#readme">हिंदी</a> |
         <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/bn#readme">বাংলা</a> |
         <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/mr#readme">मराठी</a> |
-        <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/pa#readme">ਪੰਜਾਬੀ</a>
+        <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/pa#readme">ਪੰਜਾਬੀ</a> |
+        <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/es#readme">Español</a> |
+        <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/pt#readme">Português</a>
     </h6>
 </div>
 
@@ -20,11 +22,11 @@
 
 <a href="https://www.npmjs.com/package/@adamlui/scss-to-css"><img height=31 src="https://img.shields.io/npm/dt/%40adamlui%2Fscss-to-css?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/scss-to-css?activeTab=versions"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.7.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://www.npmjs.com/package/@adamlui/scss-to-css?activeTab=versions"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.7.1-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/@adamlui/scss-to-css?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/%40adamlui%2Fscss-to-css?style=for-the-badge&logo=ebox&logoColor=white&color=blue&labelColor=464646"></a>
 <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:scss-to-css/scss-to-css.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%3Ascss-to-css%2Fscss-to-css.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 height=8px width="100%" src="https://github.com/adamlui/js-utils/blob/main/docs/images/aqua-separator.png">
+<img height=6px width="100%" src="https://github.com/adamlui/js-utils/blob/main/docs/images/aqua-separator.png">
 
 ## ⚡ Installation
 
@@ -46,6 +48,10 @@ As a **runtime dependency** (e.g. for on-the-fly compilation), from your project
 $ npm install @adamlui/scss-to-css
 ```
 
+<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:
@@ -84,7 +90,8 @@ To use as a **package script**, in your project's `package.json`:
 ```
 
 Replace `<scss-to-css-cmd>` with `scss-to-css` + optional args. Then, `npm run build:css` can be used to run the command.
-<br><br>
+
+#
 
 ### Example commands
 
@@ -113,7 +120,8 @@ $ scss-to-css input_folder output_folder
 ```
 
 **💡 Note:** Output CSS is minified unless `-M` or `--no-minify` is passed.
-<br><br>
+
+#
 
 ### Command line options
 
@@ -128,11 +136,15 @@ Config options:
  -q, --quiet                 Suppress all logging except errors.
 
 Info commands:
- -h, --help                  Display this help screen.
+ -h, --help                  Display help screen.
  -v, --version               Show version number.
 ```
 
-## 🔌 API reference
+<br>
+
+<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 **scss-to-css** into your app to use its API methods, both as an ECMAScript module or a CommonJS module.
 
@@ -148,6 +160,8 @@ import * as scssToCSS from '@adamlui/scss-to-css';
 const scssToCSS = require('@adamlui/scss-to-css');
 ```
 
+#
+
 ### `compile(inputPath[, options])`
 
 Compiles SCSS found in the `inputPath` provided into CSS data.
@@ -165,11 +179,11 @@ If a **directory path** is passed, SCSS files are searched for (recursively by d
 
 ```js
 // Outputs paths to SCSS files in working directory + all nested directories
-const results = scssToCSS.compile('.');
-results.forEach(result => console.log(result.srcPath));
+const compileResults = scssToCSS.compile('.');
+compileResults.forEach(result => console.log(result.srcPath));
 
 // Outputs compiled CSS from 2nd SCSS file if found, or `undefined` if not found
-console.log(results[1].code);
+console.log(compileResults[1].code);
 ```
 
 Options are boolean, passed as object properties. For example:
@@ -179,16 +193,17 @@ Options are boolean, passed as object properties. For example:
 scssToCSS.compile(inputDir, { minify: false });
 ```
 
-Possible parameters (and their default settings) are:
+Available parameters (and their default settings) are:
 
-```
- recursive (true)     Recursively search for nested files if dir path
-                      passed.
- verbose (true)       Show logging in console/terminal.
- dotFolders (false)   Include dotfolders in file search.
- minify (true)        Minify output CSS.
- sourceMaps (true)    Generate CSS source maps.
-```
+Name         | Desciption                                              | Default value
+-------------|---------------------------------------------------------|---------------
+`recursive`  | Recursively search for nested files if dir path passed. | `true`
+`verbose`    | Show logging in console/terminal.                       | `true`
+`dotFolders` | Include dotfolders in file search.                      | `false`
+`minify`     | Minify output CSS.                                      | `true`
+`sourceMaps` | Generate CSS source maps.                               | `true`
+
+#
 
 ### `findSCSS(searchDir[, options])`
 
@@ -201,21 +216,17 @@ Options are boolean, passed as object properties. For example:
 scssToCSS.findSCSS(searchDir, { recursive: false });
 ```
 
-Possible parameters (and their default settings) are:
+Available parameters (and their default settings) are:
 
-```
- recursive (true)     Recursively search for nested files if dir path
-                      passed.
- verbose (true)       Show logging in console/terminal.
- dotFolders (false)   Include dotfolders in file search.
-```
+Name         | Desciption                                              | Default value
+-------------|---------------------------------------------------------|---------------
+`recursive`  | Recursively search for nested files if dir path passed. | `true`
+`verbose`    | Show logging in console/terminal.                       | `true`
+`dotFolders` | Include dotfolders in file search.                      | `false`
 
 <br>
 
-## 💖 Support
-
-Please consider [giving a GitHub ⭐](https://github.com/adamlui/js-utils) or [funding](https://github.com/sponsors/adamlui) this project if it 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/docs/LICENSE.md

@@ -10,7 +10,9 @@
         <a href="hi/LICENSE.md">हिंदी</a> |
         <a href="bn/LICENSE.md">বাংলা</a> |
         <a href="mr/LICENSE.md">मराठी</a> |
-        <a href="pa/LICENSE.md">ਪੰਜਾਬੀ</a>
+        <a href="pa/LICENSE.md">ਪੰਜਾਬੀ</a> |
+        <a href="es/LICENSE.md">Español</a> |
+        <a href="pt/LICENSE.md">Português</a>
     </h6>
 </div>
 

package/docs/SECURITY.md

@@ -10,7 +10,9 @@
         <a href="hi/SECURITY.md">हिंदी</a> |
         <a href="bn/SECURITY.md">বাংলা</a> |
         <a href="mr/SECURITY.md">मराठी</a> |
-        <a href="pa/SECURITY.md">ਪੰਜਾਬੀ</a>
+        <a href="pa/SECURITY.md">ਪੰਜਾਬੀ</a> |
+        <a href="es/SECURITY.md">Español</a> |
+        <a href="pt/SECURITY.md">Português</a>
     </h6>
 </div>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamlui/scss-to-css",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Recursively compile all SCSS files into minified CSS",
   "author": {
     "name": "Adam Lui",

package/scss-to-css.js

@@ -82,46 +82,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)),
-        noSourceMaps: process.argv.some(arg =>
-            /^--?(?:S|(?:exclude|disable|no)-?so?u?rce?-?maps?|so?u?rce?-?maps?=(?:false|0))$/.test(arg)),
-        noRecursion: process.argv.some(arg =>
-            /^--?(?:R|(?:disable|no)-?recursion|recursion=(?:false|0))$/.test(arg)),
-        noMinify: process.argv.some(arg =>
-            /^--?(?:M|(?:disable|no)-?minif(?:y|ication)|minif(?:y|ication)=(?: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)?)$/,
+        'noSourceMaps': /^--?(?:S|(?:exclude|disable|no)-?so?u?rce?-?maps?|so?u?rce?-?maps?=(?:false|0))$/,
+        'noRecursion': /^--?(?:R|(?:disable|no)-?recursion|recursion=(?:false|0))$/,
+        'noMinify': /^--?(?:M|(?:disable|no)-?minif(?:y|ication)|minif(?:y|ication)=(?: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}scss-to-css [inputPath] [outputPath] [options]${nc}`);
-        printHelp('\nPath arguments:');
-        printHelp(' [inputPath]                  '
-            + 'Path to SCSS file or directory containing SCSS files to be compiled,'
-            + ' relative to the current working directory.');
-        printHelp(' [outputPath]                 '
-            + 'Path to file or directory where CSS + sourcemap files will be stored,'
-            + ' relative to original file location (if not provided, css/ is used).');
-        printHelp('\nConfig options:');
-        printHelp(' -n, --dry-run                Don\'t actually compile the file(s),'
-            + ' just show if they will be processed.');
-        printHelp(' -d, --include-dotfolders     Include dotfolders in file search.');
-        printHelp(' -S, --no-source-maps         Prevent source maps from being generated.');
-        printHelp(' -M, --no-minify              Disable minification of output CSS.');
-        printHelp(' -R, --no-recursion           Disable recursive file searching.');
-        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
@@ -199,7 +189,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 = 30, lines = [], words = msg.match(/\S+|\s+/g);
 
@@ -222,5 +212,39 @@ else { // run as CLI tool
         ));
     }
 
+    function printHelpScreen(includeSections = ['cmdFormat', 'pathArgs', 'configOptions', 'infoCmds']) {
+        const sections = {
+            'cmdFormat': [
+                `\n${by}scss-to-css [inputPath] [outputPath] [options]${nc}`
+            ],
+            'pathArgs': [
+                '\nPath arguments:',
+                ' [inputPath]                 '
+                    + 'Path to SCSS file or directory containing SCSS files to be compiled,'
+                    + ' relative to the current working directory.',
+                ' [outputPath]                '
+                    + 'Path to file or directory where CSS + sourcemap files will be stored,'
+                    + ' relative to original file location (if not provided, css/ is used).'
+            ],
+            'configOptions': [
+                '\nConfig options:',
+                ' -n, --dry-run                Don\'t actually compile the file(s),'
+                                            + ' just show if they will be processed.',
+                ' -d, --include-dotfolders     Include dotfolders in file search.',
+                ' -S, --no-source-maps         Prevent source maps from being generated.',
+                ' -M, --no-minify              Disable minification of output CSS.',
+                ' -R, --no-recursion           Disable recursive file searching.',
+                ' -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); }
 }