@adamlui/scss-to-css 2.2.1 → 2.3.1

package/dist/cli/lib/settings.js

@@ -0,0 +1,158 @@
+const fs = require('fs'),
+      path = require('path')
+
+;(globalThis.cli ??= {}).config = {}
+
+module.exports = {
+    configFilename: 'scss-to-css.config.mjs',
+
+    controls: {
+        dryRun: {
+            type: 'flag', regex: /^--?(?:n|dry[-_]?run)$/ },
+        includeDotFolders: {
+            type: 'flag', regex: /^--?(?:dd?|(?:include[-_]?)?dot[-_]?(?:folder|dir(?:ector(?:y|ie))?)s?=?(?:true|1)?)$/ },
+        noSourceMaps: {
+            type: 'flag', regex: /^--?(?:S|(?:exclude|disable|no)[-_]?so?u?rce?[-_]?maps?|so?u?rce?[-_]?maps?=(?:false|0))$/ },
+        noRecursion: {
+            type: 'flag', regex: /^--?(?:R|(?:disable|no)[-_]?recursi(?:on|ve)|recursi(?:on|ve)=(?:false|0))$/ },
+        noMinify: {
+            type: 'flag', regex: /^--?(?:M|(?:disable|no)[-_]?minif(?:y|ication)|minif(?:y|ication)=(?:false|0))$/ },
+        relativeOutput: {
+            type: 'flag', regex: /^--?(?:r|relative[-_]?output?=?(?:true|1)?)$/ },
+        copy: {
+            type: 'flag', regex: /^--?c(?:opy)?$/ },
+        quietMode: {
+            type: 'flag', regex: /^--?q(?:uiet)?(?:[-_]?mode)?$/ },
+        ignores: {
+            type: 'param', parser: val => val.split(',').map(val => val.trim()),
+            regex: /^--?(?:ignores?|(?:ignore|skip|exclude)(?:d?[-_]?files?)?)(?:[=\s].*|$)/
+        },
+        comment: {
+            type: 'param', parser: val => val.replace(/\\n/g, '\n'), regex: /^--?comments?(?:[=\s].*)?$/ },
+        uiLang: {
+            type: 'param', valType: 'langCode', regex: /^--?ui[-_]?lang(?:[=\s].*|$)/ },
+        config: {
+            type: 'param', valType: 'filepath', regex: /^--?config(?:[=\s].*|$)/ },
+        init: {
+            type: 'cmd', regex: /^-{0,2}i(?:nit)?$/ },
+        help: {
+            type: 'cmd', regex: /^--?h(?:elp)?$/ },
+        version: {
+            type: 'cmd', regex: /^--?ve?r?s?i?o?n?$/ },
+        stats: {
+            type: 'cmd', regex: /^--?stats?$/ }
+    },
+
+    load(ctrlKeys = Object.keys(this.controls)) {
+        const inputCtrlKeys = [].concat(ctrlKeys) // force array
+
+        if (!cli.defaultsSet && !arguments.length) { // init all defaults on arg-less load()
+            inputCtrlKeys.forEach(key => {
+                const ctrl = this.controls[key] ; if (ctrl.mode || ctrl.type == 'legacy') return
+                cli.config[key] ??= ctrl.defaultVal ?? ( ctrl.type == 'param' ? '' : false )
+            })
+            cli.defaultsSet = true
+            log.debug('All cli.config default vals set!')
+        }
+
+        if (!cli.configPathTried) { // init config file path
+            const configArg = env.args.find(arg => this.controls.config.regex.test(arg))
+
+            if (configArg) { // resolve input path, then validate
+                if (!/=/.test(configArg))
+                    log.errorAndExit(`[${configArg}] ${cli.msgs.error_mustIncludePath}`)
+                const inputPath = configArg.split('=')[1]
+                cli.configPath = path.isAbsolute(inputPath) ? inputPath : path.resolve(process.cwd(), inputPath)
+                if (!fs.existsSync(cli.configPath))
+                    log.configURLandExit(`${cli.msgs.error_configFileNotFound}:`, cli.configPath)
+
+            } else // auto-discover .config.[mc]?js file
+                for (const configExt of ['.mjs', '.cjs', '.js']) {
+                    const autoPath = path.resolve(process.cwd(), this.configFilename.replace(/\.[^.]+$/, configExt))
+                    if (fs.existsSync(autoPath)) { cli.configPath = autoPath ; break }
+                }
+
+            cli.configPathTried = true
+        }
+
+        if (cli.configPath) // load from config file
+            try {
+                const mod = require(cli.configPath), fileConfig = mod?.default ?? mod
+                if (!fileConfig || typeof fileConfig != 'object')
+                    log.configURLandExit(`${cli.msgs.error_invalidConfigFile}.`)
+                ;(arguments.length ? inputCtrlKeys : Object.keys(fileConfig)).forEach(key => {
+                    if (!(key in fileConfig)) return
+                    const val = fileConfig[key], ctrl = this.controls[key]
+                    if (!ctrl) {
+                        if (this.configFileKeyWhitelist && !this.configFileKeyWhitelist.includes(key))
+                            log.invalidConfigKey(key)
+                        return
+                    } else if (ctrl.type == 'legacy' && ctrl.replacedBy) {
+                        if (key.toLowerCase().includes('no') != ctrl.replacedBy.toLowerCase().includes('no'))
+                            cli.config[ctrl.replacedBy] = !val  // assign opposite val to current key
+                        else // assign direct val to current key
+                            cli.config[ctrl.replacedBy] = val
+                        return log.configKeyReplacedBy(key, ctrl.replacedBy, val)
+                    }
+                    cli.config[key] = val
+                })
+                if (!arguments.length) log.debug('Config file loaded!')
+            } catch (err) {
+                log.configURLandExit(`${cli.msgs.error_failedToLoadConfigFile}:`, cli.configPath, `\n${err.message}`) }
+
+        for (let i = 0 ; i < env.args.length ; i++) { // load from CLI arg (overriding config file loads)
+            const arg = env.args[i]
+            if (/^[^-]|--?(?:config|debug)/.test(arg) && arg != 'init') continue
+            const ctrlKey = Object.keys(this.controls).find(key => this.controls[key]?.regex?.test(arg))
+            if (!ctrlKey && cli.msgs) log.errorAndExit(`[${arg}] ${cli.msgs.error_notRecognized}.`)
+            if (!inputCtrlKeys.includes(ctrlKey)) return // don't process env.args when load() specific keys
+            const ctrl = this.controls[ctrlKey]
+            if (ctrl.type == 'legacy') { log.argDoesNothing(arg) ; continue }
+            if (ctrl.mode) // set cli.config.mode to mode name
+                cli.config.mode = ctrlKey.replace(/mode$/i, '').toLowerCase()
+            else { // init flag/param/cmd cli.config[ctrlKey] val
+                if (ctrl.type == 'param')
+                    cli.config[ctrlKey] =
+                        arg.includes('=') ? arg.split('=')[1]?.trim() || '' // =val
+                      : (i +1 < env.args.length && !env.args[i +1].startsWith('-')) ? env.args[++i] // dashless val
+                      : '' // val-less --param passed
+                else // flag/cmd
+                    cli.config[ctrlKey] = true
+            }
+        }
+
+        if (!arguments.length) log.debug('Args parsed!')
+
+        this.parseValidateConfig(inputCtrlKeys)
+        if (!arguments.length) log.debug('All cli.config vals parsed/validated!')
+
+        return inputCtrlKeys.length == 1 ? cli.config[inputCtrlKeys[0]] : cli.config
+    },
+
+    parseValidateConfig(ctrlKeys = Object.keys(this.controls)) {
+        const language = require('./language')
+        for (const key of [].concat(ctrlKeys)) {
+            const ctrl = this.controls[key], configVal = cli.config[key]
+
+            if (ctrl.parser && !ctrl.parsed) {
+                cli.config[key] = ctrl.parser(configVal) ; ctrl.parsed = true }
+
+            if (ctrl.valType) ({
+                positiveInt() {
+                    const numVal = parseInt(configVal, 10)
+                    if (isNaN(numVal) || numVal < 1)
+                        log.errorAndExit(`[${key}] ${cli.msgs.error_nonPositiveNum}: ${configVal}`)
+                    cli.config[key] = numVal
+                },
+                filepath() {
+                    if (configVal && !fs.existsSync(configVal))
+                        log.errorAndExit(`[${key}] ${cli.msgs.error_invalidFilepath}: ${configVal}`)
+                },
+                langCode() {
+                    if (configVal && !language.validateLangCode(configVal))
+                        log.errorAndExit(`[${key}] ${cli.msgs.error_invalidLangCode}: ${configVal}`)
+                }
+            })[ctrl.valType]()
+        }
+    }
+}

package/dist/cli/lib/string.js

@@ -0,0 +1,3 @@
+module.exports = {
+    toTitleCase(str) { return str.toLowerCase().replace(/\b\w/g, char => char.toUpperCase()) }
+}

package/dist/data/messages.json

@@ -1,6 +1,5 @@
 {
-  "appName": { "message": "scss-to-css" },
-  "appCopyright": { "message": "© 2024–2026 Adam Lui & contributors under the MIT license" },
+  "pkg_copyright": { "message": "© 2024–2026 Adam Lui & contributors under the MIT license" },
   "prefix_globalVer": { "message": "Global version" },
   "prefix_localVer": { "message": "Local version" },
   "prefix_source": { "message": "Source" },
@@ -11,6 +10,8 @@
   "error_invalidLangCode": { "message": "is an invalid language code" },
   "error_invalidURL": { "message": "Invalid URL" },
   "error_invalidConfigFile": { "message": "Config file must export an object" },
+  "error_invalidKey": { "message": "Invalid key" },
+  "error_foundIn": { "message": "found in" },
   "error_configFileNotFound": { "message": "Config file not found" },
   "error_failedToLoadConfigFile": { "message": "Failed to load config file" },
   "error_failedToFetchGlobalVer": { "message": "Failed to fetch global version" },
@@ -19,9 +20,15 @@
   "error_firstArgNotExist": { "message": "First argument can only be an existing file or directory" },
   "error_doesNotExist": { "message": "does not exist" },
   "warn_configFileExists": { "message": "Config file already exists" },
+  "warn_docLocalesFetchFailed": { "message": "Failed to fetch doc locales" },
   "warn_remoteConfigNotFound": { "message": "Remote config file not found" },
   "warn_remoteConfigFailed": { "message": "Failed to fetch remote config file" },
-  "warn_docLocalesFetchFailed": { "message": "Failed to fetch doc locales" },
+  "warn_option": { "message": "Option" },
+  "warn_noLongerHasAnyEffect": { "message": "no longer has any effect" },
+  "warn_hasBeenReplacedBy": { "message": "has been replaced by" },
+  "warn_andWillBeRemoved": { "message": "and will be removed" },
+  "warn_notFound": { "message": "Not found" },
+  "info_configFile": { "message": "Config file" },
   "info_exampleValidConfigFile": { "message": "Example valid config file" },
   "info_exampleValidCmd": { "message": "Example valid command" },
   "info_scssFilesToBeCompiled": { "message": "SCSS files to be compiled" },
@@ -38,6 +45,7 @@
   "info_type": { "message": "type" },
   "info_or": { "message": "or" },
   "info_visit": { "message": "visit" },
+  "info_toCreateDefaultConfig": { "message": "to create default config file" },
   "info_configFileCreated": { "message": "Config file created" },
   "info_fetchingRemoteConfigFrom": { "message": "Fetching remote config file from" },
   "tip_editToSetDefaults": { "message": "Edit this file to customize defaults" },
@@ -66,5 +74,7 @@
   "optionDesc_config": { "message": "Load custom config file" },
   "optionDesc_init": { "message": "Create config file (in project root)" },
   "optionDesc_help": { "message": "Display help screen" },
-  "optionDesc_version": { "message": "Show version number" }
+  "optionDesc_version": { "message": "Show version number" },
+  "optionDesc_stats": { "message": "Show npm stats" },
+  "optionDesc_debug": { "message": "Show debug logs" }
 }

package/dist/data/package-data.json

@@ -13,6 +13,6 @@
     "src": "https://github.com/adamlui/scss-to-css/tree/main/src"
   },
   "commitHashes": {
-    "locales": "83a673c"
+    "locales": "0da06d6"
   }
 }

package/dist/scss-to-css.js

@@ -0,0 +1,235 @@
+// © 2024–2026 Adam Lui & contributors under the MIT license.
+// Source: https://github.com/adamlui/scss-to-css/tree/main/src
+// Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
+
+const fs = require('fs'),
+      path = require('path'),
+      sass = require('sass')
+
+Object.assign(globalThis.api ??= {},
+    require(`${ /[\\/]src(?:[\\/]|$)/i.test(__dirname) ? '../' : './data/' }package-data.json`))
+api.regex = {
+    compile: /^(?:build|comp(?:ile|ress)|minify)$/i,
+    findSCSS: /^(?:find|search)(?:scss)?$/i
+}
+
+function findSCSS(searchDir, options = {}) {
+
+    const docURL = 'https://github.com/adamlui/scss-to-css/tree/main/docs/#findscsssearchdir-options',
+          exampleCall = `findSCSS('assets/scss', { verbose: false, dotFolders: true })`
+
+    const defaultOptions = {
+        recursive: true,   // recursively search for nested files in searchDir passed
+        verbose: true,     // show logging in console/terminal
+        dotFolders: false, // include dotfolders in file search
+        ignores: []        // files/dirs to exclude from search results
+    }
+
+    _log.prefix = 'findSCSS()'
+
+    // Validate searchDir
+    if (typeof searchDir != 'string')
+        _log.errHelpURLandThrow({ errMsg: '1st arg <searchDir> must be a string.', helpURL: docURL })
+    else { // verify searchDir path existence
+        const searchPath = path.resolve(process.cwd(), searchDir)
+        if (!fs.existsSync(searchPath)) {
+            _log.error('1st arg <searchDir> must be an existing directory.')
+            _log.error(`${searchPath} does not exist.`)
+            return _log.helpURL(docURL)
+        }
+    }
+
+    // Validate/init options
+    if (!_validateOptions({ options, defaultOptions, helpURL: docURL, exampleCall })) return
+    options = { ...defaultOptions, ...options } // merge validated options w/ missing default ones
+    if (options.ignoreFiles) options.ignores = [...options.ignores, ...options.ignoreFiles] // for bw compat
+
+    // Search for files
+    const dirFiles = fs.readdirSync(searchDir), scssFiles = []
+    if (options.verbose && !options.isRecursing)
+        _log.info('Searching for files...')
+    dirFiles.forEach(file => {
+        const filePath = path.resolve(searchDir, file)
+        const shouldIgnore = options.ignores?.length && options.ignores.filter(Boolean).some(ignore => {
+            ignore = ignore.replace(/\/$/, '')
+            return file == ignore || filePath.split(path.sep).includes(ignore)
+        })
+        if (shouldIgnore) {
+            if (options.verbose) _log.info(`** ${file} ignored`)
+        } else if (fs.statSync(filePath).isDirectory() && file != 'node_modules' // folder found
+            && options.recursive // only proceed if recursion enabled
+            && (options.dotFolders || !file.startsWith('.')) // exclude dotfolders if prohibited
+        ) scssFiles.push( // recursively find files in eligible dir
+            ...findSCSS(filePath, { ...options, isRecursing: true }))
+        else if (/s[ac]ss$/.test(file)) // .s[ac]ss file found
+            scssFiles.push(filePath) // store for returning
+    })
+
+    // Log/return final results
+    if (options.verbose && !options.isRecursing) {
+        _log.info('Search complete!',
+            `${ scssFiles.length || 'No' } file${ scssFiles.length == 1 ? '' : 's' } found.`)
+        if (findSCSS.caller?.name != 'compile' && typeof window != 'undefined')
+            _log.info('Check returned array.')
+    }
+    return options.isRecursing || scssFiles.length ? scssFiles : []
+}
+
+function compile(input, options = {}) {
+
+    const docURL = 'https://github.com/adamlui/scss-to-css/tree/main/docs/#compileinput-options',
+          exampleCall = `compile('assets/scss', { recursive: false, minify: false })`
+
+    const defaultOptions = {
+        recursive: true,       // recursively search for nested files if dir path passed
+        verbose: true,         // show logging in console/terminal
+        dotFolders: false,     // include dotfolders in file search
+        minify: true,          // minify output CSS
+        sourceMaps: true,      // generate CSS source maps
+        relativeOutput: false, // output files relative to each source file instead of to input root
+        ignores: [],           // files/dirs to exclude from compilation
+        comment: ''            // header comment to prepend to compiled CSS
+    }
+
+    _log.prefix = 'compile()'
+
+    // Validate input
+    if (typeof input != 'string')
+        _log.errHelpURLandThrow({ errMsg: '1st arg <input> must be a string.', helpURL: docURL })
+
+    // Validate/init options
+    if (!_validateOptions({ options, defaultOptions, helpURL: docURL, exampleCall })) return
+    options = { ...defaultOptions, ...options } // merge validated options w/ missing default ones
+    if (options.ignoreFiles) options.ignores = [...options.ignores, ...options.ignoreFiles] // for bw compat
+
+    // Compile SCSS based on input
+    const compileOptions = {
+        style: options.minify ? 'compressed' : 'expanded',
+        sourceMap: options.sourceMaps,
+        charset: false // prevent UTF-8 BOM in output
+    }
+    if (fs.existsSync(input)) { // compile based on path arg
+        if (/s[ac]ss$/.test(input) && fs.statSync(input).isFile()) { // file path passed
+            if (options.verbose) _log.info(`** Compiling ${input}...`)
+            try { // to compile file passed
+                const compileResult = sass.compile(input, compileOptions)
+                if (options.comment)
+                    compileResult.css = _prependComment(compileResult.css, options.comment)
+                if (options.verbose && typeof window != 'undefined')
+                    _log.info('Compilation complete! Check returned object.')
+                return {
+                    code: compileResult.css, srcMap: compileResult.sourceMap,
+                    srcPath: path.resolve(process.cwd(), input), error: undefined
+                }
+            } catch (err) {
+                _log.error(err.message)
+                return { code: undefined, srcMap: undefined, srcPath: undefined, error: err }
+            }
+        } else { // dir path passed
+            const compileResult = findSCSS(input, options)?.map(scssPath => { // compile found SCSS files
+                if (options.verbose) _log.info(`** Compiling ${scssPath}...`)
+                try { // to compile found file
+                    const compileResult = sass.compile(scssPath, compileOptions),
+                          relPath = options.relativeOutput ? undefined
+                                  : path.relative(path.resolve(process.cwd(), input), scssPath)
+                    if (options.comment)
+                        compileResult.css = _prependComment(compileResult.css, options.comment)
+                    return {
+                        code: compileResult.css, srcMap: compileResult.sourceMap, srcPath: scssPath, relPath,
+                        error: undefined
+                    }
+                } catch (err) {
+                    _log.error(err.message)
+                    return { code: undefined, srcMap: undefined, srcPath: undefined, error: err }
+                }
+            }).filter(data => !data.error ) // filter out failed compilations
+            if (options.verbose) {
+                if (compileResult.length && typeof window != 'undefined')
+                    _log.info('Compilation complete! Check returned object.')
+                else
+                    _log.info('No SCSS files processed.')
+            }
+            return compileResult
+        }
+    } else { // compile based on src code arg
+        if (options.verbose)
+            _log.info('** Compiling passed source code...')
+        try { // to compile passed src code
+            const compileResult = sass.compileString(input, compileOptions)
+            if (options.comment)
+                compileResult.css = _prependComment(compileResult.css, options.comment)
+            return { code: compileResult.css, srcMap: compileResult.sourceMap, srcPath: undefined, error: undefined }
+        } catch (err) {
+            _log.error(err.message)
+            return { code: undefined, srcMap: undefined, srcPath: undefined, error: err }
+        }
+    }
+}
+
+function _prependComment(code, comment) {
+    let shebang = '' ; const shebangMatch = code.match(/^#!.*\n/)
+    if (shebangMatch) { // slice shebang from code to memory
+        shebang = shebangMatch[0] ; code = code.slice(shebang.length) }
+    return `${shebang}/**\n${comment.split('\n').map(line => ` * ${line}`).join('\n')}\n */\n${code}`
+}
+
+function _validateOptions({ options, defaultOptions, helpURL, exampleCall }) {
+
+    // Init option strings/types
+    const booleanOptions = Object.keys(defaultOptions).filter(key => typeof defaultOptions[key] == 'boolean'),
+          integerOptions = Object.keys(defaultOptions).filter(key => Number.isInteger(defaultOptions[key]))
+
+    // Validate options
+    if (typeof options != 'object') { // validate as obj
+        let optionsPos = exampleCall.split(',').findIndex(arg => arg.trim().startsWith('{')) +1
+        optionsPos += ['st','nd','rd'][optionsPos -1] || 'th' // append ordinal suffix
+        _log.error(`${ optionsPos == '0th' ? '[O' : optionsPos + ' arg [o' }ptions] can only be an object of key/vals.`)
+        _log.info('Example valid call:', exampleCall)
+        _log.validOptions(defaultOptions) ; _log.helpURL(helpURL)
+        return false
+    }
+    for (const key in options) { // validate each key
+        if (key == 'isRecursing' || !Object.prototype.hasOwnProperty.call(defaultOptions, key))
+            continue // to next key
+        else if (booleanOptions.includes(key) && typeof options[key] != 'boolean') {
+            _log.error(`[${key}] option can only be \`true\` or \`false\`.`)
+            _log.helpURL(helpURL)
+            return false
+        } else if (integerOptions.includes(key)) {
+            options[key] = parseInt(options[key], 10)
+            if (isNaN(options[key]) || options[key] < 1) {
+                _log.error(`[${key}] option can only be an integer > 0.`)
+                _log.helpURL(helpURL)
+                return false
+            }
+        }
+    }
+
+    return true
+}
+
+const _log = {
+    prefix: api.name,
+
+    errHelpURLandThrow({ errMsg, helpURL }) { this.error(errMsg) ; this.helpURL(helpURL) ; throw new Error(errMsg) },
+    error(...args) { console.error(`${this.prefix} » ERROR:`, ...args) },
+    helpURL(url = api.urls?.docs) { this.info('For more help, please visit', url) },
+    info(...args) { console.info(`${this.prefix} »`, ...args) },
+
+    validOptions(options) {
+        const strValidOptions = Object.keys(options).join(', ')
+        const strDefaultOptions = JSON.stringify(options, null, 2)
+            .replace(/"([^"]+)":/g, '$1:') // strip quotes from keys
+            .replace(/"/g, '\'') // replace double quotes w/ single quotes
+            .replace(/\n\s*/g, ' ') // condense to single line
+        this.info(`Valid options: [${strValidOptions}]`)
+        this.info(`If omitted, default settings are: ${strDefaultOptions}`)
+    }
+}
+
+module.exports = new Proxy({ compile, findSCSS }, {
+    get(target, requestedMethod) {
+        for (const [methodName, methodRegex] of Object.entries(api.regex))
+            if (methodRegex.test(requestedMethod)) return target[methodName]
+    }
+})

package/docs/README.md

@@ -33,8 +33,8 @@
     <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-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.2.1">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.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-2.3.1">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.3.1-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/@adamlui/scss-to-css?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/%40adamlui%2Fscss-to-css?style=for-the-badge&logo=ebox&logoColor=white&color=blue&labelColor=464646"></a>
 <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_scss-to-css:src/scss-to-css.js">
@@ -170,6 +170,8 @@ Commands:
  -i, --init                  Create config file (in project root).
  -h, --help                  Display help screen.
  -v, --version               Show version number.
+     --stats                 Show npm stats.
+     --debug [targetKey]     Show debug logs.
 ```
 
 #

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamlui/scss-to-css",
-  "version": "2.2.1",
+  "version": "2.3.1",
   "description": "Recursively compile all SCSS files into minified CSS",
   "author": {
     "name": "Adam Lui",
@@ -34,8 +34,8 @@
     "!docs/*/"
   ],
   "bin": {
-    "scsstocss": "dist/cli/index.min.js",
-    "scss-to-css": "dist/cli/index.min.js"
+    "scsstocss": "dist/cli/index.js",
+    "scss-to-css": "dist/cli/index.js"
   },
   "directories": {
     "lib": "./dist",
@@ -48,6 +48,7 @@
     "lint:fix": "eslint . --fix --cache",
     "lint:fix-all": "eslint . --fix",
     "translate": "translate-messages",
+    "dev": "npm run build && npm i -g && scss-to-css --help",
     "build": "node utils/build",
     "build:js": "node utils/build --js",
     "build:data": "node utils/build --data",
@@ -55,6 +56,7 @@
     "debug": "node src/cli --debug",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
+    "bump:feat": "npm run bump:minor",
     "bump:major": "bash utils/bump.sh major"
   },
   "repository": {
@@ -81,10 +83,11 @@
     "sass": "^1.97.3"
   },
   "devDependencies": {
-    "@adamlui/minify.js": "^2.3.0",
     "@eslint/json": "^1.0.1",
     "@eslint/markdown": "^7.5.1",
     "@stylistic/eslint-plugin": "^5.9.0",
+    "console-table-printer": "^2.15.0",
+    "copyfiles": "^2.4.1",
     "eslint": "^9.39.3",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-regexp": "^3.0.0",

package/dist/cli/index.min.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-(async()=>{globalThis.env={args:process.argv.slice(2),devMode:/[\\/]src(?:[\\/]|$)/i.test(__dirname)},env.debugMode=env.args.some(e=>/^--?debug(?:-?mode)?$/.test(e)),env.modExt=`${env.devMode?"":".min"}.js`;let e=require("./lib/compile"+env.modExt),s=require("../scss-to-css"+env.modExt).findSCSS,i=require("fs"),r=require("./lib/init"+env.modExt),o=require("./lib/log"+env.modExt),c=require("path");if(await r.cli(),cli.config.init)return r.configFile();if(cli.config.help)return o.help();if(cli.config.version)return o.version();var[n="",t=""]=env.args.filter(e=>!e.startsWith("-")).map(e=>e.replace(/^\/*/,""));let l=c.resolve(process.cwd(),n);n&&!i.existsSync(l)&&(d=l+".scss",i.existsSync(d)?l=d:(o.error(`${cli.msgs.error_firstArgNotExist}.\n${l} ${cli.msgs.error_doesNotExist}.`),o.success(cli.msgs.info_exampleValidCmd+`: 
-» scss-to-css . output.min.css`),o.helpCmdAndDocURL(),process.exit(1)));var d=/s[ac]ss$/.test(l)&&!i.statSync(l).isDirectory()?[l]:s(l,{recursive:!cli.config.noRecursion,verbose:!cli.config.quietMode,ignores:cli.config.ignores});env.debugMode||cli.config.dryRun?d.length?(o.info(cli.msgs.info_scssFilesToBeCompiled+":"),d.forEach(e=>o.dim(e))):o.info(`
-${cli.msgs.info_noSCSSfilesWillBeCompiled}.`):e.scss({srcFiles:d,inputPath:l,inputArg:n,outputArg:t})})();

package/dist/cli/lib/compile.min.js

@@ -1,8 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-let log=require("./log"+env.modExt);module.exports={scss({srcFiles:i,inputPath:e,inputArg:r,outputArg:t}){let o=require("../../scss-to-css"+env.modExt).compile,g=require("fs"),f=require("path"),c=[],s=[];var n;!cli.config.relativeOutput&&g.statSync(e).isDirectory()?(n=o(e,{verbose:!1,minify:!cli.config.noMinify,comment:cli.config.comment,relativeOutput:!1,recursive:!cli.config.noRecursion,dotFolders:cli.config.includeDotFolders,sourceMaps:!cli.config.noSourceMaps,ignores:cli.config.ignores}))&&(n.error?c.push(e):s=[].concat(n)):s=i.map(i=>{var e=o(i,{verbose:!cli.config.quietMode,minify:!cli.config.noMinify,sourceMaps:!cli.config.noSourceMaps,comment:cli.config.comment});return e.error&&c.push(i),e}).filter(i=>!i.error),cli.config.quietMode||(n=1==(e=s.length)?"":"s",e?(log.success(cli.msgs.info_compilationComplete+"!"),log.data(`${e} CSS ${cli.msgs.info_file}${n}${cli.config.noSourceMaps?"":` + ${e} `+cli.msgs.info_srcMap+n} ${cli.msgs.info_generated}.`)):console.info(cli.msgs.info_noSCSSfilesProcessed+"."),c.length&&(log.error(c.length+" "+cli.msgs.info_file+(1==c.length?"":"s"),cli.msgs.info_failedToCompile+":"),c.forEach(i=>log.ifNotQuiet(i)))),s?.length&&(cli.config.copy&&1==s?.length?(log.data(s[0].code),log.ifNotQuiet(`
-${cli.msgs.info_copyingToClip}...`),require("node-clipboardy").writeSync(s[0].code)):(log.ifNotQuiet(`
-${cli.msgs.info_writing}${1<s?.length?"s":""}...`),s?.forEach(({code:i,srcMap:e,srcPath:o,relPath:c})=>{let s,n;if(!cli.config.relativeOutput&&c){let i=f.resolve(process.cwd(),t||"css"),e=f.dirname(c);s="."!=e?f.join(i,e):i,n=`${f.basename(o,f.extname(o))}${cli.config.noMinify?"":".min"}.css`}else s=f.join(f.dirname(o),t.endsWith(".css")?f.dirname(t):t||"css"),n=`${t.endsWith(".css")&&/s[ac]ss$/.test(r)?f.basename(t).replace(/(\.min)?\.css$/,""):f.basename(o,f.extname(o))}.min.css`;let l=f.join(s,n);g.mkdirSync(s,{recursive:!0}),g.writeFileSync(l,i,"utf8"),log.ifNotQuiet(`  ${log.colors.bg}✓${log.colors.nc} `+f.relative(process.cwd(),l)),cli.config.noSourceMaps||g.writeFileSync(l+".map",JSON.stringify(e),"utf8"),log.ifNotQuiet(`  ${log.colors.bg}✓${log.colors.nc} ${f.relative(process.cwd(),l)}.map`)})))}};

package/dist/cli/lib/data.min.js

@@ -1,6 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-module.exports={atomicWrite(e,r,t="utf8"){var n=require("fs"),a=require("path"),a=a.join(a.dirname(e),`.${a.basename(e)}.tmp`);n.writeFileSync(a,r,t),n.renameSync(a,e)},fetch(n){return"undefined"==typeof fetch?new Promise((t,e)=>{var r=n.match(/^([^:]+):\/\//)[1];/^https?$/.test(r)||e(new Error(cli.msgs.error_invalidURL+".")),require(r).get(n,e=>{let r="";e.on("data",e=>r+=e),e.on("end",()=>t({json:()=>JSON.parse(r)}))}).on("error",e)}):fetch(n)},flatten(e,{key:r="message"}={}){var t,n={};for(t in e)n[t]="object"==typeof e[t]&&r in e[t]?e[t][r]:e[t];return n}};

package/dist/cli/lib/init.min.js

@@ -1,6 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-let language=require("./language"+env.modExt),log=require("./log"+env.modExt),settings=require("./settings"+env.modExt),dataPath="../../"+(env.devMode?"../":"data/");module.exports={async cli(){Object.assign(globalThis.cli??={},require(dataPath+"package-data.json")),cli.lang=settings.load("uiLang")||(env.debugMode?language.generateRandomLang({excludes:["en"]}):language.getSysLang()),cli.msgs=await language.getMsgs(cli.lang),cli.urls.cliDocs=cli.urls.docs+"/#-command-line-usage",cli.lang.startsWith("en")||(cli.docLocale=cli.lang.replace("_","-").toLowerCase(),cli.docLocales??=await language.getDocLocales(),cli.docLocales?.includes(cli.docLocale)&&log.debug(cli.urls.cliDocs=cli.urls.docs+`/${cli.docLocale}#readme`)),settings.load()},async configFile(e=settings.configFilename){var a=require("fs"),i=require("path"),t={target:i.resolve(process.cwd(),e)};if(a.existsSync(t.target))return log.warn(cli.msgs.warn_configFileExists+":",t.target);if(a.existsSync(t.src=i.resolve(__dirname,""+dataPath+e)))a.copyFileSync(t.src,t.target);else{i=require("./jsdelivr"+env.modExt).pkgVerURL+`/${e}/`;log.data(cli.msgs.info_fetchingRemoteConfigFrom+` ${i}...`);try{var l=require("./data"+env.modExt),s=await l.fetch(i);if(!s.ok)return log.warn(`${cli.msgs.warn_remoteConfigNotFound}: ${i} (${s.status})`);l.atomicWrite(t.target,await s.text())}catch(e){return log.warn(cli.msgs.warn_remoteConfigFailed+`: ${i} `+e.message)}}log.success(`${cli.msgs.info_configFileCreated}: ${t.target}\n`),log.tip(cli.msgs.tip_editToSetDefaults+"."),log.tip(cli.msgs.tip_cliArgsPrioritized+".")}};

package/dist/cli/lib/jsdelivr.min.js

@@ -1,6 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-module.exports={pkgVerURL(e){e||=cli.version||=require("./pkg"+env.modExt).getVer("local")||"none";e=/^\d+\.\d+\.\d+$/.test(e)?"v"+e:"latest";return cli.urls.jsdelivr+"@"+e},commitURL(e="latest"){return cli.urls.jsdelivr+"@"+e}};

package/dist/cli/lib/language.min.js

@@ -1,7 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-let data=require("./data"+env.modExt),log=require("./log"+env.modExt);module.exports={formatCode(e){return e.replace(/([a-z]{2,8})[-_]([a-z]{2})/i,(e,r,a)=>r.toLowerCase()+"_"+a.toUpperCase())},generateRandomLang({includes:e=[],excludes:r=[]}={}){let t=require("fs"),s=require("path"),a=e.length?e:(()=>{var e=s.join(__dirname,"..",".cache"),r=s.join(e,"locales.json");if(t.existsSync(r))try{return JSON.parse(t.readFileSync(r,"utf8"))}catch(e){}var a=s.resolve(process.cwd(),"_locales");return t.existsSync(a)?(a=t.readdirSync(a,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).filter(e=>/^\w{2}[-_]?\w{0,2}$/.test(e)),t.mkdirSync(e,{recursive:!0}),data.atomicWrite(r,JSON.stringify(a,null,2)),a):["en"]})(),n=new Set(r),o="en";return(a=a.filter(e=>!n.has(e))).length&&(o=a[Math.floor(Math.random()*a.length)]),log.debug(`Random language: ${o}
-`),o},async getDocLocales(){cli.version||=require("./pkg"+env.modExt).getVer("local")||"none";var e=require("./jsdelivr"+env.modExt).pkgVerURL()+"/docs/",r=[];try{for(var a,t=await(await data.fetch(e)).text(),s=/href=".*\/docs\/([^/]+)\/"/g;a=s.exec(t);)r.push(a[1])}catch(e){log.warn(cli.msgs.warn_docLocalesFetchFailed+":",e.message)}return r},async getMsgs(t="en"){if(t=module.exports.formatCode(t),env.msgs&&t==cli.lang)return env.msgs;let e=data.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`));if(!t.startsWith("en")){var s=require("./jsdelivr"+env.modExt).commitURL(cli.commitHashes.locales)+"/_locales/";let r=s+t+"/messages.json",a=0;for(;a<3;)try{e=data.flatten(await(await data.fetch(r)).json());break}catch(e){if(3<=++a)break;log.debug(r=t.includes("-")&&1==a?r.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):s+"en/messages.json")}}return e},getSysLang(){try{var e;return"win32"==process.platform?require("child_process").execSync("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim():((e=process.env).LANG||e.LANGUAGE||e.LC_ALL||e.LC_MESSAGES||e.LC_NAME).split(".")[0]}catch(e){return log.error(cli.msgs.error_failedToFetchSysLang+":",e.message),"en"}},validateLangCode(e){return"string"==typeof e&&/^[a-z]{2,8}(?:[-_][a-z]{2,3})?$/i.test(e)}};

package/dist/cli/lib/log.min.js

@@ -1,23 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-module.exports={colors:{nc:"",br:"",by:"",bo:"",bg:"",bw:"",gry:"",blk:"",tlBG:""},configURL(){this.info(`
-${cli.msgs.info_exampleValidConfigFile}: `+cli.urls.config)},configURLandExit(...s){this.error(...s),this.configURL(),process.exit(1)},data(s){console.log(`
-`+this.colors.bw+s+this.colors.nc)},debug(s){env.debugMode&&console.debug(`
-${this.colors.bo}DEBUG:`,s,this.colors.nc,"\n")},dim(s){console.log(""+this.colors.gry+s+this.colors.nc)},error(...s){console.error(`
-${this.colors.br}ERROR:`,...s,this.colors.nc)},errorAndExit(...s){this.error(...s),this.helpCmdAndDocURL(),process.exit(1)},ifNotQuiet(s){cli.config.quietMode||console.info(s)},info(s){console.info(`
-`+this.colors.by+s+this.colors.nc)},tip(s){console.info(this.colors.by+"TIP: "+s+this.colors.nc)},success(s){console.log(`
-`+this.colors.bg+s+this.colors.nc)},warn(...s){console.warn(`
-${this.colors.bo}WARNING:`,...s,this.colors.nc)},help(s=["header","usage","pathArgs","flags","params","cmds"]){cli.prefix=""+this.colors.tlBG+this.colors.blk+` ${cli.name.replace(/^@[^/]+\//,"")} ${this.colors.nc} `;let o={header:[`
-├ ${cli.prefix}${cli.msgs.appCopyright}.`,""+cli.prefix+cli.msgs.prefix_source+": "+cli.urls.src],usage:[`
-${this.colors.bw}o ${cli.msgs.helpSection_usage}:`+this.colors.nc,` ${this.colors.bw}» `+this.colors.bg+cli.cmdFormat+this.colors.nc],pathArgs:[`
-${this.colors.bw}o ${cli.msgs.helpSection_pathArgs}:`+this.colors.nc,` [inputPath]                             ${cli.msgs.inputPathDesc_main}, ${cli.msgs.inputPathDesc_extra}.`,` [outputPath]                            ${cli.msgs.outputPathDesc_main}, `+cli.msgs.outputPathDesc_extra],flags:[`
-${this.colors.bw}o ${cli.msgs.helpSection_flags}:`+this.colors.nc,` -n, --dry-run                           ${cli.msgs.optionDesc_dryRun}.`,` -d, --include-dotfolders                ${cli.msgs.optionDesc_dotfolders}.`,` -S, --no-source-maps                    ${cli.msgs.optionDesc_noSourceMaps}.`,` -M, --no-minify                         ${cli.msgs.optionDesc_noMinify}.`,` -R, --no-recursion                      ${cli.msgs.optionDesc_noRecursion}.`,` -r, --relative-output                   ${cli.msgs.optionDesc_relativeOutput}.`,` -c, --copy                              ${cli.msgs.optionDesc_copy}.`,` -q, --quiet                             ${cli.msgs.optionDesc_quiet}.`],params:[`
-${this.colors.bw}o ${cli.msgs.helpSection_params}:`+this.colors.nc,`--ignores="dir/,file1.scss,file2.sass"   ${cli.msgs.optionDesc_ignores}.`,`--comment="comment"                      ${cli.msgs.optionDesc_commentMain}. ${cli.msgs.optionDesc_commentExtra}.`,` --ui-lang="code"                        ${cli.msgs.optionDesc_uiLang}.`,` --config="path/to/file"                 ${cli.msgs.optionDesc_config}.`],cmds:[`
-${this.colors.bw}o ${cli.msgs.helpSection_cmds}:`+this.colors.nc,` -i, --init                              ${cli.msgs.optionDesc_init}.`,` -h, --help                              ${cli.msgs.optionDesc_help}.`,` -v, --version                           ${cli.msgs.optionDesc_version}.`]};s.forEach(t=>o[t]?.forEach(o=>{{var e=/header|usage/.test(t)?1:41;let i=process.stdout.columns||80,s=o.match(/\S+|\s+/g),c=[],l="";s.forEach(s=>{var o=i-(c.length?e:0);l.length+"| ".length+s.length>o&&(c.push(c.length?l.trimStart():l),l=""),l+=s}),c.push(c.length?l.trimStart():l),c.forEach((s,o)=>console.info("| "+(0==o?s:" ".repeat(e)+s)))}})),console.info(`
-${cli.msgs.info_moreHelp}, ${cli.msgs.info_visit}: `+this.colors.bw+cli.urls.cliDocs+this.colors.nc)},helpCmdAndDocURL(){console.info(`
-${cli.msgs.info_moreHelp}, ${cli.msgs.info_type} ${cli.name.split("/")[1]} --help' ${cli.msgs.info_or} ${cli.msgs.info_visit}
-`+this.colors.bw+cli.urls.docs+this.colors.nc)},version(){var s=require("./pkg"+env.modExt).getVer;this.info(cli.name),this.data(`${cli.msgs.prefix_globalVer}: ${s("global")||"none"}
-${cli.msgs.prefix_localVer}: `+(s("local")||"none"))}};

package/dist/cli/lib/pkg.min.js

@@ -1,6 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/scss-to-css/tree/main/src
- * Documentation: https://github.com/adamlui/scss-to-css/tree/main/docs
- */
-let log=require("./log"+env.modExt);module.exports={getVer(e="any"){let r;if("global"!=e)try{var l=require("path").resolve(process.cwd(),"node_modules",cli.name,"package.json");r=require(l).version}catch(e){log.debug(cli.msgs.error_readingLocalPkgVer+": "+e.message)}if("global"==e||"all"==e&&!r)try{r=require("child_process").execSync(`npm view ${JSON.stringify(cli.name)} version`).toString().trim()}catch(e){log.debug(cli.msgs.error_failedToFetchGlobalVer+": "+e.message)}return r}};