@adamlui/scss-to-css 1.8.5 → 1.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -15
- package/dist/cli.min.js +16 -13
- package/dist/scss-to-css.min.js +10 -4
- package/docs/README.md +29 -15
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
|
|
30
30
|
<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>
|
|
31
31
|
<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>
|
|
32
|
-
<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.
|
|
32
|
+
<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.10.0"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.10.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
33
33
|
<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>
|
|
34
34
|
<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>
|
|
35
35
|
<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>
|
|
@@ -58,6 +58,8 @@ $ npm install @adamlui/scss-to-css
|
|
|
58
58
|
|
|
59
59
|
<br>
|
|
60
60
|
|
|
61
|
+
<a href="https://github.com/sponsors/adamlui"><img src="https://media.scsstocss.org/images/banners/sponsor/$10/banner1660x260.png?2cba0ae"></a>
|
|
62
|
+
|
|
61
63
|
<img height=6px width="100%" src="https://media.scsstocss.org/images/separators/gradient-aqua.png?52b67bc">
|
|
62
64
|
|
|
63
65
|
## 💻 Command line usage
|
|
@@ -134,15 +136,24 @@ $ scss-to-css input_folder output_folder
|
|
|
134
136
|
### Command line options
|
|
135
137
|
|
|
136
138
|
```
|
|
137
|
-
|
|
139
|
+
Boolean options:
|
|
138
140
|
-n, --dry-run Don't actually compile the file(s), just
|
|
139
141
|
show if they will be processed.
|
|
140
142
|
-d, --include-dotfolders Include dotfolders in file search.
|
|
141
143
|
-S, --no-source-maps Prevent source maps from being generated.
|
|
142
144
|
-M, --no-minify Disable minification of output CSS.
|
|
143
145
|
-R, --no-recursion Disable recursive file searching.
|
|
146
|
+
-c, --copy Copy compiled CSS to clipboard instead of
|
|
147
|
+
writing to file if single source file is
|
|
148
|
+
processed.
|
|
144
149
|
-q, --quiet Suppress all logging except errors.
|
|
145
150
|
|
|
151
|
+
Parameter options:
|
|
152
|
+
--ignore-files="file1.scss,file2.scss" Files to exclude from
|
|
153
|
+
compilation.
|
|
154
|
+
--comment="comment" Prepend header comment to
|
|
155
|
+
compiled CSS. Separate by
|
|
156
|
+
line using '\n'.
|
|
146
157
|
Info commands:
|
|
147
158
|
-h, --help Display help screen.
|
|
148
159
|
-v, --version Show version number.
|
|
@@ -208,13 +219,15 @@ scssToCSS.compile(inputDir, { minify: false });
|
|
|
208
219
|
|
|
209
220
|
Available parameters (and their default settings) are:
|
|
210
221
|
|
|
211
|
-
Name
|
|
212
|
-
|
|
213
|
-
`recursive`
|
|
214
|
-
`verbose`
|
|
215
|
-
`dotFolders` | Include dotfolders in file search.
|
|
216
|
-
`minify`
|
|
217
|
-
`sourceMaps` | Generate CSS source maps.
|
|
222
|
+
Name | Type | Desciption | Default value
|
|
223
|
+
--------------|---------|-------------------------------------------------------------------------|---------------
|
|
224
|
+
`recursive` | Boolean | Recursively search for nested files if dir path passed. | `true`
|
|
225
|
+
`verbose` | Boolean | Show logging in console/terminal. | `true`
|
|
226
|
+
`dotFolders` | Boolean | Include dotfolders in file search. | `false`
|
|
227
|
+
`minify` | Boolean | Minify output CSS. | `true`
|
|
228
|
+
`sourceMaps` | Boolean | Generate CSS source maps. | `true`
|
|
229
|
+
`ignoreFiles` | Array | Files (by name) to exclude from compilation. | `[]`
|
|
230
|
+
`comment` | String | Header comment to prepend to compiled CSS. Separate by line using '\n'. | `''`
|
|
218
231
|
|
|
219
232
|
#
|
|
220
233
|
|
|
@@ -243,11 +256,12 @@ findSCSS() » Check returned array.
|
|
|
243
256
|
|
|
244
257
|
Available parameters (and their default settings) are:
|
|
245
258
|
|
|
246
|
-
Name
|
|
247
|
-
|
|
248
|
-
`recursive`
|
|
249
|
-
`verbose`
|
|
250
|
-
`dotFolders` | Include dotfolders in file search. | `false`
|
|
259
|
+
Name | Type | Desciption | Default value
|
|
260
|
+
--------------|---------|----------------------------------------------------------|---------------
|
|
261
|
+
`recursive` | Boolean | Recursively search for nested files in searchDir passed. | `true`
|
|
262
|
+
`verbose` | Boolean | Show logging in console/terminal. | `true`
|
|
263
|
+
`dotFolders` | Boolean | Include dotfolders in file search. | `false`
|
|
264
|
+
`ignoreFiles` | Array | Files (by name) to exclude from search results. | `[]`
|
|
251
265
|
|
|
252
266
|
<br>
|
|
253
267
|
|
|
@@ -275,7 +289,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
|
|
|
275
289
|
<br>[Download](https://cdn.jsdelivr.net/gh/adamlui/js-utils/img-to-webp/img-to-webp.js) /
|
|
276
290
|
[Discuss](https://github.js-utils.com/discussions)
|
|
277
291
|
|
|
278
|
-
### [</> minify.js](https://minify-js.org)
|
|
292
|
+
### [</> minify.js](https://minify-js.org) <a href="https://github.com/toolleeo/cli-apps#programming"><img height=18 src="https://media.scsstocss.org/images/badges/awesome/badge.svg?52b67bc"></a>
|
|
279
293
|
|
|
280
294
|
> Recursively minify all JavaScript files.
|
|
281
295
|
<br>[Install](https://node.minify-js.org/#-installation) /
|
package/dist/cli.min.js
CHANGED
|
@@ -4,23 +4,26 @@
|
|
|
4
4
|
* Source: https://code.scsstocss.org/node.js
|
|
5
5
|
* Documentation: https://docs.scsstocss.org/node.js
|
|
6
6
|
*/
|
|
7
|
-
const pkgName="@adamlui/scss-to-css",copyright="© 2024 Adam Lui & contributors under the MIT license.",cmdFormat="scss-to-css [inputPath] [outputPath] [options]",srcURL="https://code.scsstocss.org/node.js",docURL="https://docs.scsstocss.org/node.js/#-command-line-usage",scssToCSS=require(__dirname.match(/src/)?"./scss-to-css":"./scss-to-css.min"),fs=require("fs"),path=require("path"),execSync=require("child_process")["execSync"],nc="[0m",br="[1;91m",by="[1;33m",bg="[1;92m",bw="[1;97m",config={},reArgs={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)
|
|
7
|
+
const pkgName="@adamlui/scss-to-css",copyright="© 2024 Adam Lui & contributors under the MIT license.",cmdFormat="scss-to-css [inputPath] [outputPath] [options]",srcURL="https://code.scsstocss.org/node.js",docURL="https://docs.scsstocss.org/node.js/#-command-line-usage",scssToCSS=require(__dirname.match(/src/)?"./scss-to-css":"./scss-to-css.min"),fs=require("fs"),path=require("path"),ncp=require("node-clipboardy"),execSync=require("child_process")["execSync"],nc="[0m",br="[1;91m",by="[1;33m",bg="[1;92m",bw="[1;97m",config={},reArgs={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,n;s.startsWith("-")&&(n=Object.keys(reArgs.flags).find(e=>reArgs.flags[e].test(s)),e=Object.keys(reArgs.paramOptions).find(e=>reArgs.paramOptions[e].test(s)),o=Object.keys(reArgs.infoCmds).find(e=>reArgs.infoCmds[e].test(s)),n?config[n]=!0:e?(/=.+/.test(s)||(console.error(`
|
|
8
|
+
${br}ERROR: Arg [--${s.replace(/-/g,"")}] requires '=' followed by a value.`+nc),printHelpCmdAndDocURL(),process.exit(1)),n=s.split("=")[1],config[e]=parseInt(n)||n):o||(console.error(`
|
|
8
9
|
${br}ERROR: Arg [${s}] not recognized.`+nc),console.info(`
|
|
9
|
-
${by}Valid arguments are below.`+nc),printHelpSections(["
|
|
10
|
-
Global version: `+
|
|
10
|
+
${by}Valid arguments are below.`+nc),printHelpSections(["flags","paramOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>reArgs.infoCmds.help.test(e)))printHelpSections();else if(process.argv.some(e=>reArgs.infoCmds.version.test(e))){const k=execSync(`npm view ${pkgName} version`).toString().trim()||"none";let e,s=process.cwd();for(;"/"!=s;){const n=path.join(s,"package.json");if(fs.existsSync(n)){const o=require(n);e=(o.dependencies?.[pkgName]||o.devDependencies?.[pkgName])?.match(/(\d+\.\d+\.\d+)/)[0]||"none";break}s=path.dirname(s)}console.info(`
|
|
11
|
+
Global version: `+k),console.info("Local version: "+e)}else{const[p="",q=""]=process.argv.slice(2).filter(e=>!e.startsWith("-")).map(e=>e.replace(/^\/*/,""));let e=path.resolve(process.cwd(),p);if(p&&!fs.existsSync(e)){const v=e+".scss";fs.existsSync(v)?e=v:(console.error(`
|
|
11
12
|
${br}Error: First argument can only be an existing file or directory.`+`
|
|
12
|
-
'${
|
|
13
|
-
|
|
13
|
+
'${e}' does not exist.`+nc),console.info(`
|
|
14
14
|
${bg}Example valid command:
|
|
15
|
-
» scss-to-css . output.min.css`+nc),printHelpCmdAndDocURL(),process.exit(1))
|
|
16
|
-
${by}SCSS files to be compiled:`+nc),
|
|
17
|
-
No SCSS files will be compiled.`+nc);else{const
|
|
18
|
-
${bg}Compilation complete!`+nc),printIfNotQuiet(bw+
|
|
19
|
-
|
|
15
|
+
» scss-to-css . output.min.css`+nc),printHelpCmdAndDocURL(),process.exit(1))}const s=e.endsWith(".scss")?[e]:scssToCSS.findSCSS(e,{recursive:!config.noRecursion,verbose:!config.quietMode,ignoreFiles:(config.ignoreFiles?.split(",")??[]).map(e=>e.trim())});if(config.dryRun)0<s.length?(console.info(`
|
|
16
|
+
${by}SCSS files to be compiled:`+nc),s.forEach(e=>console.info(e))):console.info(by+`
|
|
17
|
+
No SCSS files will be compiled.`+nc);else{const y=[],z=s.map(e=>{var s=scssToCSS.compile(e,{verbose:!config.quietMode,minify:!config.noMinify,sourceMaps:!config.noSourceMaps,comment:config.comment?.replace(/\\n/g,"\n")});return s.error&&y.push(e),s}).filter(e=>!e.error);if(0<z?.length){const D=1<z.length?"s":"";printIfNotQuiet(`
|
|
18
|
+
${bg}Compilation complete!`+nc),printIfNotQuiet(bw+z.length+" CSS file"+D+(config.noSourceMaps?"":` + ${z.length} source map`+D)+" generated."+nc)}else printIfNotQuiet(`
|
|
19
|
+
${by}No SCSS files processed.`+nc);0<y.length&&(printIfNotQuiet(`
|
|
20
|
+
`+br+y.length+" file"+(1<y.length?"s":"")+" failed to compile:"+nc),y.forEach(e=>printIfNotQuiet(e))),0==z?.length&&process.exit(0),config.copy&&1==z?.length?(printIfNotQuiet("\nCopying to clipboard..."),ncp.writeSync(z[0].code)):(printIfNotQuiet(`
|
|
21
|
+
Writing to file${1<z?.length?"s":""}...`),z?.forEach(({code:e,srcMap:s,srcPath:o})=>{var n=path.join(path.dirname(o),/(?:src|s[ac]ss)$/.test(path.dirname(o))?"../"+(q||"css"):q.endsWith(".css")?path.dirname(q):q||"css"),o=(q.endsWith(".css")&&p.endsWith(".scss")?path.basename(q).replace(/(\.min)?\.css$/,""):path.basename(o,".scss"))+".min.css",o=path.join(n,o);fs.existsSync(n)||fs.mkdirSync(n,{recursive:!0}),fs.writeFileSync(o,e,"utf8"),config.noSourceMaps||fs.writeFileSync(o+".map",JSON.stringify(s),"utf8")}))}}function printHelpSections(e=["header","usage","pathArgs","flags","paramOptions","infoCmds"]){var s=`[106m[30m ${pkgName.replace(/^@[^/]+\//,"")} ${nc} `;const o={header:[`
|
|
20
22
|
├ `+s+copyright,s+"Source: "+srcURL],usage:[`
|
|
21
23
|
${bw}o Usage:`+nc,` ${bw}» `+(bg+cmdFormat+nc)],pathArgs:[`
|
|
22
|
-
${bw}o Path arguments:`+nc," [inputPath]
|
|
23
|
-
${bw}o
|
|
24
|
-
${bw}o
|
|
24
|
+
${bw}o Path arguments:`+nc," [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:[`
|
|
25
|
+
${bw}o Boolean options:`+nc," -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:[`
|
|
26
|
+
${bw}o Parameter options:`+nc,'--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:[`
|
|
27
|
+
${bw}o Info commands:`+nc," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(t=>{o[t]?.forEach(e=>{{var n=/header|usage/.test(t)?1:41;const i=process.stdout.columns||80,r=[],s=e.match(/\S+|\s+/g);let o="";s.forEach(e=>{var s=i-(0==r.length?0:n);o.length+"| ".length+e.length>s&&(r.push(0==r.length?o:o.trimStart()),o=""),o+=e}),r.push(0==r.length?o:o.trimStart()),r.forEach((e,s)=>console.info("| "+(0==s?e:" ".repeat(n)+e)))}})}),console.info("\nFor more help, please visit: "+bw+docURL+nc)}function printHelpCmdAndDocURL(){console.info(`
|
|
25
28
|
For more help, type 'scss-to-css --help' or visit
|
|
26
29
|
`+(bw+docURL+nc))}function printIfNotQuiet(e){config.quietMode||console.info(e)}
|
package/dist/scss-to-css.min.js
CHANGED
|
@@ -4,10 +4,16 @@
|
|
|
4
4
|
* Source: https://code.scsstocss.org/node.js
|
|
5
5
|
* Documentation: https://docs.scsstocss.org/node.js
|
|
6
6
|
*/
|
|
7
|
-
const fs=require("fs"),path=require("path"),sass=require("sass");function findSCSS(o,r={}){var e="https://docs.scsstocss.org/node.js/#findscsssearchdir-options",s={recursive:!0,verbose:!0,dotFolders:!1};if("string"!=typeof o)console.error("findSCSS() » ERROR: 1st arg <searchDir> must be a string."),console.info("findSCSS() » For more help, please visit "+e);else{var i=path.resolve(process.cwd(),o);if(fs.existsSync(i)){if(validateOptions(r,s,e,"findSCSS('assets/scss', { verbose: false, dotFolders: true })")){r={...s,...r};const n=fs.readdirSync(o),c=[];return r.verbose&&!r.isRecursing&&console.info("findSCSS() » Searching for SCSS files..."),n.forEach(e=>{var s=path.resolve(o,e);fs.statSync(s).isDirectory()&&"node_modules"!=e&&(r.dotFolders||!e.startsWith("."))
|
|
7
|
+
const fs=require("fs"),path=require("path"),sass=require("sass");function findSCSS(o,r={}){var e="https://docs.scsstocss.org/node.js/#findscsssearchdir-options",s={recursive:!0,verbose:!0,dotFolders:!1,ignoreFiles:[]};if("string"!=typeof o)console.error("findSCSS() » ERROR: 1st arg <searchDir> must be a string."),console.info("findSCSS() » For more help, please visit "+e);else{var i=path.resolve(process.cwd(),o);if(fs.existsSync(i)){if(validateOptions(r,s,e,"findSCSS('assets/scss', { verbose: false, dotFolders: true })")){r={...s,...r};const n=fs.readdirSync(o),c=[];return r.verbose&&!r.isRecursing&&console.info("findSCSS() » Searching for SCSS files..."),n.forEach(e=>{var s=path.resolve(o,e);fs.statSync(s).isDirectory()&&"node_modules"!=e&&r.recursive&&(r.dotFolders||!e.startsWith("."))?c.push(...findSCSS(s,{...r,isRecursing:!0})):e.endsWith(".scss")&&!r.ignoreFiles.includes(e)?c.push(s):r.verbose&&r.ignoreFiles.includes(e)&&console.info(`findSCSS() » ** ${e} ignored due to [options.ignoreFiles]`)}),!r.isRecursing&&r.verbose&&(console.info("findSCSS() » Search complete! "+(0==c.length?"No":c.length)+` file${1==c.length?"":"s"} found.`),"compile"==findSCSS.caller.name||/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("findSCSS() » Check returned array.")),r.isRecursing||0<c.length?c:[]}}else console.error("findSCSS() » ERROR: 1st arg <searchDir> must be an existing directory."),console.error(`findSCSS() » ${i} does not exist.`),console.info("findSCSS() » For more help, please visit "+e)}}function compile(e,o={}){var s="https://docs.scsstocss.org/node.js/#compileinput-options",r={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(o,r,s,"compile('assets/scss', { recursive: false, minify: false })")){const t={style:(o={...r,...o}).minify?"compressed":"expanded",sourceMap:o.sourceMaps};if(fs.existsSync(e)){if(!e.endsWith(".scss"))return s=findSCSS(e,{recursive:o.recursive,verbose:o.verbose,dotFolders:o.dotFolders,ignoreFiles:o.ignoreFiles})?.map(e=>{o.verbose&&console.info(`compile() » ** Compiling ${e}...`);try{var s=sass.compile(e,t);return o.comment&&(s.css=c(s.css,o.comment)),{code:s.css,srcMap:s.sourceMap,srcPath:e,error:void 0}}catch(e){return console.error(`
|
|
8
8
|
compile() » ERROR: ${e.message}
|
|
9
|
-
`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}).filter(e=>!e.error),o.verbose&&(0<s.length?console.info("compile() » Compilation complete! Check returned object."):console.info("compile() » No SCSS files processed.")),s;o.verbose&&console.info(`compile() » ** Compiling ${e}...`);try{var i=sass.compile(e,
|
|
9
|
+
`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}).filter(e=>!e.error),o.verbose&&(0<s.length?console.info("compile() » Compilation complete! Check returned object."):console.info("compile() » No SCSS files processed.")),s;o.verbose&&console.info(`compile() » ** Compiling ${e}...`);try{var i=sass.compile(e,t);return o.comment&&(i.css=c(i.css,o.comment)),o.verbose&&!/cli(?:\.min)?\.js$/.test(require.main.filename)&&console.info("compile() » Compilation complete! Check returned object."),{code:i.css,srcMap:i.sourceMap,srcPath:path.resolve(process.cwd(),e),error:void 0}}catch(e){return console.error(`
|
|
10
10
|
compile() » ERROR: ${e.message}
|
|
11
|
-
`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}else{o.verbose&&console.info("compile() » ** Compiling passed source code...");try{var n=sass.compileString(e,
|
|
11
|
+
`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}else{o.verbose&&console.info("compile() » ** Compiling passed source code...");try{var n=sass.compileString(e,t);return o.comment&&(n.css=c(n.css,o.comment)),{code:n.css,srcMap:n.sourceMap,srcPath:void 0,error:void 0}}catch(e){return console.error(`
|
|
12
12
|
compile() » ERROR: ${e.message}
|
|
13
|
-
`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}
|
|
13
|
+
`),{code:void 0,srcMap:void 0,srcPath:void 0,error:e}}}function c(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)+`/**
|
|
14
|
+
${s}
|
|
15
|
+
*/
|
|
16
|
+
`+e.slice(o)):`/**
|
|
17
|
+
${s}
|
|
18
|
+
*/
|
|
19
|
+
`+e}}}function validateOptions(e,s,o,r){const i=JSON.stringify(s,null,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]));let a="validateOptions() » ";try{a=validateOptions.caller?.name+"() » "}catch(e){}var d=r.split(",").findIndex(e=>e.trim().startsWith("{"))+1,p=(d+=["st","nd","rd"][d-1]||"th",()=>{console.info(`${a}Valid options: [ ${n} ]`),console.info(a+"If omitted, default settings are: "+i)}),f=()=>{console.info(a+"For more help, please visit "+o)};if("object"!=typeof e)return console.error(a+`ERROR: ${"0th"==d?"[O":d+" arg [o"}ptions] can only be an object of key/values.`),console.info(a+"Example valid call: "+r),p(),f(),!1;for(const m in e){if("isRecursing"!=m&&!Object.prototype.hasOwnProperty.call(s,m))return console.error(`${a}ERROR: \`${m}\` is an invalid option.`),p(),f(),!1;if(c.includes(m)&&"boolean"!=typeof e[m])return console.error(`${a}ERROR: [${m}] option can only be \`true\` or \`false\`.`),f(),!1;if(t.includes(m)){if(e[m]=parseInt(e[m],10),isNaN(e[m])||e[m]<1)return console.error(`${a}ERROR: [${m}] option can only be an integer > 0.`),f(),!1}else if(l.includes(m))if("string"!=typeof e[m]||e[m].includes(",")){if(!Array.isArray(e[m]))return console.error(`${a}ERROR: [${m}] option can only be an array.`),f(),!1}else e[m]=[e[m]]}return!0}const funcAliases={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(const Z in funcAliases)funcAliases[Z].forEach(e=>module.exports[e]=module.exports[Z]);
|
package/docs/README.md
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
|
|
30
30
|
<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>
|
|
31
31
|
<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>
|
|
32
|
-
<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.
|
|
32
|
+
<a href="https://github.com/adamlui/js-utils/releases/tag/scss-to-css-1.10.0"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.10.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
|
|
33
33
|
<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>
|
|
34
34
|
<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>
|
|
35
35
|
<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>
|
|
@@ -58,6 +58,8 @@ $ npm install @adamlui/scss-to-css
|
|
|
58
58
|
|
|
59
59
|
<br>
|
|
60
60
|
|
|
61
|
+
<a href="https://github.com/sponsors/adamlui"><img src="https://media.scsstocss.org/images/banners/sponsor/$10/banner1660x260.png?2cba0ae"></a>
|
|
62
|
+
|
|
61
63
|
<img height=6px width="100%" src="https://media.scsstocss.org/images/separators/gradient-aqua.png?52b67bc">
|
|
62
64
|
|
|
63
65
|
## 💻 Command line usage
|
|
@@ -134,15 +136,24 @@ $ scss-to-css input_folder output_folder
|
|
|
134
136
|
### Command line options
|
|
135
137
|
|
|
136
138
|
```
|
|
137
|
-
|
|
139
|
+
Boolean options:
|
|
138
140
|
-n, --dry-run Don't actually compile the file(s), just
|
|
139
141
|
show if they will be processed.
|
|
140
142
|
-d, --include-dotfolders Include dotfolders in file search.
|
|
141
143
|
-S, --no-source-maps Prevent source maps from being generated.
|
|
142
144
|
-M, --no-minify Disable minification of output CSS.
|
|
143
145
|
-R, --no-recursion Disable recursive file searching.
|
|
146
|
+
-c, --copy Copy compiled CSS to clipboard instead of
|
|
147
|
+
writing to file if single source file is
|
|
148
|
+
processed.
|
|
144
149
|
-q, --quiet Suppress all logging except errors.
|
|
145
150
|
|
|
151
|
+
Parameter options:
|
|
152
|
+
--ignore-files="file1.scss,file2.scss" Files to exclude from
|
|
153
|
+
compilation.
|
|
154
|
+
--comment="comment" Prepend header comment to
|
|
155
|
+
compiled CSS. Separate by
|
|
156
|
+
line using '\n'.
|
|
146
157
|
Info commands:
|
|
147
158
|
-h, --help Display help screen.
|
|
148
159
|
-v, --version Show version number.
|
|
@@ -208,13 +219,15 @@ scssToCSS.compile(inputDir, { minify: false });
|
|
|
208
219
|
|
|
209
220
|
Available parameters (and their default settings) are:
|
|
210
221
|
|
|
211
|
-
Name
|
|
212
|
-
|
|
213
|
-
`recursive`
|
|
214
|
-
`verbose`
|
|
215
|
-
`dotFolders` | Include dotfolders in file search.
|
|
216
|
-
`minify`
|
|
217
|
-
`sourceMaps` | Generate CSS source maps.
|
|
222
|
+
Name | Type | Desciption | Default value
|
|
223
|
+
--------------|---------|-------------------------------------------------------------------------|---------------
|
|
224
|
+
`recursive` | Boolean | Recursively search for nested files if dir path passed. | `true`
|
|
225
|
+
`verbose` | Boolean | Show logging in console/terminal. | `true`
|
|
226
|
+
`dotFolders` | Boolean | Include dotfolders in file search. | `false`
|
|
227
|
+
`minify` | Boolean | Minify output CSS. | `true`
|
|
228
|
+
`sourceMaps` | Boolean | Generate CSS source maps. | `true`
|
|
229
|
+
`ignoreFiles` | Array | Files (by name) to exclude from compilation. | `[]`
|
|
230
|
+
`comment` | String | Header comment to prepend to compiled CSS. Separate by line using '\n'. | `''`
|
|
218
231
|
|
|
219
232
|
#
|
|
220
233
|
|
|
@@ -243,11 +256,12 @@ findSCSS() » Check returned array.
|
|
|
243
256
|
|
|
244
257
|
Available parameters (and their default settings) are:
|
|
245
258
|
|
|
246
|
-
Name
|
|
247
|
-
|
|
248
|
-
`recursive`
|
|
249
|
-
`verbose`
|
|
250
|
-
`dotFolders` | Include dotfolders in file search. | `false`
|
|
259
|
+
Name | Type | Desciption | Default value
|
|
260
|
+
--------------|---------|----------------------------------------------------------|---------------
|
|
261
|
+
`recursive` | Boolean | Recursively search for nested files in searchDir passed. | `true`
|
|
262
|
+
`verbose` | Boolean | Show logging in console/terminal. | `true`
|
|
263
|
+
`dotFolders` | Boolean | Include dotfolders in file search. | `false`
|
|
264
|
+
`ignoreFiles` | Array | Files (by name) to exclude from search results. | `[]`
|
|
251
265
|
|
|
252
266
|
<br>
|
|
253
267
|
|
|
@@ -275,7 +289,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
|
|
|
275
289
|
<br>[Download](https://cdn.jsdelivr.net/gh/adamlui/js-utils/img-to-webp/img-to-webp.js) /
|
|
276
290
|
[Discuss](https://github.js-utils.com/discussions)
|
|
277
291
|
|
|
278
|
-
### [</> minify.js](https://minify-js.org)
|
|
292
|
+
### [</> minify.js](https://minify-js.org) <a href="https://github.com/toolleeo/cli-apps#programming"><img height=18 src="https://media.scsstocss.org/images/badges/awesome/badge.svg?52b67bc"></a>
|
|
279
293
|
|
|
280
294
|
> Recursively minify all JavaScript files.
|
|
281
295
|
<br>[Install](https://node.minify-js.org/#-installation) /
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@adamlui/scss-to-css",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.0",
|
|
4
4
|
"description": "Recursively compile all SCSS files into minified CSS",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Adam Lui",
|
|
@@ -11,7 +11,6 @@
|
|
|
11
11
|
"license": "MIT",
|
|
12
12
|
"main": "dist/scss-to-css.min.js",
|
|
13
13
|
"files": [
|
|
14
|
-
"dist",
|
|
15
14
|
"docs/",
|
|
16
15
|
"!docs/*/"
|
|
17
16
|
],
|
|
@@ -55,9 +54,10 @@
|
|
|
55
54
|
"url": "https://github.com/sponsors/adamlui"
|
|
56
55
|
},
|
|
57
56
|
"dependencies": {
|
|
58
|
-
"
|
|
57
|
+
"node-clipboardy": "^1.0.3",
|
|
58
|
+
"sass": "^1.77.1"
|
|
59
59
|
},
|
|
60
60
|
"devDependencies": {
|
|
61
|
-
"@adamlui/minify.js": "^1.6.
|
|
61
|
+
"@adamlui/minify.js": "^1.6.3"
|
|
62
62
|
}
|
|
63
63
|
}
|