@adamlui/scss-to-css 1.11.1 → 2.0.0

package/README.md

@@ -1,3 +1,5 @@
+<a id="top"></a>
+
 <table align="center">
     <td align="center" width=1000>
         <h6>
@@ -30,15 +32,15 @@
 <a href="https://www.npmjs.com/package/@adamlui/scss-to-css">
     <img height=31 src="https://img.shields.io/npm/dm/%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-fc4f2d.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.11.1">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-1.11.1-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+    <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/scss-to-css-2.0.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.0.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=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_scss-to-css:node.js/src/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_scss-to-css%3Anode.js%2Fsrc%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>
 <a href="https://github.com/toolleeo/cli-apps#conversion">
-    <img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+    <img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-ff69b4?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 
 <img height=6px width="100%" src="https://assets.scsstocss.org/images/separators/aqua-gradient.png?v=7e4a141">
 
@@ -91,7 +93,7 @@ $ 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 + source map files will be stored, relative to original file location (if not provided, `css/` is used).
+- `[output_path]`: Path to file or directory where CSS + source map files will be stored, relative to input root (if not provided, `css/` is used).
 
 **📝 Note:** If folders are passed, files will be processed recursively unless `-R` or `--no-recursion` is passed.
 
@@ -117,13 +119,13 @@ Compile all SCSS files in the **current directory** (outputs to `css/`):
 $ scss-to-css
 ```
 
-Compile all SCSS files in a **specific directory** (outputs to `path/to/your/directory/css/`):
+Compile all SCSS files in a **specific directory** (outputs to `css/path/to/your/directory/`):
 
 ```
 $ scss-to-css path/to/your/directory
 ```
 
-Compile a **specific file** (outputs to `path/to/your/css/file.min.css`):
+Compile a **specific file** (outputs to `css/path/to/your/file.min.css`):
 
 ```
 $ scss-to-css path/to/your/file.scss
@@ -149,13 +151,14 @@ Boolean options:
  -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.
+ -r, --relative-output       Output files relative to each source file instead of to input root.
  -c, --copy                  Copy compiled CSS to clipboard instead of
                              writing to file if single source file is
                              processed.
  -q, --quiet                 Suppress all logging except errors.
 
 Parameter options:
- --ignore-files="file1.scss,file2.scss"   Files to exclude from
+ --ignores="dir/,file1.scss,file2.scss"   Files/directories to exclude from
                                           compilation.
  --comment="comment"                      Prepend header comment to
                                           compiled CSS. Separate by
@@ -182,7 +185,7 @@ import scssToCSS from '@adamlui/scss-to-css';
 #### CJS:
 
 ```js
-const scssToCSS = require('@adamlui/scss-to-css');
+const scssToCSS = require('@adamlui/scss-to-css')
 ```
 
 ###### _*Node.js version 14 or higher required_
@@ -197,10 +200,10 @@ If **source code** is passed, it is directly compiled, then an object containing
 
 ```js
 const srcCode = 'h1 { font-size: 40px ; code { font-face: Roboto Mono }}',
-      compileResult = scssToCSS.compile(srcCode);
+      compileResult = scssToCSS.compile(srcCode)
 
-console.log(compileResult.error); // outputs runtime error, or `undefined` if no error
-console.log(compileResult.code);  // outputs minified CSS: 'h1{font-size:40px}h1 code{font-face:Roboto Mono}'
+console.log(compileResult.error) // outputs runtime error, or `undefined` if no error
+console.log(compileResult.code)  // outputs minified CSS: 'h1{font-size:40px}h1 code{font-face:Roboto Mono}'
 ```
 
 If a **file path** is passed, the file's code is loaded then compiled to CSS, returning an object like above.
@@ -209,31 +212,32 @@ 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 compileResults = scssToCSS.compile('.');
-compileResults.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(compileResults[1].code);
+console.log(compileResults[1].code)
 ```
 
 Options are boolean, passed as object properties. For example:
 
 ```js
 // Returns array of data objects where `.code` contains unminified CSS
-scssToCSS.compile(inputDir, { minify: false });
+scssToCSS.compile(inputDir, { minify: false })
 ```
 
 Available parameters (and their default settings) are:
 
-Name          | Type    | Desciption                                                              | Default value
---------------|---------|-------------------------------------------------------------------------|---------------
-`recursive`   | Boolean | Recursively search for nested files if dir path passed.                 | `true`
-`verbose`     | Boolean | Show logging in console/terminal.                                       | `true`
-`dotFolders`  | Boolean | Include dotfolders in file search.                                      | `false`
-`minify`      | Boolean | Minify output CSS.                                                      | `true`
-`sourceMaps`  | Boolean | Generate CSS source maps.                                               | `true`
-`ignoreFiles` | Array   | Files (by name) to exclude from compilation.                            | `[]`
-`comment`     | String  | Header comment to prepend to compiled CSS. Separate by line using '\n'. | `''`
+Name             | Type    | Desciption                                                              | Default value
+-----------------|---------|-------------------------------------------------------------------------|---------------
+`recursive`      | Boolean | Recursively search for nested files if dir path passed.                 | `true`
+`verbose`        | Boolean | Show logging in console/terminal.                                       | `true`
+`dotFolders`     | Boolean | Include dotfolders in file search.                                      | `false`
+`minify`         | Boolean | Minify output CSS.                                                      | `true`
+`sourceMaps`     | Boolean | Generate CSS source maps.                                               | `true`
+`relativeOutput` | Boolean | Output files relative to each source file instead of to input root.     | `false`
+`ignores`        | Array   | Files/dirs to exclude from compilation.                                 | `[]`
+`comment`        | String  | Header comment to prepend to compiled CSS. Separate by line using '\n'. | `''`
 
 #
 
@@ -245,8 +249,8 @@ Options are boolean, passed as object properties. For example:
 
 ```js
 // Search for SCSS files in exactly assets/scss
-const searchResults = scssToCSS.findSCSS('assets/scss', { recursive: false });
-console.log(searchResults);
+const searchResults = scssToCSS.findSCSS('assets/scss', { recursive: false })
+console.log(searchResults)
 
 /* sample output:
 
@@ -267,7 +271,7 @@ Name          | Type    | Desciption
 `recursive`   | Boolean | Recursively search for nested files in searchDir passed. | `true`
 `verbose`     | Boolean | Show logging in console/terminal.                        | `true`
 `dotFolders`  | Boolean | Include dotfolders in file search.                       | `false`
-`ignoreFiles` | Array   | Files (by name) to exclude from search results.          | `[]`
+`ignores`     | Array   | Files/dirs to exclude from search results.               | `[]`
 
 <br>
 
@@ -289,12 +293,6 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ## 🛠️ Related utilities
 
-### [🖼️ img-to-webp](https://github.com/adamlui/js-utils/tree/main/img-to-webp)
-
-> Recursively compress all images to WEBPs.
-<br>[Download](https://cdn.jsdelivr.net/gh/adamlui/js-utils/img-to-webp/img-to-webp.js) /
-[Discuss](https://github.com/adamlui/js-utils/discussions)
-
 ### [</> minify.js](https://minify-js.org) &nbsp;<a href="https://github.com/toolleeo/cli-apps#programming"><img height=18 src="https://assets.scsstocss.org/images/badges/awesome/badge.svg?v=7e4a141"></a>
 
 > Recursively minify all JavaScript files.
@@ -310,4 +308,4 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 <picture><source media="(prefers-color-scheme: dark)" srcset="https://assets.scsstocss.org/images/icons/home/white/icon32x27.png?v=7e4a141"><img height=13 src="https://assets.scsstocss.org/images/icons/home/dark-gray/icon32x27.png?v=7e4a141"></picture> <a href="https://js-utils.org">**More JavaScript utilities**</a> /
 <a href="https://github.com/adamlui/scss-to-css/discussions">Discuss</a> /
-<a href="#--scss-to-css">Back to top ↑</a>
+<a href="#top">Back to top ↑</a>

package/dist/cli.min.js

@@ -1,30 +1,31 @@
 #!/usr/bin/env node
 /**
  *  © 2024 Adam Lui & contributors under the MIT license.
- *  Source: https://code.scsstocss.org/node.js
- *  Documentation: https://docs.scsstocss.org/node.js
+ *  Source: https://github.com/adamlui/scss-to-css/tree/main/node.js/src
+ *  Documentation: https://github.com/adamlui/scss-to-css/tree/main/node.js/docs
  */
-(()=>{let i="@adamlui/scss-to-css",r="https://docs.scsstocss.org/node.js/#-command-line-usage",t=require(__dirname.match(/src/)?"./scss-to-css":"./scss-to-css.min"),c=require("fs"),l=require("path"),s=require("node-clipboardy"),o=require("child_process").execSync,a="",m="",p="",d="",f="",u={},n={flags:{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))$/,copy:/^--?c(?:opy)?$/,quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},paramOptions:{ignoreFiles:/^--?(?:ignore|skip|exclude)(?:d?-?files?)?(?:=.*|$)/,comment:/^--?comments?(?:=.*|$)/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(s=>{var e,o,i;s.startsWith("-")&&(i=Object.keys(n.flags).find(e=>n.flags[e].test(s)),e=Object.keys(n.paramOptions).find(e=>n.paramOptions[e].test(s)),o=Object.keys(n.infoCmds).find(e=>n.infoCmds[e].test(s)),i?u[i]=!0:e?(/=.+/.test(s)||(console.error(`
-${m}ERROR: Arg [--${s.replace(/-/g,"")}] requires '=' followed by a value.`),v(),process.exit(1)),i=s.split("=")[1],u[e]=parseInt(i)||i):o||(console.error(`
-${m}ERROR: Arg [${s}] not recognized.`),console.info(`
-${p}Valid arguments are below.`),y(["flags","paramOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>n.infoCmds.help.test(e)))y();else if(process.argv.some(e=>n.infoCmds.version.test(e))){var h=o(`npm view ${i} version`).toString().trim()||"none";let e,s=process.cwd();for(;"/"!=s;){var g=l.join(s,"package.json");if(c.existsSync(g)){g=require(g);e=(g.dependencies?.[i]||g.devDependencies?.[i])?.match(/(\d+\.\d+\.\d+)/)[0]||"none";break}s=l.dirname(s)}console.info(`
-Global version: `+h),console.info("Local version: "+e)}else{let[r="",n=""]=process.argv.slice(2).filter(e=>!e.startsWith("-")).map(e=>e.replace(/^\/*/,"")),e=l.resolve(process.cwd(),r);r&&!c.existsSync(e)&&(h=e+".scss",c.existsSync(h)?e=h:(console.error(`
-${m}Error: First argument can only be an existing file or directory.`+`
-'${e}' does not exist.`),console.info(`
-${d}Example valid command: 
-» scss-to-css . output.min.css`),v(),process.exit(1)));h=e.endsWith(".scss")&&!c.statSync(e).isDirectory()?[e]:t.findSCSS(e,{recursive:!u.noRecursion,verbose:!u.quietMode,ignoreFiles:(u.ignoreFiles?.split(",")??[]).map(e=>e.trim())});if(u.dryRun)h.length?(console.info(`
-${p}SCSS files to be compiled:`),h.forEach(e=>console.info(e))):console.info(p+`
-No SCSS files will be compiled.`);else{let o=[];var S,h=h.map(e=>{var s=t.compile(e,{verbose:!u.quietMode,minify:!u.noMinify,sourceMaps:!u.noSourceMaps,comment:u.comment?.replace(/\\n/g,"\n")});return s.error&&o.push(e),s}).filter(e=>!e.error);h?.length?(S=1<h.length?"s":"",$(`
-${d}Compilation complete!`),$(f+h.length+" CSS file"+S+(u.noSourceMaps?"":` + ${h.length} source map`+S)+" generated."+a)):$(`
-${p}No SCSS files processed.`),o.length&&($(`
-`+m+o.length+" file"+(1<o.length?"s":"")+" failed to compile:"),o.forEach(e=>$(e))),0==h?.length&&process.exit(0),u.copy&&1==h?.length?(console.log(`
-`+f+h[0].code+a),$("\nCopying to clipboard..."),s.writeSync(h[0].code)):($(`
-Writing to file${1<h?.length?"s":""}...`),h?.forEach(({code:e,srcMap:s,srcPath:o})=>{var i=l.join(l.dirname(o),/(?:src|s[ac]ss)$/.test(l.dirname(o))?"../"+(n||"css"):n.endsWith(".css")?l.dirname(n):n||"css"),o=(n.endsWith(".css")&&r.endsWith(".scss")?l.basename(n).replace(/(\.min)?\.css$/,""):l.basename(o,".scss"))+".min.css",o=l.join(i,o);c.existsSync(i)||c.mkdirSync(i,{recursive:!0}),c.writeFileSync(o,e,"utf8"),u.noSourceMaps||c.writeFileSync(o+".map",JSON.stringify(s),"utf8")}))}}function y(e=["header","usage","pathArgs","flags","paramOptions","infoCmds"]){var s=` ${i.replace(/^@[^/]+\//,"")}  `;let o={header:[`
-├ `+s+"© 2024–2025 Adam Lui & contributors under the MIT license.",s+"Source: https://code.scsstocss.org/node.js"],usage:[`
-${f}o Usage:`,` ${f}» `+d+"scss-to-css [inputPath] [outputPath] [options]"+a],pathArgs:[`
-${f}o Path 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)."],flags:[`
-${f}o Boolean 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."," -c, --copy                              Copy compiled CSS to clipboard instead of writing to file if single source file is processed."," -q, --quiet                             Suppress all logging except errors."],paramOptions:[`
-${f}o Parameter options:`,'--ignore-files="file1.scss,file2.scss"   Files to exclude from compilation.',"--comment=\"comment\"                      Prepend header comment to compiled CSS. Separate by line using '\\n'."],infoCmds:[`
-${f}o Info commands:`," -h, --help                              Display help screen."," -v, --version                           Show version number."]};e.forEach(t=>o[t]?.forEach(s=>{{var n=/header|usage/.test(t)?1:41;let o=process.stdout.columns||80,i=[],e=s.match(/\S+|\s+/g),r="";e.forEach(e=>{var s=o-(i.length?n:0);r.length+"| ".length+e.length>s&&(i.push(i.length?r.trimStart():r),r=""),r+=e}),i.push(i.length?r.trimStart():r),i.forEach((e,s)=>console.info("| "+(0==s?e:" ".repeat(n)+e)))}})),console.info("\nFor more help, please visit: "+f+r+a)}function v(){console.info(`
+(()=>{let i="@adamlui/scss-to-css",r="https://github.com/adamlui/scss-to-css/tree/main/node.js/#-command-line-usage",t=require(__dirname.match(/src/)?"./scss-to-css":"./scss-to-css.min"),l=require("fs"),m=require("path"),n=require("node-clipboardy"),o=require("child_process").execSync,p="",d="",u="",f="",h={},c={flags:{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))$/,relativeOutput:/^--?(?:r|relative-?output?=?(?:true|1)?)$/,copy:/^--?c(?:opy)?$/,quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},paramOptions:{ignores:/^--?(?:ignores?|(?:ignore|skip|exclude)(?:d?-?files?)?)(?:=.*|$)/,comment:/^--?comments?(?:=.*|$)/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(s=>{var e,o,i;s.startsWith("-")&&(i=Object.keys(c.flags).find(e=>c.flags[e].test(s)),e=Object.keys(c.paramOptions).find(e=>c.paramOptions[e].test(s)),o=Object.keys(c.infoCmds).find(e=>c.infoCmds[e].test(s)),i?h[i]=!0:e?(/=.+/.test(s)||(console.error(`
+${p}ERROR: Arg [--${s.replace(/-/g,"")}] requires '=' followed by a value.`),y(),process.exit(1)),i=s.split("=")[1],h[e]=parseInt(i)||i):o||(console.error(`
+${p}ERROR: Arg [${s}] not recognized.`),console.info(`
+${d}Valid arguments are below.`),v(["flags","paramOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>c.infoCmds.help.test(e)))v();else if(process.argv.some(e=>c.infoCmds.version.test(e))){var g=o(`npm view ${i} version`).toString().trim()||"none";let e,s=process.cwd();for(;"/"!=s;){var a=m.join(s,"package.json");if(l.existsSync(a)){a=require(a);e=(a.dependencies?.[i]||a.devDependencies?.[i])?.match(/^[~^>=]?\d+\.\d+\.\d+$/)[1]||"none";break}s=m.dirname(s)}console.info(`
+Global version: `+g),console.info("Local version: "+e)}else{let[c="",a=""]=process.argv.slice(2).filter(e=>!e.startsWith("-")).map(e=>e.replace(/^\/*/,"")),s=m.resolve(process.cwd(),c);c&&!l.existsSync(s)&&(g=s+".scss",l.existsSync(g)?s=g:(console.error(`
+${p}Error: First argument can only be an existing file or directory.`+`
+'${s}' does not exist.`),console.info(`
+${u}Example valid command: 
+» scss-to-css . output.min.css`),y(),process.exit(1)));var S,g=s.endsWith(".scss")&&!l.statSync(s).isDirectory()?[s]:t.findSCSS(s,{recursive:!h.noRecursion,verbose:!h.quietMode,ignores:(h.ignores?.split(",")??[]).map(e=>e.trim())});if(h.dryRun)g.length?(console.info(`
+${d}SCSS files to be compiled:`),g.forEach(e=>console.info(e))):console.info(d+`
+No SCSS files will be compiled.`);else{let o=[],e=[];!h.relativeOutput&&l.statSync(s).isDirectory()?(S=t.compile(s,{verbose:!h.quietMode,minify:!h.noMinify,comment:h.comment?.replace(/\\n/g,"\n"),relativeOutput:!1,recursive:!h.noRecursion,dotFolders:!!h.includeDotFolders,sourceMaps:!h.noSourceMaps,ignores:h.ignores?h.ignores.split(",").map(e=>e.trim()):[]}),Array.isArray(S)&&(e=S),S&&(S.error?o.push(s):e=[].concat(S))):e=g.map(e=>{var s=t.compile(e,{verbose:!h.quietMode,minify:!h.noMinify,sourceMaps:!h.noSourceMaps,comment:h.comment?.replace(/\\n/g,"\n")});return s.error&&o.push(e),s}).filter(e=>!e.error),e?.length?(S=1<e.length?"s":"",$(`
+${u}Compilation complete!`),$(f+e.length+" CSS file"+S+(h.noSourceMaps?"":` + ${e.length} source map`+S)+" generated.")):$(`
+${d}No SCSS files processed.`),o.length&&($(`
+`+p+o.length+" file"+(1<o.length?"s":"")+" failed to compile:"),o.forEach(e=>$(e))),0==e?.length&&process.exit(0),h.copy&&1==e?.length?(console.log(`
+${f}${e[0].code}`),$("\nCopying to clipboard..."),n.writeSync(e[0].code)):($(`
+Writing to file${1<e?.length?"s":""}...`),e?.forEach(({code:e,srcMap:s,srcPath:o,relPath:i})=>{let r,t;if(!h.relativeOutput&&i){let e=m.resolve(process.cwd(),a||"css"),s=m.dirname(i);r="."!=s?m.join(e,s):e,t=m.basename(o,".scss")+`${h.noMinify?"":".min"}.css`}else r=m.join(m.dirname(o),a.endsWith(".css")?m.dirname(a):a||"css"),t=(a.endsWith(".css")&&c.endsWith(".scss")?m.basename(a).replace(/(\.min)?\.css$/,""):m.basename(o,".scss"))+".min.css";let n=m.join(r,t);l.existsSync(r)||l.mkdirSync(r,{recursive:!0}),l.writeFileSync(n,e,"utf8"),$(`  ${u}✓ `+m.relative(process.cwd(),n)),h.noSourceMaps||l.writeFileSync(n+".map",JSON.stringify(s),"utf8"),$(`  ${u}✓ `+m.relative(process.cwd(),n))}))}}function v(e=["header","usage","pathArgs","flags","paramOptions","infoCmds"]){var s=` ${i.replace(/^@[^/]+\//,"")}  `;let o={header:[`
+├ ${s}© 2024–2026 Adam Lui & contributors under the MIT license.`,s+"Source: https://github.com/adamlui/scss-to-css/tree/main/node.js/src"],usage:[`
+${f}o Usage:`,` ${f}» ${u}scss-to-css [inputPath] [outputPath] [options]`],pathArgs:[`
+${f}o Path 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 input root (if not provided, css/ is used)."],flags:[`
+${f}o Boolean 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."," -r, --relative-output                   Output files relative to each source file instead of to input root."," -c, --copy                              Copy compiled CSS to clipboard instead of writing to file if single source file is processed."," -q, --quiet                             Suppress all logging except errors."],paramOptions:[`
+${f}o Parameter options:`,'--ignores="dir/,file1.scss,file2.scss"   Files/directories to exclude from compilation.',"--comment=\"comment\"                      Prepend header comment to compiled CSS. Separate by line using '\\n'."],infoCmds:[`
+${f}o Info commands:`," -h, --help                              Display help screen."," -v, --version                           Show version number."]};e.forEach(n=>o[n]?.forEach(s=>{{var t=/header|usage/.test(n)?1:41;let o=process.stdout.columns||80,i=[],e=s.match(/\S+|\s+/g),r="";e.forEach(e=>{var s=o-(i.length?t:0);r.length+"| ".length+e.length>s&&(i.push(i.length?r.trimStart():r),r=""),r+=e}),i.push(i.length?r.trimStart():r),i.forEach((e,s)=>console.info("| "+(0==s?e:" ".repeat(t)+e)))}})),console.info(`
+For more help, please visit: ${f}${r}`)}function y(){console.info(`
 For more help, type 'scss-to-css --help' or visit
-`+f+r+a)}function $(e){u.quietMode||console.info(e)}})();
+${f}${r}`)}function $(e){h.quietMode||console.info(e)}})();

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

@@ -1,18 +1,18 @@
-let fs=require("fs"),path=require("path"),sass=require("sass");function findSCSS(r,i={}){var e="https://docs.scsstocss.org/node.js/#findscsssearchdir-options",s={recursive:!0,verbose:!0,dotFolders:!1,ignoreFiles:[]};if("string"!=typeof r)console.error("findSCSS() » ERROR: 1st arg <searchDir> must be a string."),console.info("findSCSS() » For more help, please visit "+e);else{var o=path.resolve(process.cwd(),r);if(fs.existsSync(o)){if(validateOptions(i,s,e,"findSCSS('assets/scss', { verbose: false, dotFolders: true })")){i={...s,...i};let e=fs.readdirSync(r),o=[];return i.verbose&&!i.isRecursing&&console.info("findSCSS() » Searching for SCSS files..."),e.forEach(e=>{var s=path.resolve(r,e);fs.statSync(s).isDirectory()&&"node_modules"!=e&&i.recursive&&(i.dotFolders||!e.startsWith("."))?o.push(...findSCSS(s,{...i,isRecursing:!0})):e.endsWith(".scss")&&!i.ignoreFiles.includes(e)?o.push(s):i.verbose&&i.ignoreFiles.includes(e)&&console.info(`findSCSS() » ** ${e} ignored due to [options.ignoreFiles]`)}),i.verbose&&!i.isRecursing&&(console.info("findSCSS() » Search complete! "+(0==o.length?"No":o.length)+` file${1==o.length?"":"s"} found.`),"compile"!=findSCSS.caller.name)&&"undefined"!=typeof window&&console.info("findSCSS() » Check returned array."),i.isRecursing||o.length?o:[]}}else console.error("findSCSS() » ERROR: 1st arg <searchDir> must be an existing directory."),console.error(`findSCSS() » ${o} does not exist.`),console.info("findSCSS() » For more help, please visit "+e)}}function compile(e,r={}){var s="https://docs.scsstocss.org/node.js/#compileinput-options",i={recursive:!0,verbose:!0,dotFolders:!1,minify:!0,sourceMaps:!0,ignoreFiles:[],comment:""};if("string"!=typeof e)console.error("compile() » ERROR: 1st arg <input> must be a string."),console.info("compile() » For more help, please visit "+s);else if(validateOptions(r,i,s,"compile('assets/scss', { recursive: false, minify: false })")){let o={style:(r={...i,...r}).minify?"compressed":"expanded",sourceMap:r.sourceMaps};if(fs.existsSync(e)){if(!e.endsWith(".scss"))return s=findSCSS(e,{recursive:r.recursive,verbose:r.verbose,dotFolders:r.dotFolders,ignoreFiles:r.ignoreFiles})?.map(e=>{r.verbose&&console.info(`compile() » ** Compiling ${e}...`);try{var s=sass.compile(e,o);return r.comment&&(s.css=t(s.css,r.comment)),{code:s.css,srcMap:s.sourceMap,srcPath:e,error:void 0}}catch(e){return console.error(`
-compile() » ERROR: ${e.message}
-`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}).filter(e=>!e.error),r.verbose&&(s.length&&"undefined"!=typeof window?console.info("compile() » Compilation complete! Check returned object."):console.info("compile() » No SCSS files processed.")),s;r.verbose&&console.info(`compile() » ** Compiling ${e}...`);try{var n=sass.compile(e,o);return r.comment&&(n.css=t(n.css,r.comment)),r.verbose&&"undefined"!=typeof window&&console.info("compile() » Compilation complete! Check returned object."),{code:n.css,srcMap:n.sourceMap,srcPath:path.resolve(process.cwd(),e),error:void 0}}catch(e){return console.error(`
-compile() » ERROR: ${e.message}
-`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}else{r.verbose&&console.info("compile() » ** Compiling passed source code...");try{var c=sass.compileString(e,o);return r.comment&&(c.css=t(c.css,r.comment)),{code:c.css,srcMap:c.sourceMap,srcPath:void 0,error:void 0}}catch(e){return console.error(`
-compile() » ERROR: ${e.message}
-`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}function t(e,s){var s=s.split("\n").map(e=>" * "+e).join("\n"),o=e.indexOf("#!");return 0<=o?(o=e.indexOf("\n",o)+1,e.slice(0,o)+`/**
+let fs=require("fs"),path=require("path"),sass=require("sass");function findSCSS(r,i={}){let e="https://github.com/adamlui/scss-to-css/tree/main/node.js/#findscsssearchdir-options",n="findSCSS() » ";var o={recursive:!0,verbose:!0,dotFolders:!1,ignores:[]};if("string"!=typeof r)console.error(n+"ERROR: 1st arg <searchDir> must be a string."),console.info(n+"For more help, please visit "+e);else{var s=path.resolve(process.cwd(),r);if(fs.existsSync(s)){if(validateOptions(i,o,e,"findSCSS('assets/scss', { verbose: false, dotFolders: true })")){(i={...o,...i}).ignoreFiles&&(i.ignores=[...i.ignores??[],...i.ignoreFiles]);let e=fs.readdirSync(r),s=[];return i.verbose&&!i.isRecursing&&console.info(n+"Searching for SCSS files..."),e.forEach(e=>{let o=path.resolve(r,e);i.ignores.some(s=>s.endsWith("/")?o.split(path.sep).some(e=>e==s.replace(/\/$/,"")):e==s)?i.verbose&&console.info(n+`** ${e} ignored`):fs.statSync(o).isDirectory()&&"node_modules"!=e&&i.recursive&&(i.dotFolders||!e.startsWith("."))?s.push(...findSCSS(o,{...i,isRecursing:!0})):e.endsWith(".scss")&&s.push(o)}),i.verbose&&!i.isRecursing&&(console.info(n+"Search complete! "+`${s.length||"No"} file${1==s.length?"":"s"} found.`),"compile"!=findSCSS.caller?.name)&&"undefined"!=typeof window&&console.info(n+"Check returned array."),i.isRecursing||s.length?s:[]}}else console.error(n+"ERROR: 1st arg <searchDir> must be an existing directory."),console.error(n+s+" does not exist."),console.info(n+"For more help, please visit "+e)}}function compile(i,n={}){let e="https://github.com/adamlui/scss-to-css/tree/main/node.js/#compileinput-options",t="compile() » ";var s={recursive:!0,verbose:!0,dotFolders:!1,minify:!0,sourceMaps:!0,relativeOutput:!1,ignores:[],comment:""};if("string"!=typeof i)console.error(t+"ERROR: 1st arg <input> must be a string."),console.info(t+"For more help, please visit "+e);else if(validateOptions(n,s,e,"compile('assets/scss', { recursive: false, minify: false })")){(n={...s,...n}).ignoreFiles&&(n.ignores=[...n.ignores??[],...n.ignoreFiles]);let r={style:n.minify?"compressed":"expanded",sourceMap:n.sourceMaps,charset:!1};if(fs.existsSync(i)){if(!i.endsWith(".scss")||!fs.statSync(i).isFile())return s=findSCSS(i,n)?.map(s=>{n.verbose&&console.info(t+`** Compiling ${s}...`);try{var o=sass.compile(s,r);let e;return n.relativeOutput||(e=path.relative(path.resolve(process.cwd(),i),s)),n.comment&&(o.css=l(o.css,n.comment)),{code:o.css,srcMap:o.sourceMap,srcPath:s,relPath:e,error:void 0}}catch(e){return console.error(`
+${t}ERROR: ${e.message}
+`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}).filter(e=>!e.error),n.verbose&&(s.length&&"undefined"!=typeof window?console.info(t+"Compilation complete! Check returned object."):console.info(t+"No SCSS files processed.")),s;n.verbose&&console.info(t+`** Compiling ${i}...`);try{var o=sass.compile(i,r);return n.comment&&(o.css=l(o.css,n.comment)),n.verbose&&"undefined"!=typeof window&&console.info(t+"Compilation complete! Check returned object."),{code:o.css,srcMap:o.sourceMap,srcPath:path.resolve(process.cwd(),i),error:void 0}}catch(e){return console.error(`
+${t}ERROR: ${e.message}
+`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}else{n.verbose&&console.info(t+"** Compiling passed source code...");try{var c=sass.compileString(i,r);return n.comment&&(c.css=l(c.css,n.comment)),{code:c.css,srcMap:c.sourceMap,srcPath:void 0,error:void 0}}catch(e){return console.error(`
+${t}ERROR: ${e.message}
+`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}function l(e,s){var s=s.split("\n").map(e=>" * "+e).join("\n"),o=e.indexOf("#!");return 0<=o?(o=e.indexOf("\n",o)+1,e.slice(0,o)+`/**
 /**
  *  © 2024 Adam Lui & contributors under the MIT license.
- *  Source: https://code.scsstocss.org/node.js
- *  Documentation: https://docs.scsstocss.org/node.js
+ *  Source: https://github.com/adamlui/scss-to-css/tree/main/node.js/src
+ *  Documentation: https://github.com/adamlui/scss-to-css/tree/main/node.js/docs
  */
 ${s}
  */
 `+e.slice(o)):`/**
 ${s}
  */
-`+e}}}function validateOptions(e,s,o,r){let i=JSON.stringify(s,void 0,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),n=Object.keys(s).join(", "),c=Object.keys(s).filter(e=>"boolean"==typeof s[e]),t=Object.keys(s).filter(e=>Number.isInteger(s[e])),l=Object.keys(s).filter(e=>Array.isArray(s[e])),a=`${validateOptions.caller?.name||"validateOptions"}() » `;var d,p=r.split(",").findIndex(e=>e.trim().startsWith("{"))+1,f=(p+=["st","nd","rd"][p-1]||"th",()=>{console.info(a+`Valid options: [ ${n} ]`),console.info(a+"If omitted, default settings are: "+i)}),m=()=>{console.info(a+"For more help, please visit "+o)};if("object"!=typeof e)return console.error(a+`ERROR: ${"0th"==p?"[O":p+" arg [o"}ptions] can only be an object of key/values.`),console.info(a+"Example valid call: "+r),f(),m(),!1;for(d in e){if("isRecursing"!=d&&!Object.prototype.hasOwnProperty.call(s,d))return console.error(a+`ERROR: \`${d}\` is an invalid option.`),f(),m(),!1;if(c.includes(d)&&"boolean"!=typeof e[d])return console.error(a+`ERROR: [${d}] option can only be \`true\` or \`false\`.`),m(),!1;if(t.includes(d)){if(e[d]=parseInt(e[d],10),isNaN(e[d])||e[d]<1)return console.error(a+`ERROR: [${d}] option can only be an integer > 0.`),m(),!1}else if(l.includes(d))if("string"!=typeof e[d]||e[d].includes(",")){if(!Array.isArray(e[d]))return console.error(a+`ERROR: [${d}] option can only be an array.`),m(),!1}else e[d]=[e[d]]}return!0}let stcAliases={compile:["build","Build","Compile","compress","Compress","minify","Minify"],findSCSS:["find","Find","findscss","findScss","Findscss","FindScss","FindSCSS","search","Search"]};module.exports={compile:compile,findSCSS:findSCSS};for(let s in stcAliases)stcAliases[s].forEach(e=>module.exports[e]=module.exports[s]);
+`+e}}}function validateOptions(e,s,o,r){let i=JSON.stringify(s,void 0,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),n=Object.keys(s).join(", "),t=Object.keys(s).filter(e=>"boolean"==typeof s[e]),c=Object.keys(s).filter(e=>Number.isInteger(s[e])),l=Object.keys(s).filter(e=>Array.isArray(s[e])),a=`${validateOptions.caller?.name||"validateOptions"}() » `;var d,p=r.split(",").findIndex(e=>e.trim().startsWith("{"))+1;function f(){console.info(a+"For more help, please visit "+o)}if(p+=["st","nd","rd"][p-1]||"th","object"!=typeof e)return console.error(a+`ERROR: ${"0th"==p?"[O":p+" arg [o"}ptions] can only be an object of key/values.`),console.info(a+"Example valid call: "+r),console.info(a+`Valid options: [ ${n} ]`),console.info(a+"If omitted, default settings are: "+i),f(),!1;for(d in e)if("isRecursing"==d||Object.prototype.hasOwnProperty.call(s,d)){if(t.includes(d)&&"boolean"!=typeof e[d])return console.error(a+`ERROR: [${d}] option can only be \`true\` or \`false\`.`),f(),!1;if(c.includes(d)){if(e[d]=parseInt(e[d],10),isNaN(e[d])||e[d]<1)return console.error(a+`ERROR: [${d}] option can only be an integer > 0.`),f(),!1}else if(l.includes(d))if("string"!=typeof e[d]||e[d].includes(",")){if(!Array.isArray(e[d]))return console.error(a+`ERROR: [${d}] option can only be an array.`),f(),!1}else e[d]=[e[d]]}return!0}let stcAliases={compile:["build","Build","Compile","compress","Compress","minify","Minify"],findSCSS:["find","Find","findscss","findScss","Findscss","FindScss","FindSCSS","search","Search"]};module.exports={compile:compile,findSCSS:findSCSS};for(let s in stcAliases)stcAliases[s].forEach(e=>module.exports[e]=module.exports[s]);

package/docs/README.md

@@ -1,3 +1,5 @@
+<a id="top"></a>
+
 <table align="center">
     <td align="center" width=1000>
         <h6>
@@ -30,15 +32,15 @@
 <a href="https://www.npmjs.com/package/@adamlui/scss-to-css">
     <img height=31 src="https://img.shields.io/npm/dm/%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-fc4f2d.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.11.1">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-1.11.1-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+    <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/scss-to-css-2.0.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.0.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=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_scss-to-css:node.js/src/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_scss-to-css%3Anode.js%2Fsrc%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>
 <a href="https://github.com/toolleeo/cli-apps#conversion">
-    <img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+    <img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-ff69b4?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 
 <img height=6px width="100%" src="https://assets.scsstocss.org/images/separators/aqua-gradient.png?v=7e4a141">
 
@@ -91,7 +93,7 @@ $ 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 + source map files will be stored, relative to original file location (if not provided, `css/` is used).
+- `[output_path]`: Path to file or directory where CSS + source map files will be stored, relative to input root (if not provided, `css/` is used).
 
 **📝 Note:** If folders are passed, files will be processed recursively unless `-R` or `--no-recursion` is passed.
 
@@ -117,13 +119,13 @@ Compile all SCSS files in the **current directory** (outputs to `css/`):
 $ scss-to-css
 ```
 
-Compile all SCSS files in a **specific directory** (outputs to `path/to/your/directory/css/`):
+Compile all SCSS files in a **specific directory** (outputs to `css/path/to/your/directory/`):
 
 ```
 $ scss-to-css path/to/your/directory
 ```
 
-Compile a **specific file** (outputs to `path/to/your/css/file.min.css`):
+Compile a **specific file** (outputs to `css/path/to/your/file.min.css`):
 
 ```
 $ scss-to-css path/to/your/file.scss
@@ -149,13 +151,14 @@ Boolean options:
  -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.
+ -r, --relative-output       Output files relative to each source file instead of to input root.
  -c, --copy                  Copy compiled CSS to clipboard instead of
                              writing to file if single source file is
                              processed.
  -q, --quiet                 Suppress all logging except errors.
 
 Parameter options:
- --ignore-files="file1.scss,file2.scss"   Files to exclude from
+ --ignores="dir/,file1.scss,file2.scss"   Files/directories to exclude from
                                           compilation.
  --comment="comment"                      Prepend header comment to
                                           compiled CSS. Separate by
@@ -182,7 +185,7 @@ import scssToCSS from '@adamlui/scss-to-css';
 #### CJS:
 
 ```js
-const scssToCSS = require('@adamlui/scss-to-css');
+const scssToCSS = require('@adamlui/scss-to-css')
 ```
 
 ###### _*Node.js version 14 or higher required_
@@ -197,10 +200,10 @@ If **source code** is passed, it is directly compiled, then an object containing
 
 ```js
 const srcCode = 'h1 { font-size: 40px ; code { font-face: Roboto Mono }}',
-      compileResult = scssToCSS.compile(srcCode);
+      compileResult = scssToCSS.compile(srcCode)
 
-console.log(compileResult.error); // outputs runtime error, or `undefined` if no error
-console.log(compileResult.code);  // outputs minified CSS: 'h1{font-size:40px}h1 code{font-face:Roboto Mono}'
+console.log(compileResult.error) // outputs runtime error, or `undefined` if no error
+console.log(compileResult.code)  // outputs minified CSS: 'h1{font-size:40px}h1 code{font-face:Roboto Mono}'
 ```
 
 If a **file path** is passed, the file's code is loaded then compiled to CSS, returning an object like above.
@@ -209,31 +212,32 @@ 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 compileResults = scssToCSS.compile('.');
-compileResults.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(compileResults[1].code);
+console.log(compileResults[1].code)
 ```
 
 Options are boolean, passed as object properties. For example:
 
 ```js
 // Returns array of data objects where `.code` contains unminified CSS
-scssToCSS.compile(inputDir, { minify: false });
+scssToCSS.compile(inputDir, { minify: false })
 ```
 
 Available parameters (and their default settings) are:
 
-Name          | Type    | Desciption                                                              | Default value
---------------|---------|-------------------------------------------------------------------------|---------------
-`recursive`   | Boolean | Recursively search for nested files if dir path passed.                 | `true`
-`verbose`     | Boolean | Show logging in console/terminal.                                       | `true`
-`dotFolders`  | Boolean | Include dotfolders in file search.                                      | `false`
-`minify`      | Boolean | Minify output CSS.                                                      | `true`
-`sourceMaps`  | Boolean | Generate CSS source maps.                                               | `true`
-`ignoreFiles` | Array   | Files (by name) to exclude from compilation.                            | `[]`
-`comment`     | String  | Header comment to prepend to compiled CSS. Separate by line using '\n'. | `''`
+Name             | Type    | Desciption                                                              | Default value
+-----------------|---------|-------------------------------------------------------------------------|---------------
+`recursive`      | Boolean | Recursively search for nested files if dir path passed.                 | `true`
+`verbose`        | Boolean | Show logging in console/terminal.                                       | `true`
+`dotFolders`     | Boolean | Include dotfolders in file search.                                      | `false`
+`minify`         | Boolean | Minify output CSS.                                                      | `true`
+`sourceMaps`     | Boolean | Generate CSS source maps.                                               | `true`
+`relativeOutput` | Boolean | Output files relative to each source file instead of to input root.     | `false`
+`ignores`        | Array   | Files/dirs to exclude from compilation.                                 | `[]`
+`comment`        | String  | Header comment to prepend to compiled CSS. Separate by line using '\n'. | `''`
 
 #
 
@@ -245,8 +249,8 @@ Options are boolean, passed as object properties. For example:
 
 ```js
 // Search for SCSS files in exactly assets/scss
-const searchResults = scssToCSS.findSCSS('assets/scss', { recursive: false });
-console.log(searchResults);
+const searchResults = scssToCSS.findSCSS('assets/scss', { recursive: false })
+console.log(searchResults)
 
 /* sample output:
 
@@ -267,7 +271,7 @@ Name          | Type    | Desciption
 `recursive`   | Boolean | Recursively search for nested files in searchDir passed. | `true`
 `verbose`     | Boolean | Show logging in console/terminal.                        | `true`
 `dotFolders`  | Boolean | Include dotfolders in file search.                       | `false`
-`ignoreFiles` | Array   | Files (by name) to exclude from search results.          | `[]`
+`ignores`     | Array   | Files/dirs to exclude from search results.               | `[]`
 
 <br>
 
@@ -289,12 +293,6 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ## 🛠️ Related utilities
 
-### [🖼️ img-to-webp](https://github.com/adamlui/js-utils/tree/main/img-to-webp)
-
-> Recursively compress all images to WEBPs.
-<br>[Download](https://cdn.jsdelivr.net/gh/adamlui/js-utils/img-to-webp/img-to-webp.js) /
-[Discuss](https://github.com/adamlui/js-utils/discussions)
-
 ### [</> minify.js](https://minify-js.org) &nbsp;<a href="https://github.com/toolleeo/cli-apps#programming"><img height=18 src="https://assets.scsstocss.org/images/badges/awesome/badge.svg?v=7e4a141"></a>
 
 > Recursively minify all JavaScript files.
@@ -310,4 +308,4 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 <picture><source media="(prefers-color-scheme: dark)" srcset="https://assets.scsstocss.org/images/icons/home/white/icon32x27.png?v=7e4a141"><img height=13 src="https://assets.scsstocss.org/images/icons/home/dark-gray/icon32x27.png?v=7e4a141"></picture> <a href="https://js-utils.org">**More JavaScript utilities**</a> /
 <a href="https://github.com/adamlui/scss-to-css/discussions">Discuss</a> /
-<a href="#--scss-to-css">Back to top ↑</a>
+<a href="#top">Back to top ↑</a>

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@adamlui/scss-to-css",
-  "version": "1.11.1",
+  "version": "2.0.0",
   "description": "Recursively compile all SCSS files into minified CSS",
   "author": {
     "name": "Adam Lui",
     "email": "adam@kudoai.com",
     "url": "https://github.com/adamlui"
   },
-  "homepage": "https://scsstocss.org",
+  "homepage": "https://github.com/adamlui/scss-to-css",
   "license": "MIT",
   "funding": [
     {
@@ -61,13 +61,13 @@
     "stylesheets"
   ],
   "bugs": {
-    "url": "https://support.scsstocss.org"
+    "url": "https://github.com/adamlui/scss-to-css/issues"
   },
   "dependencies": {
     "node-clipboardy": "^1.0.3",
-    "sass": "^1.97.1"
+    "sass": "^1.97.2"
   },
   "devDependencies": {
-    "@adamlui/minify.js": "^1.8.6"
+    "@adamlui/minify.js": "^2.1.0"
   }
 }