@adamlui/scss-to-css 1.7.1 → 1.7.3

package/README.md

@@ -1,20 +1,26 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;English |
-        <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/zh-cn#readme">简体中文</a> |
-        <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/zh-tw#readme">繁體中文</a> |
-        <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/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>
+<table align="center">
+    <td align="center" width=1000>
+        <h6>
+            <picture>
+                <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
+                <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
+            </picture>
+            &nbsp;English |
+            <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/zh-cn#readme">简体中文</a> |
+            <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/zh-tw#readme">繁體中文</a> |
+            <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/de#readme">Deutsch</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/fr#readme">Français</a> |
+            <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/it#readme">Italiano</a> |
+            <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/nl#readme">Nederlands</a> |
+            <a href="https://github.com/adamlui/js-utils/tree/main/scss-to-css/docs/pt#readme">Português</a>
+        </h6>
+    </td>
+</table>
 
 # { } scss-to-css
 
@@ -22,7 +28,7 @@
 
 <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.1-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.7.3"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.7.3-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>
 
@@ -212,8 +218,19 @@ Searches for all SCSS files within the `searchDir` string passed (useful for dis
 Options are boolean, passed as object properties. For example:
 
 ```js
-// Returns array containing filepaths to SCSS files in exactly `searchDir`
-scssToCSS.findSCSS(searchDir, { recursive: false });
+// Search for SCSS files in exactly assets/scss:
+const searchResults = scssToCSS.findSCSS('assets/scss', { recursive: false });
+console.log(searchResults);
+
+/* sample output:
+
+Searching for SCSS files...
+Search complete. 2 files found.
+[
+  'E:\\js\\utils\\minify.js\\assets\\scss\\foo.scss',
+  'E:\\js\\utils\\minify.js\\assets\\scss\\bar.scss'
+]
+*/
 ```
 
 Available parameters (and their default settings) are:

package/dist/scss-to-css.min.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+const c=require("fs"),l=require("path"),t=require("sass");function a(s,r={}){var e={recursive:!0,verbose:!0,dotFolders:!1};if(r={...e,...r},!s)return console.error("findSCSS() » ERROR: Please supply a `searchDir` as 1st arg.");if("string"!=typeof s)return console.error("findSCSS() » ERROR: 1st arg `searchDir` must be a string.");var o=l.resolve(process.cwd(),s);if(!c.existsSync(o))return console.error("findSCSS() » ERROR: Arg `searchDir` must be an existing directory."+`
+'${o}' does not exist.`);for(const t of Object.keys(r))if(!Object.prototype.hasOwnProperty.call(e,t)){if("isRecursing"!==t)return console.error(`findSCSS() » ERROR: \`${t}\` is an invalid option.`+`
+findSCSS() » Valid options: [ ${Object.keys(e).join(", ")} ]`);if("boolean"!=typeof r[t])return console.error(`findSCSS() » ERROR: \`${t}\` option must be set to \`true\` or \`false\`.`)}const i=c.readdirSync(s),n=[];return r.verbose&&!r.isRecursing&&console.info("\nfindSCSS() » Searching for SCSS files..."),i.forEach(e=>{var o=l.resolve(s,e);c.statSync(o).isDirectory()&&"node_modules"!=e&&(r.dotFolders||!e.startsWith("."))&&r.recursive?n.push(...a(o,{...r,isRecursing:!0})):e.endsWith(".scss")&&n.push(o)}),!r.isRecursing&&r.verbose&&console.info("findSCSS() » Search complete. "+(0===n.length?"No":n.length)+` file${1<n.length?"s":""} found.`+("compile"!==a.caller.name?"\nfindSCSS() » Check returned object.":"")),r.isRecursing||0<n.length?n:[]}function s(e,s={}){var o={minify:!0,sourceMaps:!0,recursive:!0,verbose:!0,dotFolders:!1};if(s={...o,...s},"string"!=typeof e)return console.error("findSCSS() » ERROR: Arg `inputPath` must be a string.");if(e=l.resolve(process.cwd(),e),!c.existsSync(e))return console.error("findSCSS() » ERROR: Arg `inputPath` must be an existing directory or file."+`
+findSCSS() » '${e}' does not exist.`);for(const n of Object.keys(s)){if(!Object.prototype.hasOwnProperty.call(o,n))return console.error(`compile() » ERROR: \`${n}\` is an invalid option.`+`
+findSCSS() » Valid options: [ ${Object.keys(o).join(", ")} ]`);if("boolean"!=typeof s[n])return console.error(`compile() » ERROR: \`${n}\` option must be set to \`true\` or \`false\`.`)}const r={style:s.minify?"compressed":"expanded",sourceMap:s.sourceMaps};if(c.existsSync(e)){if(!e.endsWith(".scss"))return a(e,{recursive:s.recursive,verbose:s.verbose,dotFolders:s.dotFolders})?.map(e=>{s.verbose&&console.info(`compile() » Compiling ${e}...`);try{var o=t.compile(e,r);return console.info("compile() » Compilation complete! Check returned object."),{code:o.css,srcMap:o.sourceMap,srcPath:e}}catch(e){return console.error(`
+compile() » ERROR: ${e.message}
+`),{error:e}}}).filter(e=>!e.error);s.verbose&&console.info(`compile() » Compiling ${e}...`);try{var i=t.compile(e,r);return console.info("compile() » Compilation complete! Check returned object."),{code:i.css,srcMap:i.sourceMap,srcPath:l.resolve(process.cwd(),e)}}catch(e){return console.error(`
+compile() » ERROR: ${e.message}
+`),{error:e}}}}if(require.main!==module)module.exports={compile:s,findSCSS:a};else{const i="",n="",f="",e="",u={},p={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)-?recursi(?:on|ve)|recursi(?:on|ve)=(?: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?$/};if(process.argv.forEach(o=>{var e;o.startsWith("-")&&((e=Object.keys(p).find(e=>p[e].test(o)))?u[e]=!0:(console.error(`
+${n}ERROR: Arg [${o}] not recognized.`+i),console.info(`
+${f}Valid arguments are below.`+i),r(["configOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>p.help.test(e)))r();else if(process.argv.some(e=>p.version.test(e)))console.info("v"+require("./package.json").version);else{const[d="",m=""]=process.argv.slice(2).filter(e=>!e.startsWith("-")).map(e=>e.replace(/^\/*/,"")),S=l.resolve(process.cwd(),d),h=(d&&!c.existsSync(S)&&(console.error(`
+${n}Error: First argument must be an existing file or directory.`+`
+'${S}' does not exist.`+i+`
+
+${e}Example valid command: 
+>> scss-to-css . output.min.css`+i+`
+
+${f}For all command options: 
+>> scss-to-css --help`+i),process.exit(1)),d.endsWith(".scss")?[S]:a(S,{recursive:!u.noRecursion,verbose:!u.quietMode}));if(u.dryRun)0<h.length?(console.info(`
+${f}SCSS files to be compiled:`+i),h.forEach(e=>console.info(e))):console.info(f+`
+No SCSS files will be compiled.`+i);else{const g=[],v=h.map(e=>{var o=s(e,{minify:!u.noMinify,sourceMaps:!u.noSourceMaps,verbose:!u.quietMode});return o.error&&g.push(e),o}).filter(e=>!e.error);if(v?.forEach(({code:e,srcMap:o,srcPath:s})=>{var r=l.join(l.dirname(s),/(?:src|s[ac]ss)$/.test(l.dirname(s))?"../css":m.endsWith(".css")?l.dirname(m):m||"css"),s=(m.endsWith(".css")&&d.endsWith(".scss")?l.basename(m).replace(/(\.min)?\.css$/,""):l.basename(s,".scss"))+".min.css",s=l.join(r,s);c.existsSync(r)||c.mkdirSync(r,{recursive:!0}),c.writeFileSync(s,e,"utf8"),u.noSourceMaps||c.writeFileSync(s+".map",JSON.stringify(o),"utf8")}),0<v?.length){const y=1<v.length?"s":"";o(`
+${e}Compilation complete!`+i),o(v.length+" CSS file"+y+(u.noSourceMaps?"":` + ${v.length} source map`+y)+" generated.")}else o(f+"No SCSS files processed."+i);0<g.length&&(o(`
+`+n+g.length+" file"+(1<g.length?"s":"")+" failed to compile:"+i),g.forEach(e=>o(e)))}}function r(e=["cmdFormat","pathArgs","configOptions","infoCmds"]){const o={cmdFormat:[`
+${f}scss-to-css [inputPath] [outputPath] [options]`+i],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."]};e.forEach(e=>{o[e]?.forEach(e=>{{const r=process.stdout.columns||80,i=[],o=e.match(/\S+|\s+/g);let s="";o.forEach(e=>{var o=r-(0===i.length?0:30);s.length+e.length>o&&(i.push(0===i.length?s:s.trimStart()),s=""),s+=e}),i.push(0===i.length?s:s.trimStart()),i.forEach((e,o)=>console.info(0===o?e:" ".repeat(30)+e))}})})}function o(e){u.quietMode||console.info(e)}}

package/docs/LICENSE.md

@@ -1,4 +1,4 @@
-<div align="right">
+<div align="center">
     <h6>
         <picture>
             <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
@@ -11,7 +11,11 @@
         <a href="bn/LICENSE.md">বাংলা</a> |
         <a href="mr/LICENSE.md">मराठी</a> |
         <a href="pa/LICENSE.md">ਪੰਜਾਬੀ</a> |
+        <a href="de/LICENSE.md">Deutsch</a> |
         <a href="es/LICENSE.md">Español</a> |
+        <a href="fr/LICENSE.md">Français</a> |
+        <a href="it/LICENSE.md">Italiano</a> |
+        <a href="nl/LICENSE.md">Nederlands</a> |
         <a href="pt/LICENSE.md">Português</a>
     </h6>
 </div>

package/docs/SECURITY.md

@@ -1,4 +1,4 @@
-<div align="right">
+<div align="center">
     <h6>
         <picture>
             <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
@@ -11,7 +11,11 @@
         <a href="bn/SECURITY.md">বাংলা</a> |
         <a href="mr/SECURITY.md">मराठी</a> |
         <a href="pa/SECURITY.md">ਪੰਜਾਬੀ</a> |
+        <a href="de/SECURITY.md">Deutsch</a> |
         <a href="es/SECURITY.md">Español</a> |
+        <a href="fr/SECURITY.md">Français</a> |
+        <a href="it/SECURITY.md">Italiano</a> |
+        <a href="nl/SECURITY.md">Nederlands</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.1",
+  "version": "1.7.3",
   "description": "Recursively compile all SCSS files into minified CSS",
   "author": {
     "name": "Adam Lui",
@@ -9,13 +9,19 @@
   },
   "homepage": "https://github.com/adamlui/js-utils",
   "license": "MIT",
-  "main": "scss-to-css.js",
+  "main": "dist/scss-to-css.min.js",
+  "files": [
+    "dist",
+    "docs/",
+    "!docs/*/"
+  ],
   "bin": {
-    "scsstocss": "scss-to-css.js",
-    "scss-to-css": "scss-to-css.js"
+    "scsstocss": "dist/scss-to-css.min.js",
+    "scss-to-css": "dist/scss-to-css.min.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "minify-js scss-to-css.js dist",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
     "bump:major": "bash utils/bump.sh major",
@@ -46,5 +52,8 @@
   "funding": {
     "type": "github",
     "url": "https://github.com/sponsors/adamlui"
+  },
+  "devDependencies": {
+    "@adamlui/minify.js": "^1.4.6"
   }
 }

package/scss-to-css.js

@@ -1,250 +0,0 @@
-#!/usr/bin/env node
-
-// Import LIBS
-const fs = require('fs'),
-      path = require('path'),
-      sass = require('sass');
-
-// Define MAIN functions
-
-function findSCSS(searchDir, options = {}) {
-
-    // Init options
-    const defaultOptions = { recursive: true, verbose: true, dotFolders: false };
-    options = { ...defaultOptions, ...options };
-
-    // Search for SCSS
-    const dirFiles = fs.readdirSync(searchDir), scssFiles = [];
-    if (options.verbose && !options.isRecursing) console.info('\nSearching for SCSS files...');
-    dirFiles.forEach(file => {
-        const filePath = path.resolve(searchDir, file);
-        if (fs.statSync(filePath).isDirectory() && file != 'node_modules'
-            && (options.dotFolders || !file.startsWith('.')) && options.recursive)
-                scssFiles.push( // recursively find SCSS in eligible dir
-                    ...findSCSS(filePath, { ...options, isRecursing: true }));
-        else if (file.endsWith('.scss')) // SCSS file found
-            scssFiles.push(filePath); // store it for compilation
-    });
-
-    // Log/return final result
-    if (!options.isRecursing && options.verbose) {
-        console.info('Search complete. '
-            + ( scssFiles.length === 0 ? 'No' : scssFiles.length )
-            + ` file${ scssFiles.length > 1 ? 's' : '' } found.`);
-    }
-    return options.isRecursing || scssFiles.length > 0 ? scssFiles : [];
-}
-
-function compile(inputPath, options = {}) {
-
-    // Init options
-    const defaultOptions = { minify: true, sourceMaps: true, recursive: true, verbose: true, dotFolders: false };
-    options = { ...defaultOptions, ...options };
-
-    // Validate inputPath
-    if (typeof inputPath !== 'string')
-        return console.error('ERROR:'
-            + ' First argument must be a string representing a file/folder path.');
-
-    // Compile SCSS based on inputPath
-    const compileOptions = { style: options.minify ? 'compressed' : 'expanded', sourceMap: options.sourceMaps };
-    if (fs.existsSync(inputPath)) { // compile based on path arg
-        if (inputPath.endsWith('.scss')) { // file path passed
-            if (options.verbose) console.info(`Compiling ${ inputPath }...`);
-            try { // to compile file passed
-                const compileResult = sass.compile(inputPath, compileOptions);
-                return { code: compileResult.css, srcMap: compileResult.sourceMap, srcPath: inputPath };
-            } catch (err) { console.error(`\nERROR: ${ err.message }\n`); return { error: err }; }
-        } else { // dir path passed
-            return findSCSS(inputPath, { recursive: options.recursive, verbosity: options.verbose,
-                                         dotFolders: options.dotFolders
-                })?.map(scssPath => { // compile found SCSS files
-                    if (options.verbose) console.info(`Compiling ${ scssPath }...`); 
-                    try { // to compile found file
-                        const compileResult = sass.compile(scssPath, compileOptions);
-                        return { code: compileResult.css, srcMap: compileResult.sourceMap, srcPath: scssPath };
-                    } catch (err) { console.error(`\nERROR: ${ err.message }\n`); return { error: err }; }
-                }).filter(data => !data.error ); // filter out failed compilations
-        }
-    } else return console.error('First argument must be an existing file or directory.'
-        + `\n'${ inputPath }' does not exist.`);
-}
-
-// EXPORT functions if script was required
-if (require.main !== module) module.exports = { compile, findSCSS };
-
-else { // run as CLI tool
-
-    // 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)?)$/,
-        '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 => argRegex.help.test(arg))) printHelpScreen();
-
-    // 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 must be an existing file or directory.`
-                + `\n'${ inputPath }' does not exist.${nc}`
-                + `\n\n${bg}Example valid command: \n>> scss-to-css . output.min.css${nc}`
-                + `\n\n${by}For all command options: \n>> scss-to-css --help${nc}`);
-            process.exit(1);
-        }
-
-        // Find all eligible JavaScript files or arg-passed file
-        const scssFiles = inputArg.endsWith('.scss') ? [inputPath]
-            : findSCSS(inputPath, { recursive: !config.noRecursion, verbose: !config.quietMode });
-
-        if (config.dryRun) { // -n or --dry-run passed
-            if (scssFiles.length > 0) { // print files to be processed
-                console.info(`\n${by}SCSS files to be compiled:${nc}`);
-                scssFiles.forEach(file => console.info(file));
-            } else console.info(`${by}\nNo SCSS files will be compiled.${nc}`);
-
-        } else { // actually compile SCSS files
-
-            // Build array of compilation data
-            const failedPaths = [];
-            const compileData = scssFiles.map(scssPath => {
-                const compileResult = compile(scssPath, {
-                    minify: !config.noMinify, sourceMaps: !config.noSourceMaps, verbose: !config.quietMode });
-                if (compileResult.error) failedPaths.push(scssPath);
-                return compileResult;
-            }).filter(data => !data.error ); // filter out failed compilations
-
-            // Write array data to files
-            compileData?.forEach(({ code, srcMap, srcPath }) => {                
-                const outputDir = path.join(
-                    path.dirname(srcPath), // path of file to be minified
-                    /(?:src|s[ac]ss)$/.test(path.dirname(srcPath)) ? '../css' // + ../css/ if in *(src|sass|scss)/
-                        : outputArg.endsWith('.css') ? path.dirname(outputArg) // or path from file output arg
-                        : outputArg || 'css' // or path from folder output arg or css/ if no output arg passed
-                );
-                const outputFilename = (
-                    outputArg.endsWith('.css') && inputArg.endsWith('.scss')
-                        ? path.basename(outputArg).replace(/(\.min)?\.css$/, '')
-                        : path.basename(srcPath, '.scss')
-                ) + '.min.css';
-                const outputPath = path.join(outputDir, outputFilename);
-                if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
-                fs.writeFileSync(outputPath, code, 'utf8');
-                if (!config.noSourceMaps) fs.writeFileSync(outputPath + '.map', JSON.stringify(srcMap), 'utf8');
-            });
-
-            // Print final summary
-            if (compileData?.length > 0) {
-                const cssCntSuffix = compileData.length > 1 ? 's' : '';
-                printIfNotQuiet(`\n${bg}Compilation complete!${nc}`);
-                printIfNotQuiet(`${ compileData.length } CSS file${ cssCntSuffix }`
-                    + ( !config.noSourceMaps ? ` + ${ compileData.length } source map${ cssCntSuffix }` : '' )
-                    + ' generated.');
-            } else printIfNotQuiet(`${by}No SCSS files processed.${nc}`);
-            if (failedPaths.length > 0) {
-                printIfNotQuiet(`\n${br}`
-                    + `${ failedPaths.length } file${ failedPaths.length > 1 ? 's' : '' }`
-                    + ` failed to compile:${nc}`);
-                failedPaths.forEach(path => printIfNotQuiet(path));
-            }
-        }
-    }
-
-    // Define LOGGING functions
-
-    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);
-
-        // 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 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); }
-}