@adamlui/scss-to-css 1.3.1 → 1.4.0

package/README.md

@@ -2,10 +2,11 @@
 
 ### Recursively compile all SCSS files into minified CSS.
 
+<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&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-fcde7b.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://www.npmjs.com/package/@adamlui/scss-to-css"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.3.1-fc7811.svg?logo=npm&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.4.0-fc7811.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 
-<img height=8px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/separators/aqua.png">
+<img height=8px width="100%" src="https://github.com/adamlui/js-utils/blob/main/docs/images/aqua-separator.png">
 
 ## ⚡ Installation
 
@@ -33,20 +34,20 @@ Sample output:
 
 <img src="https://github.com/adamlui/js-utils/blob/main/scss-to-css/media/images/sample-output.png">
 
-**💡 Note:** Source maps are also generated by default unless `--disable-source-maps` is passed.
+**💡 Note:** Source maps are also generated by default unless `-S` or `--disable-source-maps` is passed.
 
 #
 
 To specify **input/output** paths:
    
 ```
-scss-to-css <input_path> <output_path>
+scss-to-css [input_path] [output_path]
 ```
 
-- `<input_path>`: Path to SCSS file or directory containing SCSS files to be compiled, relative to the current working directory. 
-- `<output_path>`: Path to file or directory where CSS + sourcemap files will be stored, relative to original file location (if not provided, `css/` is used).
+- `[input_path]`: Path to SCSS file or directory containing SCSS files to be compiled, relative to the current working directory. 
+- `[output_path]`: Path to file or directory where CSS + sourcemap files will be stored, relative to original file location (if not provided, `css/` is used).
 
-**💡 Note:** If folders are passed, files will be processed recursively. To include dotfolders, pass `--include-dotfolders`.
+**💡 Note:** If folders are passed, files will be processed recursively. To include dotfolders, pass `-dd` or `--include-dotfolders`.
 
 #
 
@@ -111,7 +112,7 @@ SOFTWARE.
 
 <br>
 
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/separators/aqua.png">
+<img height=6px width="100%" src="https://github.com/adamlui/js-utils/blob/main/docs/images/aqua-separator.png">
 
 <a href="https://github.com/adamlui/js-utils">**Home**</a> /
 <a href="https://github.com/adamlui/js-utils/discussions">Discuss</a> /

package/package.json

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

package/scss-to-css.js

@@ -11,77 +11,128 @@ const nc = '\x1b[0m', // no color
       by = '\x1b[1;33m', // bright yellow
       bg = '\x1b[1;92m'; // bright green
 
-// Init I/O args
-const [inputArg = '', outputArg = ''] = ( // default to empty strings for error-less handling
-    process.argv.slice(2) // exclude executable and script path
-        .filter(arg => !arg.startsWith('-')) // exclude flags
-        .map(arg => arg.replace(/^\/*/, '')) // clean leading slashes to avoid parsing system root
-);
+// Show help screen if -h or --help passed
+if (process.argv.some(arg => /^--?h(?:elp)?$/.test(arg))) {
 
-// Validate input arg (output arg can be anything)
-const inputPath = path.resolve(__dirname, inputArg);
-if (inputArg && !fs.existsSync(inputPath)) {
-    console.error(`\n${br}Error: First arg must be an existing file or directory.`
-        + `\n${ inputPath } does not exist.${nc}`
-        + '\n\nExample valid command: \n>> scss-to-css . output.min.css');
-    process.exit(1);
-}
+    // Print help
+    console.info(`\n${by}scss-to-css [inputPath] [outputPath] [options]${nc}`);
+    console.info('\nPath arguments:');
+    printWrappedMsg(' [input_path]                '
+        + 'Path to SCSS file or directory containing SCSS files to be compiled,'
+        + ' relative to the current working directory.');
+    printWrappedMsg(' [output_path]               '
+        + 'Path to file or directory where CSS + sourcemap files will be stored,'
+        + ' relative to original file location (if not provided, css/ is used).');
+    console.info('\nConfig options:');
+    printWrappedMsg(' -dd, --include-dotfolders   Include dotfolders in file search.');
+    printWrappedMsg(' -S, --disable-source-maps   Prevent source maps from being generated.');
+    console.info('\nInfo commands:');
+    printWrappedMsg(' -h, --help                  Display this help screen.');
+    printWrappedMsg(' -v, --version               Show version number.');
 
-// Store flag settings
-const config = { 
-    includeDotFolders: process.argv.some(arg => /--?include-dot-?folders?/.test(arg)),
-    disableSourceMaps: process.argv.some(arg => /--?(exclude|disable)-source-?maps?/.test(arg))
-};
+    function printWrappedMsg(msg) { // indents 2nd+ lines
+        const terminalWidth = process.stdout.columns || 80,
+              indentation = 29, lines = [], words = msg.match(/\S+|\s+/g);
 
-// Recursively find all eligible SCSS files or arg-passed file
-const scssFiles = [];
-if (inputArg.endsWith('.scss')) scssFiles.push(inputPath);
-else (function findSCSSfiles(dir) {
-    const files = fs.readdirSync(dir);
-    files.forEach(file => {
-        const filePath = path.resolve(dir, file);
-        if (fs.statSync(filePath).isDirectory() &&
-            (config.includeDotFolders || !file.startsWith('.')))
-                findSCSSfiles(filePath); // recursively find SCSS in eligible dir
-        else if (file.endsWith('.scss')) // SCSS file found
-            scssFiles.push(filePath); // store it for compilation
-    });
-})(inputPath);
+        // 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());
 
-// Compile SCSS files to CSS
-let cssGenCnt = 0, srcMapGenCnt = 0;
-console.log(''); // line break before first log
-scssFiles.forEach(scssPath => {
-    console.info(`Compiling ${ scssPath }...`);
-    try { // to compile it
-        const outputDir = path.join(
-            path.dirname(scssPath), // path of file to be minified
-            /(src|s[ac]ss)$/.test(path.dirname(scssPath)) ? '../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(scssPath, '.scss')
-        ) + '.min.css';
-        const outputPath = path.join(outputDir, outputFilename),
-              compileResult = sass.compile(scssPath, { style: 'compressed', sourceMap: !config.disableSourceMaps });
-        if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
-        fs.writeFileSync(outputPath, compileResult.css, 'utf8'); cssGenCnt++;
-        if (!config.disableSourceMaps) {
-            fs.writeFileSync(outputPath + '.map', JSON.stringify(compileResult.sourceMap), 'utf8');
-            srcMapGenCnt++;
-        }
-    } catch (err) {
-        console.error(`${br}Error compiling ${ scssPath }: ${ err.message }${nc}`);
+        // Print formatted msg
+        lines.forEach((line, index) => {
+            if (index === 0) console.info(line); // print 1st line unindented
+            else console.info(' '.repeat(indentation) + line); // print subsequent lines indented
+        });
+    }
+
+// Show version number if -v or --version passed
+} else if (process.argv.some(arg => /^--?v(?:er(?:s(?:ion)?)?)?$/.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 arg must be an existing file or directory.`
+            + `\n${ inputPath } does not exist.${nc}`
+            + '\n\nExample valid command: \n>> scss-to-css . output.min.css');
+        process.exit(1);
     }
-});
 
-// Print final summary
-if (cssGenCnt) {
-    console.info(`\n${bg}Compilation complete!${nc}`);
-    console.info(`${ cssGenCnt } CSS file${ cssGenCnt > 1 ? 's' : '' }`
-        + ( srcMapGenCnt ? ` + ${ srcMapGenCnt } source map${ srcMapGenCnt > 1 ? 's' : '' }` : '' )
-        + ' generated.');
-} else console.info(`${by}No SCSS files found.${nc}`);
+    // Load flag settings
+    const config = { 
+        includeDotFolders: process.argv.some(arg =>
+            /^--?(?:dd|(?:include-)?dot-?(?:folder|dir(?:ector(?:y|ie))?)s?)$/.test(arg)),
+        disableSourceMaps: process.argv.some(arg =>
+            /^--?(?:S|(?:exclude|disable)-so?u?rce?-?maps?)$/.test(arg))
+    };
+
+    // Recursively find all eligible SCSS files or arg-passed file
+    const scssFiles = [];
+    if (inputArg.endsWith('.scss')) scssFiles.push(inputPath);
+    else (function findSCSSfiles(dir) {
+        const files = fs.readdirSync(dir);
+        files.forEach(file => {
+            const filePath = path.resolve(dir, file);
+            if (fs.statSync(filePath).isDirectory() &&
+                (config.includeDotFolders || !file.startsWith('.')))
+                    findSCSSfiles(filePath); // recursively find SCSS in eligible dir
+            else if (file.endsWith('.scss')) // SCSS file found
+                scssFiles.push(filePath); // store it for compilation
+        });
+    })(inputPath);
+
+    // Compile SCSS files to CSS
+    let cssGenCnt = 0, srcMapGenCnt = 0;
+    console.log(''); // line break before first log
+    scssFiles.forEach(scssPath => {
+        console.info(`Compiling ${ scssPath }...`);
+        try { // to compile it
+            const outputDir = path.join(
+                path.dirname(scssPath), // path of file to be minified
+                /(?:src|s[ac]ss)$/.test(path.dirname(scssPath)) ? '../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(scssPath, '.scss')
+            ) + '.min.css';
+            const outputPath = path.join(outputDir, outputFilename),
+                  compileResult = sass.compile(scssPath, { style: 'compressed', sourceMap: !config.disableSourceMaps });
+            if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+            fs.writeFileSync(outputPath, compileResult.css, 'utf8'); cssGenCnt++;
+            if (!config.disableSourceMaps) {
+                fs.writeFileSync(outputPath + '.map', JSON.stringify(compileResult.sourceMap), 'utf8');
+                srcMapGenCnt++;
+            }
+        } catch (err) {
+            console.error(`${br}Error compiling ${ scssPath }: ${ err.message }${nc}`);
+        }
+    });
+
+    // Print final summary
+    if (cssGenCnt) {
+        console.info(`\n${bg}Compilation complete!${nc}`);
+        console.info(`${ cssGenCnt } CSS file${ cssGenCnt > 1 ? 's' : '' }`
+            + ( srcMapGenCnt ? ` + ${ srcMapGenCnt } source map${ srcMapGenCnt > 1 ? 's' : '' }` : '' )
+            + ' generated.');
+    } else console.info(`${by}No SCSS files found.${nc}`);
+}