generate-pw 2.1.2 → 2.2.0

package/README.md

@@ -25,12 +25,12 @@
     <img height=31 src="https://img.shields.io/npm/dm/generate-pw?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/generate-pw-2.1.2">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.1.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-2.2.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/generate-pw?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/generate-pw?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://github.com/adamlui/js-utils/blob/generate-pw-2.1.2/generate-pw/dist/generate-pw.min.js">
-    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-pw/dist/generate-pw.min.js?branch=generate-pw-2.1.2&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
+<a href="#">
+    <img height=31 src="https://img.shields.io/bundlejs/size/generate-pw%402.1.2?label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
 <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/src/generate-pw.js">
     <img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Agenerate-pw%2Fsrc%2Fgenerate-pw.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#password-managers">
@@ -94,14 +94,14 @@ const pw = require('generate-pw')
 #### <> HTML script tag:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/generate-pw@2.1.2/dist/generate-pw.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/generate-pw@2.2.0/dist/generate-pw.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/generate-pw@2.1.2/dist/generate-pw.min.js')
+    await import('https://cdn.jsdelivr.net/npm/generate-pw@2.2.0/dist/generate-pw.min.js')
     // Your code here...
 })()
 ```
@@ -110,7 +110,7 @@ const pw = require('generate-pw')
 
 ```js
 ...
-// @require https://cdn.jsdelivr.net/npm/generate-pw@2.1.2/dist/generate-pw.min.js
+// @require https://cdn.jsdelivr.net/npm/generate-pw@2.2.0/dist/generate-pw.min.js
 // ==/UserScript==
 
 // Your code here...
@@ -118,7 +118,7 @@ const pw = require('generate-pw')
 
 <br>
 
-**💡 Note:** To always import the latest version (not recommended in production!) remove the `@2.1.2` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
+**💡 Note:** To always import the latest version (not recommended in production!) remove the `@2.2.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
 
 <br>
 
@@ -255,7 +255,7 @@ Name                  | Type    | Description
 `uppercase`           | Boolean | Allow uppercase letters in password(s).                                        | `true`
 `similarChars`        | Boolean | Include similar characters (e.g. o,0,O,i,l,1,\|) in password(s).               | `false`
 `strict`              | Boolean | Require at least one character from each allowed character set in password(s). | `true`
-`entropy`             | Boolean | Calculate/log estimated entropy.                                               | `false`
+`entropy`             | Boolean | Calculate/log estimated entropy.                                               | `true`
 
 ##### _*Only available in [`generatePassword([options])`](#generatepasswordoptions) since [`generatePasswords(qty[, options])`](#generatepasswordsqty-options) takes a `qty` argument_
 
@@ -297,13 +297,15 @@ Boolean options:
  -S, --similar-chars         Include similar characters in password(s).
  -S, --unstrict              Don't require at least one character from
                              each allowed character set in password(s).
- -e, --entropy               Calculate/log estimated entropy.
+ -E, --no-entropy            Don't calculate/log estimated entropy.
  -q, --quiet                 Suppress all logging except errors.
 
 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.
 ```
 
 #
@@ -327,7 +329,7 @@ export default {
     excludeUpperChars: false,   // disallow uppercase letters in password(s)
     similarChars: false,        // include similar chars in password(s)
     unstrict: false,            // don't require 1+ char from each allowed charset in password(s)
-    entropy: false,             // calculate/log estimated entropy
+    noEntropy: false,           // don't calculate/log estimated entropy
     quietMode: false            // suppress all logging except errors
 }
 ```

package/dist/cli/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+(async () => {
+    'use strict'
+
+    globalThis.env = {
+        args: process.argv.slice(2),
+        modes: { dev: /[\\/]src(?:[\\/]|$)/i.test(__dirname) },
+        paths: { lib: './lib' }
+    }
+    env.modes.debug = env.args.some(arg => /^--?(?:V|debug(?:[-_]?mode)?)$/.test(arg))
+
+    // Import LIBS
+    globalThis.log = require(`${env.paths.lib}/log`)
+    const clipboardy = require('node-clipboardy'),
+        { generatePassword } = require(`../generate-pw${ env.modes.dev ? '' : '.min' }.js`),
+          init = require(`${env.paths.lib}/init`)
+
+    await init.cli()
+
+    // Exec CMD arg if passed
+    if (cli.config.init) return init.configFile()
+    else if (cli.config.help) return log.help()
+    else if (cli.config.version) return log.version()
+    else if (cli.config.stats) return log.stats()
+
+    // Copy random PASSWORD(s)
+    const genOptions = {
+        length: cli.config.length,
+        qty: cli.config.qty,
+        strength: cli.config.mode || cli.config.strength,
+        charset: cli.config.charset,
+        exclude: cli.config.excludeChars,
+        numbers: !cli.config.excludeNums,
+        symbols: !cli.config.excludeSymbols,
+        lowercase: !cli.config.excludeLowerChars,
+        uppercase: !cli.config.excludeUpperChars,
+        similarChars: cli.config.similarChars,
+        strict: !cli.config.unstrict,
+        entropy: !cli.config.noEntropy,
+        verbose: !cli.config.quietMode
+    }
+    log.break()
+    clipboardy.writeSync([].concat(generatePassword(genOptions)).join('\n'))
+    log.ifNotQuiet(`${cli.msgs.info_copyingToClip}...`)
+
+})()

package/dist/cli/lib/color.js

@@ -0,0 +1,31 @@
+const color = module.exports = {
+    nc: '\x1b[0m',
+    hex: {
+        br: '#ff0000',  by: '#ffff00',  bo: '#ffa500',   bg: '#00ff00',
+        bw: '#ffffff', gry: '#808080', blk: '#000000', tlBG: '#008080'
+    },
+    schemes: {
+        get default() {
+            return [
+                '#00e5bc', '#18c8ae', '#30ac9f', '#488f91', '#607383',
+                '#775674', '#8f3966', '#a71d57', '#bf0049', '#9a1b5e'
+            ].map(color.hexToANSI)
+        },
+        get rainbow() {
+            return [
+                '#e41a1c', '#ff7f00', '#ffff33', '#4daf4a', '#377eb8',
+                '#984ea3', '#f781bf', '#999999', '#a65628', '#d95f02'
+            ].map(color.hexToANSI)
+        }
+    },
+
+    hexToANSI(hex) {
+        const r = parseInt(hex.slice(1,3), 16),
+              g = parseInt(hex.slice(3,5), 16),
+              b = parseInt(hex.slice(5,7), 16)
+        return `\x1b[38;2;${r};${g};${b}m`
+    }
+}
+
+for (const hexKey of Object.keys(color.hex)) // add color[hexKey] getters that return ANSI
+    Object.defineProperty(color, hexKey, { get: () => color.hexToANSI(color.hex[hexKey]) })

package/dist/cli/lib/data.js

@@ -0,0 +1,30 @@
+module.exports = {
+
+    atomicWrite(filePath, data, encoding = 'utf8') { // to prevent TOCTOU
+        const fs = require('fs'),
+              path = require('path'),
+              tmpPath = path.join(path.dirname(filePath), `.${path.basename(filePath)}.tmp`)
+        fs.writeFileSync(tmpPath, data, encoding) ; fs.renameSync(tmpPath, filePath)
+    },
+
+    fetch(url) { // to support Node.js < v21
+        return typeof fetch == 'undefined' ? new Promise((resolve, reject) => { // using https?.get()
+            const protocol = url.match(/^([^:]+):\/\//)[1]
+            if (!/^https?$/.test(protocol))
+                reject(new Error(`${cli.msgs.error_invalidURL}.`))
+            require(protocol).get(url, resp => {
+                let rawData = ''
+                resp.on('data', chunk => rawData += chunk)
+                resp.on('end', () => resolve({ json: () => JSON.parse(rawData), text: () => rawData }))
+            }).on('error', reject)
+        }) : fetch(url) // using Node.js fetch()
+    },
+
+    flatten(json, { key = 'message' } = {}) { // eliminate need to ref nested keys
+        const flatObj = {}
+        for (const jsonKey in json) flatObj[jsonKey] =
+            typeof json[jsonKey] == 'object' && key in json[jsonKey] ? json[jsonKey][key]
+                                                                     : json[jsonKey]
+        return flatObj
+    }
+}

package/dist/cli/lib/init.js

@@ -0,0 +1,49 @@
+const language = require('./language'),
+      settings = require('./settings')
+
+const dataPath = `../../${ env.modes.dev ? '../' : 'data/' }`
+
+module.exports = {
+
+    async cli() {
+        Object.assign(globalThis.cli ??= {}, require(`${dataPath}package-data.json`))
+        cli.msgs = await language.getMsgs('en')
+        cli.msgs = await language.getMsgs(cli.lang = settings.load('uiLang') || (
+            env.modes.debug ? language.generateRandomLang({ excludes: ['en'] }) : language.getSysLang() ))
+        cli.urls.cliDocs = `${cli.urls.docs}/#-command-line-usage`
+        if (!cli.lang.startsWith('en')) { // localize cli.urls.cliDocs
+            cli.docLocale = cli.lang.replace('_', '-').toLowerCase()
+            cli.docLocales ??= await language.getDocLocales()
+            if (cli.docLocales?.includes(cli.docLocale))
+                log.debug(cli.urls.cliDocs = `${cli.urls.docs}/${cli.docLocale}#readme`)
+        }
+        settings.load() // all keys to cli.config
+    },
+
+    async configFile(filename = settings.configFilename) {
+        const fs = require('fs'),
+              path = require('path'),
+              paths = { target: path.resolve(process.cwd(), filename) }
+
+        if (fs.existsSync(paths.target)) // use existing config file
+            return log.warn(`${cli.msgs.warn_configFileExists}:`, paths.target)
+        if (fs.existsSync(paths.src = path.resolve(__dirname, `${dataPath}${filename}`)))
+            fs.copyFileSync(paths.src, paths.target) // use found template
+
+        else { // use jsDelivr copy
+            const jsdURL = `${require('./jsdelivr').pkgVerURL()}/${filename}`
+            log.data(`${cli.msgs.info_fetchingRemoteConfigFrom} ${jsdURL}...`)
+            try {
+                const data = require('./data'),
+                      resp = await data.fetch(jsdURL)
+                if (resp.ok) data.atomicWrite(paths.target, await resp.text())
+                else return log.warn(`${cli.msgs.warn_remoteConfigNotFound}: ${jsdURL} (${resp.status})`)
+            } catch (err) {
+                return log.warn(`${cli.msgs.warn_remoteConfigFailed}: ${jsdURL} ${err.message}`) }
+        }
+
+        log.success(`${cli.msgs.info_configFileCreated}: ${paths.target}\n`)
+        log.tip(`${cli.msgs.tip_editToSetDefaults}.`)
+        log.tip(`${cli.msgs.tip_cliArgsPrioritized}.`)
+    }
+}

package/dist/cli/lib/jsdelivr.js

@@ -0,0 +1,10 @@
+module.exports = {
+
+    pkgVerURL(version) {
+        version ||= cli.version ||= require('./pkg').getVer('local') || 'none'
+        const verTag = !/^\d+\.\d+\.\d+$/.test(version) ? 'latest' : `${cli.name}-${version}`
+        return `${cli.urls.jsdelivr}@${verTag}/${cli.name}`
+    },
+
+    commitURL(hash = 'latest') { return `${cli.urls.jsdelivr}@${hash}/${cli.name}` }
+}

package/dist/cli/lib/language.js

@@ -0,0 +1,106 @@
+const data = require('./data')
+
+module.exports = {
+
+    formatCode(langCode) { // to match locale dir name
+        return langCode.replace(
+            /([a-z]{2,8})[-_]([a-z]{2})/i, (_, lang, region) =>`${lang.toLowerCase()}_${region.toUpperCase()}`) },
+
+    async getDocLocales() {
+        cli.version ||= require('./pkg').getVer('local') || 'none'
+        const jsdURL = `${require('./jsdelivr').pkgVerURL()}/docs/`,
+              locales = []
+        try {
+            const respText = await (await data.fetch(jsdURL)).text(),
+                  reLocale = /href=".*\/docs\/([^/]+)\/"/g
+            let match ; while ((match = reLocale.exec(respText))) locales.push(match[1]) // store locale dir names
+        } catch (err) {
+            log.warn(`${cli.msgs.warn_docLocalesFetchFailed}:`, err.message)
+        }
+        return locales
+    },
+
+    generateRandomLang({ includes = [], excludes = [] } = {}) {
+        const fs = require('fs'),
+              path = require('path')
+
+        let locales = includes.length ? includes : (() => {
+
+            // Read cache if found
+            const cacheDir = path.join(__dirname, '..', '.cache'),
+                  localeCache = path.join(cacheDir, 'locales.json')
+            if (fs.existsSync(localeCache))
+                try { return JSON.parse(fs.readFileSync(localeCache, 'utf8')) } catch (err) {}
+
+            // Discover pkg _locales
+            const localesDir = path.resolve(process.cwd(), '_locales')
+            if (!fs.existsSync(localesDir)) return ['en']
+            const locales = fs.readdirSync(localesDir, { withFileTypes: true })
+                .filter(entry => entry.isDirectory()).map(entry => entry.name)
+                .filter(name => /^\w{2}[-_]?\w{0,2}$/.test(name))
+
+            // Cache result
+            fs.mkdirSync(cacheDir, { recursive: true })
+            data.atomicWrite(localeCache, JSON.stringify(locales, null, 2))
+
+            return locales
+        })()
+
+        // Filter out excludes
+        const excludeSet = new Set(excludes)
+        locales = locales.filter(locale => !excludeSet.has(locale))
+
+        // Get random language
+        let randomLang = 'en'
+        if (locales.length)
+            randomLang = locales[Math.floor(Math.random() * locales.length)]
+        log.debug(`Random language: ${randomLang}`)
+
+        return randomLang
+    },
+
+    async getMsgs(langCode = 'en') {
+        langCode = module.exports.formatCode(langCode)
+        if (env.msgs && langCode == cli.lang) return env.msgs // don't re-fetch same msgs
+
+        let msgs = data.flatten( // local ones
+            require(`../../${ env.modes.dev ? '../_locales/en/' : 'data/' }messages.json`))
+
+        if (!langCode.startsWith('en')) { // fetch non-English msgs from jsDelivr
+            const msgHostURL = `${require('./jsdelivr').commitURL(cli.commitHashes.locales)}/_locales/`
+            let msgHref = `${msgHostURL}${langCode}/messages.json`, msgFetchesTried = 0
+            while (msgFetchesTried < 3)
+                try { // fetch remote msgs
+                    msgs = data.flatten(await (await data.fetch(msgHref)).json())
+                    break
+                } catch (err) { // retry up to 2X (region-stripped + EN)
+                    msgFetchesTried++ ; if (msgFetchesTried >= 3) break
+                    log.debug(msgHref = langCode.includes('-') && msgFetchesTried == 1 ?
+                        msgHref.replace(/([^_]*)_[^/]*(\/.*)/, '$1$2') // strip region before retrying
+                            : `${msgHostURL}en/messages.json` // else use EN msgs
+                    )
+                }
+        }
+
+        return msgs
+    },
+
+    getSysLang() {
+        try {
+            if (process.platform == 'win32')
+                return require('child_process').execSync(
+                    '(Get-Culture).TwoLetterISOLanguageName', { shell: 'powershell', encoding: 'utf-8' }
+                ).trim()
+            else { // macOS/Linux
+                const pe = process.env
+                return (pe.LANG || pe.LANGUAGE || pe.LC_ALL || pe.LC_MESSAGES || pe.LC_NAME)
+                    .split('.')[0] // strip encoding e.g. .UTF-8
+            }
+        } catch (err) {
+            log.error(`${cli.msgs.error_failedToFetchSysLang}:`, err.message)
+            return 'en'
+        }
+    },
+
+    validateLangCode(code) { return typeof code != 'string' ? false : /^[a-z]{2,8}(?:[-_][a-z]{2,3})?$/i.test(code) }
+}

package/dist/cli/lib/log.js

@@ -0,0 +1,171 @@
+const colors = require('./color'),
+    { getDownloads, getVer } = require('./pkg'),
+      string = require('./string')
+
+const nextMajVer = require('../../../package.json').version.replace(/^(\d+)\..*/, (_, major) => `${ +major +1 }.0.0`)
+
+module.exports = {
+    colors,
+
+    configURL() { this.info(`${cli.msgs.info_exampleValidConfigFile}: ${cli.urls.config}`) },
+    configURLandExit(...args) { this.error(...args); this.configURL(); process.exit(1) },
+    data(msg) { console.log(`\n${colors.bw}${msg}${colors.nc}`) },
+    dim(msg) { console.log(`${colors.gry}${msg}${colors.nc}`) },
+    error(...args) { console.error(`\n${colors.br}ERROR:`, ...args, colors.nc) },
+    errorAndExit(...args) { this.error(...args); this.helpDocsCmdsDocsURL(); process.exit(1) },
+    ifNotQuiet(msg) { if (!cli.config.quietMode) this.info(msg) },
+    info(msg) { console.info(`\n${colors.schemes.default[0]}${msg}${colors.nc}`) },
+    break() { console.log() },
+    tip(msg) { console.info(`${colors.by}TIP: ${msg}${colors.nc}`) },
+    success(msg) { console.log(`\n${colors.bg}${msg}${colors.nc}`) },
+    warn(...args) { console.warn(`\n${colors.bo}WARNING:`, ...args, colors.nc) },
+
+    argDoesNothing(arg) {
+        this.warn(`${cli.msgs.warn_option} ${arg} ${cli.msgs.warn_noLongerHasAnyEffect} ${
+                     cli.msgs.warn_andWillBeRemoved} @ v${nextMajVer}`)
+    },
+
+    configKeyReplacedBy(oldKey, newKey, oldVal) {
+        if (!this[`${oldKey}Warned`]) {
+            this.warn(
+                `${cli.msgs.info_configFile} ${cli.msgs.warn_option.toLowerCase()} '${oldKey}: ${oldVal}' ${
+                   cli.msgs.warn_hasBeenReplacedBy} '${
+                       newKey}: ${ isNegKey(oldKey) != isNegKey(newKey) ? !oldVal : oldVal }' ${
+                   cli.msgs.warn_andWillBeRemoved} @ v${nextMajVer}`
+            )
+            this[`${oldKey}Warned`] = true
+            function isNegKey(key) { return /^(?:no|disable|exclude)[A-Z]/.test(key) }
+        }
+    },
+
+    debug(msg) {
+        if (!env.modes.debug) return
+        this.argIdx ??= env.args.findIndex(arg => /^--?(?:V|debug(?:[-_]?mode)?)$/.test(arg))
+        if (this.argIdx +1 < env.args.length && !env.args[this.argIdx +1].startsWith('-')) // use --debug [targetKey]
+            this.key ??= env.args[this.argIdx +1].replace('-', '_')
+        if (this.key)
+            this.val = cli.config[this.key] || `cli.config key "${this.key}" ${cli.msgs.warn_notFound.toLowerCase()}`
+        else
+            this.val = cli.config
+        msg += `\n${colors.gry}${JSON.stringify(this.val)}${colors.nc}`
+        console.debug(`\n${colors.by}DEBUG:`, msg, colors.nc)
+    },
+
+    help(includeSections = ['header', 'usage', 'params', 'flags', 'cmds']) {
+        cli.prefix = `${this.colors.tlBG}${this.colors.blk}\x1b[30m ${cli.name} ${this.colors.nc} `
+        const helpSections = {
+            header: [
+                `\n├ ${cli.prefix}${cli.msgs.pkg_copyright}.`,
+                `${cli.prefix}${cli.msgs.prefix_source}: ${cli.urls.src}`
+            ],
+            usage: [
+                `\n${this.colors.bw}o ${cli.msgs.helpSection_usage}:${this.colors.nc}`,
+                ` ${this.colors.bw}» ${this.colors.bg}${cli.cmdFormat}${this.colors.nc}`
+            ],
+            params: [
+                `\n${this.colors.bw}o ${cli.msgs.helpSection_params}:${this.colors.nc}`,
+                ` --length=n                  ${cli.msgs.optionDesc_length}.`,
+                ` --qty=n                     ${cli.msgs.optionDesc_qty}.`,
+                ` --charset=chars             ${cli.msgs.optionDesc_charset}.`,
+                ` --exclude=chars             ${cli.msgs.optionDesc_exclude}.`,
+                ` --ui-lang="code"            ${cli.msgs.optionDesc_uiLang}.`,
+                ` --config="path/to/file"     ${cli.msgs.optionDesc_config}.`
+            ],
+            flags: [
+                `\n${this.colors.bw}o ${cli.msgs.helpSection_flags}:${this.colors.nc}`,
+                ` -w, --weak                  ${cli.msgs.optionDesc_weak}.`,
+                ` -b, --basic                 ${cli.msgs.optionDesc_basic}.`,
+                ` -t, --strong                ${cli.msgs.optionDesc_strong}.`,
+                ` -N, --no-numbers            ${cli.msgs.optionDesc_excludeNums}.`,
+                ` -Y, --no-symbols            ${cli.msgs.optionDesc_excludeSymbols}.`,
+                ` -L, --no-lowercase          ${cli.msgs.optionDesc_noLower}.`,
+                ` -U, --no-uppercase          ${cli.msgs.optionDesc_noUpper}.`,
+                ` -s, --similar-chars         ${cli.msgs.optionDesc_similarChars}.`,
+                ` -S, --unstrict              ${cli.msgs.optionDesc_unstrict}.`,
+                ` -E, --no-entropy            ${cli.msgs.optionDesc_noEntropy}.`,
+                ` -q, --quiet                 ${cli.msgs.optionDesc_quiet}.`
+            ],
+            cmds: [
+                `\n${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}.`,
+                ` -v, --stats                 ${cli.msgs.optionDesc_stats}.`,
+                ` -V, --debug                 ${cli.msgs.optionDesc_debug}.`
+            ]
+        }
+        includeSections.forEach(section => // print valid arg elems
+            helpSections[section]?.forEach(line => printHelpMsg(line, /header|usage/.test(section) ? 1 : 29)))
+        console.info(`\n${cli.msgs.info_moreHelp}, ${
+            cli.msgs.info_visit}: ${this.colors.bw}${cli.urls.cliDocs}${this.colors.nc}`)
+
+        function printHelpMsg(msg, indent) { // wrap msg + indent 2nd+ lines
+            const terminalWidth = process.stdout.columns || 80,
+                  words = msg.match(/\S+|\s+/g),
+                  lines = [], prefix = '| '
+
+            // Split msg into lines of appropriate lengths
+            let currentLine = ''
+            words.forEach(word => {
+                const lineLength = terminalWidth -( !lines.length ? 0 : indent )
+                if (currentLine.length + prefix.length + word.length > lineLength) { // cap/store it
+                    lines.push(!lines.length ? currentLine : currentLine.trimStart())
+                    currentLine = ''
+                }
+                currentLine += word
+            })
+            lines.push(!lines.length ? currentLine : currentLine.trimStart())
+
+            // Print formatted msg
+            lines.forEach((line, idx) => console.info(prefix +(
+                idx == 0 ? line // print 1st line unindented
+                    : ' '.repeat(indent) + line // print subsequent lines indented
+            )))
+        }
+    },
+
+    helpDocsCmdsDocsURL() {
+        console.info(`\n${
+            cli.msgs.info_moreHelp}, ${cli.msgs.info_type} ${
+                colors.bw}${cli.name} --<docs|help>${colors.nc} ${
+                cli.msgs.info_or} ${cli.msgs.info_visit}\n${colors.by}${cli.urls.docs}${colors.nc}`
+        )
+    },
+
+    initCmd(invalidKey) {
+        if (invalidKey)
+            this.warn(
+                `${cli.msgs.error_invalidKey} '${invalidKey}' ${cli.msgs.error_foundIn}\n`
+                + `${log.colors.gry}${cli.configPath}`
+            )
+        if (!this.initTipped) {
+            this.break()
+            this.tip(`${
+                string.toTitleCase(cli.msgs.info_type)} '${cli.name} init' ${
+                    cli.msgs.info_toCreateDefaultConfig}`
+            )
+            this.initTipped = true
+        }
+    },
+
+    invalidConfigKey(key) { if (!this[`${key}Tipped`]) { this.initCmd(key) ; this[`${key}Tipped`] = true } },
+
+    async stats(pkgName = cli.name, options = { ecosystem: 'npm', maxDays: 8, maxVers: 5, scheme: 'default' }) {
+        const pkgStats = await getDownloads(pkgName, options),
+              schemeData = colors.schemes[options.scheme]
+        if (!schemeData) return this.error(`Scheme '${options.scheme}' not found!`)
+        const colorMap = Object.fromEntries(schemeData.map((hex, idx) => [`c${idx}`, hex])),
+              statsTable = new (require('console-table-printer').Table)({ colorMap })
+        pkgStats.forEach((row, idx) => // build colored rows
+            statsTable.addRow(row, { color: `c${Math.floor(idx / pkgStats.length * schemeData.length)}` }))
+        statsTable.printTable()
+    },
+
+    version() {
+        this.info(cli.name)
+        this.data(`${
+            cli.msgs.prefix_globalVer}: ${ getVer('global') || 'none' }\n${
+            cli.msgs.prefix_localVer }: ${ getVer('local')  || 'none' }`
+        )
+    }
+}

package/dist/cli/lib/pkg.js

@@ -0,0 +1,78 @@
+const data = require('./data')
+
+const endpoints = {
+    npmjsDLs: 'https://api.npmjs.org/downloads',
+    pepyProjects: 'https://pepy.tech/projects'
+}
+
+module.exports = {
+
+    async getDownloads(
+          pkgName, // e.g. some-npm-pkg, npm:@adamlui/minify.js, pypi:translate-messages
+        { ecosystem = 'npm', maxDays = 10, maxVers = 10 } = {}
+    ) {
+        if (pkgName.includes(':')) [ecosystem, pkgName] = pkgName.split(':')
+
+        if (/npm|node/i.test(ecosystem)) { // fetch from endpoints.npmjsDLs
+            function formatDate(date) { return date.toISOString().split('T')[0] }
+            const dates = { end: new Date(), start: new Date() }
+            dates.start.setMonth(dates.end.getMonth() -3)
+            const npmjsURL = `${endpoints.npmjsDLs}/range/${formatDate(dates.start)}:${formatDate(dates.end)}/${pkgName}`
+            log.info(`Fetching npm stats for ${pkgName}${
+                env.modes.debug ? ` from\n${log.colors.bw}${npmjsURL}` : '' }...\n`)
+            return (await (await data.fetch(npmjsURL)).json()).downloads // { downloads: [{ day, downloads }] }
+                .sort((a, b) => new Date(b.day) - new Date(a.day)) // new ⇅ old
+                .slice(0, maxDays) // cap rows
+                .map(({ day: date, downloads }) => ({ date, downloads }))
+
+        } else if (/^py/i.test(ecosystem)) { // fetch from endpoints.pepyProjects
+            let rows = []
+            const pepyURL = `${endpoints.pepyProjects}/${pkgName}`
+            log.info(`Fetching PyPI/mirror stats for ${pkgName}${
+                env.modes.debug ? ` from\n${log.colors.bw}${pepyURL}` : '' }...\n`)
+            const respText = await (await data.fetch(pepyURL)).text(),
+                  rePush = /self\.__next_f\.push\(\[\d+,\s*"((?:\\.|[^"\\])*)"\]\)/g
+            let downloads = {}, match
+            while ((match = rePush.exec(respText))) {
+                try { // extract project.downloads
+                    const inner = JSON.parse(`"${match[1]}"`),
+                          data = JSON.parse(inner.substring(inner.indexOf(':') +1))
+                    if (data[3]?.project) downloads = data[3].project.downloads
+                } catch (err) {}
+            }
+            rows = Object.entries(downloads)
+                .sort(([a], [b]) => new Date(b) - new Date(a)) // new ⇅ old
+                .slice(0, maxDays) // cap rows
+                .map(([date, data]) => ({ date, ...data }))
+            const activeVers = new Set()
+            rows.forEach(row => Object.keys(row).forEach(key => {
+                if (key != 'date' && row[key] > 0) activeVers.add(key) }))
+            const finalVers = [...activeVers]
+                .sort((a, b) => b.localeCompare(a, undefined, { numeric: true })) // new ⇆ old
+                .slice(0, maxVers) // cap columns
+            return rows.map(row => {
+                const result = { date: row.date }
+                finalVers.forEach(ver => result[ver] = row[ver] || 0)
+                return result
+            })
+
+        } else return log.debug(`${ecosystem} not supported.`)
+    },
+
+    getVer(type = 'any') { // or <'global'|'local'>
+        let pkgVer
+        if (type != 'global')
+            try { // get local ver
+                const localManifestPath = require('path').resolve(
+                    process.cwd(), 'node_modules', cli.name, 'package.json')
+                pkgVer = require(localManifestPath).version
+            } catch (err) { log.debug(`${cli.msgs.error_readingLocalPkgVer}: ${err.message}`) }
+        if (type == 'global' || type == 'all' && !pkgVer)
+            try { // get global ver
+                pkgVer = require('child_process').execSync(
+                    `npm view ${JSON.stringify(cli.name)} version`
+                ).toString().trim()
+            } catch (err) { log.debug(`${cli.msgs.error_failedToFetchGlobalVer}: ${err.message}`) }
+        return pkgVer
+    }
+}

package/dist/cli/lib/settings.js

@@ -0,0 +1,153 @@
+const fs = require('fs'),
+      path = require('path')
+
+;(globalThis.cli ??= {}).config = {}
+
+module.exports = {
+    configFilename: 'generate-pw.config.mjs',
+    configFileKeyWhitelist: ['strength'],
+
+    controls: {
+        length: { type: 'param', valType: 'positiveInt', defaultVal: 12, regex: /^--?length(?:[=\s].*|$)/},
+        qty: { type: 'param', valType: 'positiveInt', defaultVal: 1, regex: /^--?qu?a?n?ti?t?y(?:[=\s].*|$)/},
+        charset: { type: 'param', regex: /^--?char[-_]?se?t?(?:[=\s].*|$)/ },
+        excludeChars: { type: 'param', regex:/^--?exclude(?:[=\s].*|$)/ },
+        uiLang: { type: 'param', valType: 'langCode', regex: /^--?ui[-_]?lang(?:[=\s].*|$)/ },
+        config: { type: 'param', valType: 'filepath', regex: /^--?config(?:[=\s].*|$)/ },
+        weak: { type: 'flag', mode: true, regex: /^--?(?:w|weak)$/ },
+        basic: { type: 'flag',  mode: true, regex: /^--?(?:b|basic)$/ },
+        strong: { type: 'flag', mode: true, regex: /^--?(?:t|strong)$/ },
+        excludeNums: { type: 'flag', regex: /^--?(?:N|(?:exclude|disable|no)[-_]?num(?:ber)?s?=?(?:true|1)?)$/ },
+        excludeSymbols: { type: 'flag', regex: /^--?(?:Y|(?:exclude|disable|no)[-_]?symbols?=?(?:true|1)?)$/ },
+        excludeLowerChars: {
+            type: 'flag',
+            regex: /^--?(?:L|(?:exclude|disable|no)[-_]?lower[-_]?(?:case)?|lower[-_]?(?:case)?=(?:false|0))$/
+        },
+        excludeUpperChars: {
+            type: 'flag',
+            regex: /^--?(?:U|(?:exclude|disable|no)[-_]?upper[-_]?(?:case)?|upper[-_]?(?:case)?=(?:false|0))$/
+        },
+        similarChars: { type: 'flag', regex: /^--?(?:s|(?:include[-_]?)?similar[-_]?chars?=?(?:true|1)?)$/ },
+        unstrict: { type: 'flag', regex: /^--?(?:S|(?:un[-_]?strict)?(?:[-_]?mode)?)$/ },
+        noEntropy: { type: 'flag', regex: /^--?(?:E|no[-_]?e(?:ntropy)?)$/ },
+        quietMode: { type: 'flag', regex: /^--?q(?:uiet)?(?:[-_]?mode)?$/ },
+        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?$/ },
+        entropy: { type: 'legacy', replacedBy: 'noEntropy', regex: /^--?e(?:ntropy)?$/ }
+    },
+
+    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/generate-pw.config.mjs

@@ -23,10 +23,10 @@ export default {
     similarChars: false,        // include similar chars (e.g. o,0,O,i,l,1,\|) in password(s)
     unstrict: false,            // don't require 1+ char from each allowed charset in password(s)
     charset: '',                // only include chars in password(s)
-    exclude: '',                // exclude chars from password(s)
+    excludeChars: '',           // exclude chars from password(s)
 
     // Info options
-    entropy: false,             // calculate/log estimated entropy
+    noEntropy: false,           // calculate/log estimated entropy
     quietMode: false,           // suppress all logging except errors
     uiLang: ''                  // ISO 639-1 code of language to display UI in
 }

package/dist/data/messages.json

@@ -1,6 +1,5 @@
 {
-  "appName": { "message": "generate-pw" },
-  "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" },
@@ -20,12 +21,19 @@
   "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_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_copyingToClip": { "message": "Copying to clipboard" },
   "info_moreHelp": { "message": "For more help" },
   "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" },
@@ -49,9 +57,11 @@
   "optionDesc_noUpper": { "message": "Disallow uppercase letters in password(s)" },
   "optionDesc_similarChars": { "message": "Include similar characters in password(s)" },
   "optionDesc_unstrict": { "message": "Don't require at least one character from each allowed character set in password(s)" },
-  "optionDesc_entropy": { "message": "Calculate/log estimated entropy" },
+  "optionDesc_noEntropy": { "message": "Don't calculate/log estimated entropy" },
   "optionDesc_quiet": { "message": "Suppress all logging except errors" },
   "optionDesc_help": { "message": "Display help screen" },
   "optionDesc_init": { "message": "Create config file (in project root)" },
-  "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/js-utils/tree/main/generate-pw/src"
   },
   "commitHashes": {
-    "locales": "69618f8"
+    "locales": "78c0809"
   }
 }

package/dist/generate-pw.min.js

@@ -3,4 +3,4 @@
  * Source: https://github.com/adamlui/js-utils/tree/main/generate-pw/src
  * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/docs
  */
-function generatePassword(s={}){var e={verbose:!0,length:12,qty:1,strength:"",charset:"",exclude:"",numbers:!0,symbols:!0,lowercase:!0,uppercase:!0,similarChars:!1,strict:!0,entropy:!1};if(log.prefix="generatePassword()",validateOptions({options:s,defaultOptions:e,helpURL:"https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#generatepasswordoptions",exampleCall:"generatePassword({ verbose: false, numbers: true })"})){if(1<(s=(s={...e,...s}).strength&&(e=api.strengthPresets[s.strength.toLowerCase()])?{...s,...e}:s).qty){let{qty:e,...r}=s;return generatePasswords(e,r)}{var a,e="generatePasswords"==generatePassword.caller?.name;s.verbose&&!e&&log.info("Initializing character set...");let r=s.charset?.toString()||(s.numbers?api.charsets.numbers:"")+(s.symbols?api.charsets.symbols:"")+(s.lowercase?api.charsets.lower:"")+(s.uppercase?api.charsets.upper:""),t=(""==r&&(r=api.charsets.lower+api.charsets.upper),s.exclude&&(s.verbose&&!e&&log.info("Removing excluded characters..."),r=r.replace(new RegExp(`[${s.exclude}]`,"g"),"")),s.similarChars||(s.verbose&&!e&&log.info("Excluding similar characters..."),r=r.replace(/[o0Oil1|]/g,"")),s.verbose&&!e&&log.info("Generating password..."),"");for(let e=0;e<s.length;e++){var o=randomInt(0,r.length);t+=r[o]}return s.strict&&!s.charset&&(s.verbose&&!e&&log.info("Enforcing strict mode..."),a=["numbers","symbols","lower","upper"].filter(e=>s[e]||s[e+"case"]),t=strictify(t,a)),s.verbose&&(e||(log.info("Password generated!"),"undefined"!=typeof window&&log.info("Check returned string.")),s.entropy)&&(e=(a=r.length)<2?0:Math.log2(a**t.length),log.info(`Estimated entropy: ${e.toFixed(2)} bits (charset length: ${a})`)),t}}}function generatePasswords(r,t={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#generatepasswordsqty-options",s={verbose:!0,length:12,strength:"",charset:"",exclude:"",numbers:!0,symbols:!0,lowercase:!0,uppercase:!0,similarChars:!1,strict:!0,entropy:!1};if(log.prefix="generatePasswords()",r=parseInt(r,10),(isNaN(r)||r<1)&&log.errHelpURLandThrow({errMsg:"1st arg <qty> can only be an integer > 0.",helpURL:e}),validateOptions({options:t,defaultOptions:s,helpURL:e,exampleCall:"generatePasswords(3, { verbose: false, symbols: true })"})){(t=(t={...s,...t}).strength&&(e=api.strengthPresets[t.strength.toLowerCase()])?{...t,...e}:t).verbose&&log.info(`Generating password${1<r?"s":""}...`);var a=[];for(let e=0;e<r;e++)a.push(generatePassword(t));return t.verbose&&(log.info(`Password${1<r?"s":""} generated!`),"undefined"!=typeof window)&&log.info("Check returned array."),a}}function strictify(o,n=["numbers","symbols","lower","upper"],e={}){var r,t="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#strictifypassword-requiredchartypes-options",i={verbose:!0},s=(log.prefix="strictify()","string"!=typeof o&&log.errHelpURLandThrow({errMsg:"1st arg <password> must be a string.",helpURL:t}),["numbers","symbols","lower","upper"]);for(r of n=[].concat(n))if(!s.includes(r))return log.error(`2nd arg \`${r}\` is an invalid character type.`),void log.info([`Valid character types: ['${s.join("', '")}']`,"Pass one as a string or more as an array, or all types will be required.","For more help, please visit "+t].join("\n"));if(o.length<n.length){for(;n.length>o.length;)n.splice(randomInt(0,n.length),1);log.info("Reduced required char types to: "+n.join(", "))}if(validateOptions({options:e,defaultOptions:i,helpURL:t,exampleCall:"strictify('pa55word', ['symbol', 'upper'], { verbose: false })"})){e={...i,...e};let r={},t=[];n.forEach(e=>r[e]=!1);for(let e=0;e<o.length;e++)for(var l of n)!r[l]&&api.charsets[l].includes(o[e])&&(r[l]=!0,t.push(e));e.verbose&&log.info("Strictifying password...");var p,g=Math.min(o.length,n.length);let s=0,a=o;for(p of n)if(s<g&&!r[p]){let e;for(;e=randomInt(0,o.length),t.includes(e););t.push(e);var d=api.charsets[p]||api.charsets[p+"s"];a=a.substring(0,e)+d[randomInt(0,d.length)]+a.substring(e+1),s++}return e.verbose&&(0<s?(log.info("Password is now strict!"),log.info("Check returned string.")):(log.info(`Password already includes ${n.join(" + ")} characters!`),log.info("No modifications made."))),a}}function validateStrength(r,t={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#validatestrengthpassword-options",s={minlength:12,minLower:1,minUpper:1,minNumber:1,minSymbol:1},a={verbose:!0};if(log.prefix="validateStrength()","string"!=typeof r&&log.errHelpURLandThrow({errMsg:"1st arg <password> must be a string.",helpURL:e}),validateOptions({options:t,defaultOptions:a,helpURL:e,exampleCall:"validateStrength('pa55word', { verbose: false })"})){(t={...a,...t}).verbose&&log.info("Validating password strength...");var o,n={lower:0,upper:0,number:0,symbol:0};for(o of r)for(var i of Object.keys(n))(api.charsets[i]||api.charsets[i+"s"]).includes(o)&&n[i]++;var l,p,g=[];r.length<s.minLength&&g.push(`Make it at least ${s.minLength} characters long.`);for(l of Object.keys(n))n[l]<s["min"+l[0].toUpperCase()+l.slice(1)]&&g.push(`Include at least one ${l}${["upper","lower"].includes(l)?"case letter":""}.`);let e=0;e+=r.length>=s.minLength?20:0;for(p of Object.keys(n))e+=n[p]>=s["min"+p[0].toUpperCase()+p.slice(1)]?20:0;return t.verbose&&(log.info("Password strength validated!"),log.info("Check returned object for score/recommendations.")),{strengthScore:e,recommendations:g,isGood:80<=e}}}function randomInt(e,r){var t;return"undefined"==typeof require?(t=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(t*(r-e))+e):require("crypto").randomInt(e,r)}function validateOptions({options:e,defaultOptions:r,helpURL:t,exampleCall:s}){var a=Object.keys(r).filter(e=>"boolean"==typeof r[e]),o=Object.keys(r).filter(e=>Number.isInteger(r[e]));if("object"!=typeof e)return i=s.split(",").findIndex(e=>e.trim().startsWith("{"))+1,i+=["st","nd","rd"][i-1]||"th",log.error(`${"0th"==i?"[O":i+" arg [o"}ptions] can only be an object of key/vals.`),log.info("Example valid call:",s),log.validOptions(r),log.helpURL(t),!1;var n,i=["weak","basic","strong"];if("strength"in e&&e.strength&&!i.includes(e.strength.toLowerCase()))return log.error("[strength] must be one of: "+i.join(", ")),log.helpURL(t),!1;for(n in e){if(!Object.prototype.hasOwnProperty.call(r,n))return log.error(`\`${n}\` is an invalid option.`),log.validOptions(r),log.helpURL(t),!1;if(a.includes(n)&&"boolean"!=typeof e[n])return log.error(`[${n}] option can only be \`true\` or \`false\`.`),log.helpURL(t),!1;if(o.includes(n)&&(e[n]=parseInt(e[n],10),isNaN(e[n])||e[n]<1))return log.error(`[${n}] option can only be an integer > 0.`),log.helpURL(t),!1}return!0}Object.assign(globalThis.api??={},{name:"generate-pw",aliases:{generatePassword:["generate","generatepassword","generatepw","generatePw","generatePW","Generate","Generatepassword","GeneratePassword","Generatepw","GeneratePw","GeneratePW"],generatePasswords:["generatepasswords","generatepws","generatePws","generatePWs","generatePWS","Generatepasswords","GeneratePasswords","Generatepws","GeneratePws","GeneratePWs","GeneratePWS"],strictify:["Strictify"],validateStrength:["validate","Validate","validatestrength","Validatestrength","ValidateStrength"]},charsets:{lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"},strengthPresets:{weak:{length:6,lowercase:!0,uppercase:!1,numbers:!1,symbols:!1,similarChars:!0,strict:!1},basic:{length:8,lowercase:!0,uppercase:!0,numbers:!0,symbols:!1,similarChars:!0,strict:!1},strong:{length:12,lowercase:!0,uppercase:!0,numbers:!0,symbols:!0,similarChars:!1,strict:!0}}});let log={prefix:api.name,errHelpURLandThrow({errMsg:e,helpURL:r}){throw this.error(e),this.helpURL(r),new Error(e)},error(...e){console.error(this.prefix+" » ERROR:",...e)},helpURL(e=api.urls?.docs){this.info("For more help, please visit",e)},info(...e){console.info(this.prefix+" »",...e)},validOptions(e){var r=Object.keys(e).join(", "),e=JSON.stringify(e,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," ");this.info(`Valid options: [${r}]`),this.info("If omitted, default settings are: "+e)}};api.exports={generatePassword:generatePassword,generatePasswords:generatePasswords,strictify:strictify,validateStrength:validateStrength};try{module.exports={...api.exports}}catch(e){}try{window.pw={...api.exports}}catch(e){}for(let r in api.aliases){try{api.aliases[r].forEach(e=>module.exports[e]??=module.exports[r])}catch(e){}try{api.aliases[r].forEach(e=>window.pw[e]??=window.pw[r])}catch(e){}}
+function generatePassword(s={}){var e={verbose:!0,length:12,qty:1,strength:"",charset:"",exclude:"",numbers:!0,symbols:!0,lowercase:!0,uppercase:!0,similarChars:!1,strict:!0,entropy:!0};if(_log.prefix="generatePassword()",_validateOptions({options:s,defaultOptions:e,helpURL:"https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#generatepasswordoptions",exampleCall:"generatePassword({ verbose: false, numbers: true })"})){if(1<(s=(s={...e,...s}).strength&&(e=api.strengthPresets[s.strength.toLowerCase()])?{...s,...e}:s).qty){let{qty:e,...r}=s;return generatePasswords(e,r)}{var o,e="generatePasswords"==generatePassword.caller?.name;s.verbose&&!e&&_log.info("Initializing character set...");let r=s.charset?.toString()||(s.numbers?api.charsets.numbers:"")+(s.symbols?api.charsets.symbols:"")+(s.lowercase?api.charsets.lower:"")+(s.uppercase?api.charsets.upper:""),t=(""==r&&(r=api.charsets.lower+api.charsets.upper),s.exclude&&(s.verbose&&!e&&_log.info("Removing excluded characters..."),r=r.replace(new RegExp(`[${s.exclude}]`,"g"),"")),s.similarChars||(s.verbose&&!e&&_log.info("Excluding similar characters..."),r=r.replace(/[o0Oil1|]/g,"")),s.verbose&&!e&&_log.info("Generating password..."),"");for(let e=0;e<s.length;e++){var a=randomInt(0,r.length);t+=r[a]}return s.strict&&!s.charset&&(s.verbose&&!e&&_log.info("Enforcing strict mode..."),o=["numbers","symbols","lower","upper"].filter(e=>s[e]||s[e+"case"]),t=strictify(t,o)),s.verbose&&(e||(_log.info("Password generated!"),"undefined"!=typeof window&&_log.info("Check returned string.")),s.entropy)&&(e=(o=r.length)<2?0:Math.log2(o**t.length),_log.info(`Estimated entropy: ${e.toFixed(2)} bits (charset length: ${o})`)),t}}}function generatePasswords(r,t={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#generatepasswordsqty-options",s={verbose:!0,length:12,strength:"",charset:"",exclude:"",numbers:!0,symbols:!0,lowercase:!0,uppercase:!0,similarChars:!1,strict:!0,entropy:!0};if(_log.prefix="generatePasswords()",r=parseInt(r,10),(isNaN(r)||r<1)&&_log.errHelpURLandThrow({errMsg:"1st arg <qty> can only be an integer > 0.",helpURL:e}),_validateOptions({options:t,defaultOptions:s,helpURL:e,exampleCall:"generatePasswords(3, { verbose: false, symbols: true })"})){(t=(t={...s,...t}).strength&&(e=api.strengthPresets[t.strength.toLowerCase()])?{...t,...e}:t).verbose&&_log.info(`Generating password${1<r?"s":""}...`);var o=[];for(let e=0;e<r;e++)o.push(generatePassword(t));return t.verbose&&(_log.info(`Password${1<r?"s":""} generated!`),"undefined"!=typeof window)&&_log.info("Check returned array."),o}}function strictify(a,n=["numbers","symbols","lower","upper"],e={}){var r,t="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#strictifypassword-requiredchartypes-options",i={verbose:!0},s=(_log.prefix="strictify()","string"!=typeof a&&_log.errHelpURLandThrow({errMsg:"1st arg <password> must be a string.",helpURL:t}),["numbers","symbols","lower","upper"]);for(r of n=[].concat(n))if(!s.includes(r))return _log.error(`2nd arg \`${r}\` is an invalid character type.`),void _log.info([`Valid character types: ['${s.join("', '")}']`,"Pass one as a string or more as an array, or all types will be required.","For more help, please visit "+t].join("\n"));if(a.length<n.length){for(;n.length>a.length;)n.splice(randomInt(0,n.length),1);_log.info("Reduced required char types to: "+n.join(", "))}if(_validateOptions({options:e,defaultOptions:i,helpURL:t,exampleCall:"strictify('pa55word', ['symbol', 'upper'], { verbose: false })"})){e={...i,...e};let r={},t=[];n.forEach(e=>r[e]=!1);for(let e=0;e<a.length;e++)for(var l of n)!r[l]&&api.charsets[l].includes(a[e])&&(r[l]=!0,t.push(e));e.verbose&&_log.info("Strictifying password...");var p,g=Math.min(a.length,n.length);let s=0,o=a;for(p of n)if(s<g&&!r[p]){let e;for(;e=randomInt(0,a.length),t.includes(e););t.push(e);var c=api.charsets[p]||api.charsets[p+"s"];o=o.substring(0,e)+c[randomInt(0,c.length)]+o.substring(e+1),s++}return e.verbose&&(0<s?(_log.info("Password is now strict!"),_log.info("Check returned string.")):(_log.info(`Password already includes ${n.join(" + ")} characters!`),_log.info("No modifications made."))),o}}function validateStrength(r,t={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/#validatestrengthpassword-options",s={minlength:12,minLower:1,minUpper:1,minNumber:1,minSymbol:1},o={verbose:!0};if(_log.prefix="validateStrength()","string"!=typeof r&&_log.errHelpURLandThrow({errMsg:"1st arg <password> must be a string.",helpURL:e}),_validateOptions({options:t,defaultOptions:o,helpURL:e,exampleCall:"validateStrength('pa55word', { verbose: false })"})){(t={...o,...t}).verbose&&_log.info("Validating password strength...");var a,n={lower:0,upper:0,number:0,symbol:0};for(a of r)for(var i of Object.keys(n))(api.charsets[i]||api.charsets[i+"s"]).includes(a)&&n[i]++;var l,p,g=[];r.length<s.minLength&&g.push(`Make it at least ${s.minLength} characters long.`);for(l of Object.keys(n))n[l]<s["min"+l[0].toUpperCase()+l.slice(1)]&&g.push(`Include at least one ${l}${["upper","lower"].includes(l)?"case letter":""}.`);let e=0;e+=r.length>=s.minLength?20:0;for(p of Object.keys(n))e+=n[p]>=s["min"+p[0].toUpperCase()+p.slice(1)]?20:0;return t.verbose&&(_log.info("Password strength validated!"),_log.info("Check returned object for score/recommendations.")),{strengthScore:e,recommendations:g,isGood:80<=e}}}function randomInt(e,r){var t;return"undefined"==typeof require?(t=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(t*(r-e))+e):require("crypto").randomInt(e,r)}function _validateOptions({options:e,defaultOptions:r,helpURL:t,exampleCall:s}){var o=Object.keys(r).filter(e=>"boolean"==typeof r[e]),a=Object.keys(r).filter(e=>Number.isInteger(r[e]));if("object"!=typeof e)return i=s.split(",").findIndex(e=>e.trim().startsWith("{"))+1,i+=["st","nd","rd"][i-1]||"th",_log.error(`${"0th"==i?"[O":i+" arg [o"}ptions] can only be an object of key/vals.`),_log.info("Example valid call:",s),_log.validOptions(r),_log.helpURL(t),!1;var n,i=["weak","basic","strong"];if("strength"in e&&e.strength&&!i.includes(e.strength.toLowerCase()))return _log.error("[strength] must be one of: "+i.join(", ")),_log.helpURL(t),!1;for(n in e){if(!Object.prototype.hasOwnProperty.call(r,n))return _log.error(`\`${n}\` is an invalid option.`),_log.validOptions(r),_log.helpURL(t),!1;if(o.includes(n)&&"boolean"!=typeof e[n])return _log.error(`[${n}] option can only be \`true\` or \`false\`.`),_log.helpURL(t),!1;if(a.includes(n)&&(e[n]=parseInt(e[n],10),isNaN(e[n])||e[n]<1))return _log.error(`[${n}] option can only be an integer > 0.`),_log.helpURL(t),!1}return!0}Object.assign(globalThis.api??={},{name:"generate-pw",regex:{generatePassword:/^gen(?:erate)?(?:password|pw)?$/i,generatePasswords:/^gen(?:erate)?(?:password|pw)s$/i,strictify:/^strictify$/i,validateStrength:/^validate(?:strength)?$/i},charsets:{lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"},strengthPresets:{weak:{length:6,lowercase:!0,uppercase:!1,numbers:!1,symbols:!1,similarChars:!0,strict:!1},basic:{length:8,lowercase:!0,uppercase:!0,numbers:!0,symbols:!1,similarChars:!0,strict:!1},strong:{length:12,lowercase:!0,uppercase:!0,numbers:!0,symbols:!0,similarChars:!1,strict:!0}}});let _log={prefix:api.name,errHelpURLandThrow({errMsg:e,helpURL:r}){throw this.error(e),this.helpURL(r),new Error(e)},error(...e){console.error(this.prefix+" » ERROR:",...e)},helpURL(e=api.urls?.docs){this.info("For more help, please visit",e)},info(...e){console.info(this.prefix+" »",...e)},validOptions(e){var r=Object.keys(e).join(", "),e=JSON.stringify(e,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," ");this.info(`Valid options: [${r}]`),this.info("If omitted, default settings are: "+e)}};api.exports=new Proxy({generatePassword:generatePassword,generatePasswords:generatePasswords,strictify:strictify,validateStrength:validateStrength},{get(e,r){for(var[t,s]of Object.entries(api.regex))if(s.test(r))return e[t]}});try{module.exports=api.exports}catch(e){}try{Object.assign(window,api.exports)}catch(e){}

package/docs/README.md

@@ -25,12 +25,12 @@
     <img height=31 src="https://img.shields.io/npm/dm/generate-pw?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/generate-pw-2.1.2">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.1.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/generate-pw-2.2.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/generate-pw?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/generate-pw?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://github.com/adamlui/js-utils/blob/generate-pw-2.1.2/generate-pw/dist/generate-pw.min.js">
-    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-pw/dist/generate-pw.min.js?branch=generate-pw-2.1.2&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
+<a href="#">
+    <img height=31 src="https://img.shields.io/bundlejs/size/generate-pw%402.1.2?label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
 <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/src/generate-pw.js">
     <img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Agenerate-pw%2Fsrc%2Fgenerate-pw.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#password-managers">
@@ -94,14 +94,14 @@ const pw = require('generate-pw')
 #### <> HTML script tag:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/generate-pw@2.1.2/dist/generate-pw.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/generate-pw@2.2.0/dist/generate-pw.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/generate-pw@2.1.2/dist/generate-pw.min.js')
+    await import('https://cdn.jsdelivr.net/npm/generate-pw@2.2.0/dist/generate-pw.min.js')
     // Your code here...
 })()
 ```
@@ -110,7 +110,7 @@ const pw = require('generate-pw')
 
 ```js
 ...
-// @require https://cdn.jsdelivr.net/npm/generate-pw@2.1.2/dist/generate-pw.min.js
+// @require https://cdn.jsdelivr.net/npm/generate-pw@2.2.0/dist/generate-pw.min.js
 // ==/UserScript==
 
 // Your code here...
@@ -118,7 +118,7 @@ const pw = require('generate-pw')
 
 <br>
 
-**💡 Note:** To always import the latest version (not recommended in production!) remove the `@2.1.2` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
+**💡 Note:** To always import the latest version (not recommended in production!) remove the `@2.2.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-pw/dist/generate-pw.min.js`
 
 <br>
 
@@ -255,7 +255,7 @@ Name                  | Type    | Description
 `uppercase`           | Boolean | Allow uppercase letters in password(s).                                        | `true`
 `similarChars`        | Boolean | Include similar characters (e.g. o,0,O,i,l,1,\|) in password(s).               | `false`
 `strict`              | Boolean | Require at least one character from each allowed character set in password(s). | `true`
-`entropy`             | Boolean | Calculate/log estimated entropy.                                               | `false`
+`entropy`             | Boolean | Calculate/log estimated entropy.                                               | `true`
 
 ##### _*Only available in [`generatePassword([options])`](#generatepasswordoptions) since [`generatePasswords(qty[, options])`](#generatepasswordsqty-options) takes a `qty` argument_
 
@@ -297,13 +297,15 @@ Boolean options:
  -S, --similar-chars         Include similar characters in password(s).
  -S, --unstrict              Don't require at least one character from
                              each allowed character set in password(s).
- -e, --entropy               Calculate/log estimated entropy.
+ -E, --no-entropy            Don't calculate/log estimated entropy.
  -q, --quiet                 Suppress all logging except errors.
 
 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.
 ```
 
 #
@@ -327,7 +329,7 @@ export default {
     excludeUpperChars: false,   // disallow uppercase letters in password(s)
     similarChars: false,        // include similar chars in password(s)
     unstrict: false,            // don't require 1+ char from each allowed charset in password(s)
-    entropy: false,             // calculate/log estimated entropy
+    noEntropy: false,           // don't calculate/log estimated entropy
     quietMode: false            // suppress all logging except errors
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generate-pw",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Randomly generate, strengthen, and validate cryptographically-secure passwords.",
   "author": {
     "name": "Adam Lui",
@@ -34,14 +34,15 @@
     "!docs/*/"
   ],
   "bin": {
-    "generatepw": "dist/cli/index.min.js",
-    "generate-pw": "dist/cli/index.min.js"
+    "generatepw": "dist/cli/index.js",
+    "generate-pw": "dist/cli/index.js"
   },
   "directories": {
     "lib": "./dist",
     "doc": "./docs"
   },
   "scripts": {
+    "dev": "npm run build && npm i -g && generate-pw --help",
     "build": "node utils/build",
     "build:js": "node utils/build --js",
     "build:data": "node utils/build --data",
@@ -50,6 +51,7 @@
     "translate": "translate-messages",
     "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": {
@@ -75,6 +77,8 @@
     "node-clipboardy": "^1.0.3"
   },
   "devDependencies": {
-    "@adamlui/minify.js": "^2.3.0"
+    "@adamlui/minify.js": "^2.3.1",
+    "console-table-printer": "^2.15.0",
+    "copyfiles": "^2.4.1"
   }
 }

package/dist/cli/index.min.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/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`;var e=require("node-clipboardy"),i=require("../generate-pw"+env.modExt).generatePassword,c=require("./lib/init"+env.modExt),o=require("./lib/log"+env.modExt);return await c.cli(),cli.config.init?c.configFile():cli.config.help?o.help():cli.config.version?o.version():(c={length:cli.config.length,qty:cli.config.qty,strength:cli.config.mode,charset:cli.config.charset,exclude:cli.config.excludeChars,numbers:!cli.config.excludeNums,symbols:!cli.config.excludeSymbols,lowercase:!cli.config.excludeLowerChars,uppercase:!cli.config.excludeUpperChars,similarChars:cli.config.similarChars,strict:!cli.config.unstrict,entropy:cli.config.entropy,verbose:!cli.config.quietMode},e.writeSync([].concat(i(c)).join("\n")),void o.ifNotQuiet(`
-${cli.msgs.info_copyingToClip}...`))})();

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/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/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/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/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/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/docs
- */
-module.exports={pkgVerURL(e){e||=cli.version||=require("./pkg"+env.modExt).getVer("local")||"none";e=/^\d+\.\d+\.\d+$/.test(e)?cli.name+"-"+e:"latest";return cli.urls.jsdelivr+`@${e}/`+cli.name},commitURL(e="latest"){return cli.urls.jsdelivr+`@${e}/`+cli.name}};

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/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/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())},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},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 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,22 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/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","params","flags","cmds"]){cli.prefix=""+this.colors.tlBG+this.colors.blk+` ${cli.name} ${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],params:[`
-${this.colors.bw}o ${cli.msgs.helpSection_params}:`+this.colors.nc,` --length=n                  ${cli.msgs.optionDesc_length}.`,` --qty=n                     ${cli.msgs.optionDesc_qty}.`,` --charset=chars             ${cli.msgs.optionDesc_charset}.`,` --exclude=chars             ${cli.msgs.optionDesc_exclude}.`,` --ui-lang="code"            ${cli.msgs.optionDesc_uiLang}.`,` --config="path/to/file"     ${cli.msgs.optionDesc_config}.`],flags:[`
-${this.colors.bw}o ${cli.msgs.helpSection_flags}:`+this.colors.nc,` -w, --weak                  ${cli.msgs.optionDesc_weak}.`,` -b, --basic                 ${cli.msgs.optionDesc_basic}.`,` -t, --strong                ${cli.msgs.optionDesc_strong}.`,` -N, --no-numbers            ${cli.msgs.optionDesc_excludeNums}.`,` -Y, --no-symbols            ${cli.msgs.optionDesc_excludeSymbols}.`,` -L, --no-lowercase          ${cli.msgs.optionDesc_noLower}.`,` -U, --no-uppercase          ${cli.msgs.optionDesc_noUpper}.`,` -s, --similar-chars         ${cli.msgs.optionDesc_similarChars}.`,` -S, --unstrict              ${cli.msgs.optionDesc_unstrict}.`,` -e, --entropy               ${cli.msgs.optionDesc_entropy}.`,` -q, --quiet                 ${cli.msgs.optionDesc_quiet}.`],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:29;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} --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/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/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}};

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

@@ -1,7 +0,0 @@
-/**
- * © 2024–2026 Adam Lui & contributors under the MIT license.
- * Source: https://github.com/adamlui/js-utils/tree/main/generate-pw/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-pw/docs
- */
-let fs=require("fs"),log=require("./log"+env.modExt),path=require("path");(globalThis.cli??={}).config={},module.exports={configFilename:"generate-pw.config.mjs",controls:{length:{type:"param",valType:"positiveInt",defaultVal:12,regex:/^--?length(?:=.*|$)/},qty:{type:"param",valType:"positiveInt",defaultVal:1,regex:/^--?qu?a?n?ti?t?y(?:=.*|$)/},charset:{type:"param",regex:/^--?charse?t?(?:=.*|$)/},excludeChars:{type:"param",regex:/^--?exclude(?:=.*|$)/},uiLang:{type:"param",valType:"langCode",regex:/^--?ui-?lang(?:=.*|$)/},config:{type:"param",valType:"filepath",regex:/^--?config(?:=.*|$)/},weak:{type:"flag",mode:!0,regex:/^--?(?:w|weak)$/},basic:{type:"flag",mode:!0,regex:/^--?(?:b|basic)$/},strong:{type:"flag",mode:!0,regex:/^--?(?:t|strong)$/},excludeNums:{type:"flag",regex:/^--?(?:N|(?:exclude|disable|no)-?num(?:ber)?s?=?(?:true|1)?)$/},excludeSymbols:{type:"flag",regex:/^--?(?:Y|(?:exclude|disable|no)-?symbols?=?(?:true|1)?)$/},excludeLowerChars:{type:"flag",regex:/^--?(?:L|(?:exclude|disable|no)-?lower-?(?:case)?|lower-?(?:case)?=(?:false|0))$/},excludeUpperChars:{type:"flag",regex:/^--?(?:U|(?:exclude|disable|no)-?upper-?(?:case)?|upper-?(?:case)?=(?:false|0))$/},similarChars:{type:"flag",regex:/^--?(?:s|(?:include-?)?similar-?chars?=?(?:true|1)?)$/},unstrict:{type:"flag",regex:/^--?(?:S|(?:un-?strict)?(?:-?mode)?)$/},entropy:{type:"flag",regex:/^--?e(?:ntropy)?$/},quietMode:{type:"flag",regex:/^--?q(?:uiet)?(?:-?mode)?$/},init:{type:"cmd",regex:/^-{0,2}i(?:nit)?$/},help:{type:"cmd",regex:/^--?h(?:elp)?$/},version:{type:"cmd",regex:/^--?ve?r?s?i?o?n?$/}},load(e=Object.keys(this.controls)){let r=[].concat(e);if(cli.defaultsSet||arguments.length||(r.forEach(e=>{var i=this.controls[e];i.mode||(cli.config[e]??=i.defaultVal??("param"==i.type&&""))}),cli.defaultsSet=!0),!cli.configPathTried){e=env.args.find(e=>this.controls.config.regex.test(e));if(e){/=/.test(e)||log.errorAndExit(`[${e}] `+cli.msgs.error_mustIncludePath);e=e.split("=")[1];cli.configPath=path.isAbsolute(e)?e:path.resolve(process.cwd(),e),fs.existsSync(cli.configPath)||log.configURLandExit(cli.msgs.error_configFileNotFound+":",cli.configPath)}else for(var i of[".mjs",".cjs",".js"]){i=path.resolve(process.cwd(),this.configFilename.replace(/\.[^.]+$/,i));if(fs.existsSync(i)){cli.configPath=i;break}}cli.configPathTried=!0}if(cli.configPath)try{let e=require(cli.configPath),t=e?.default??e;t&&"object"==typeof t||log.configURLandExit(cli.msgs.error_invalidConfigFile+"."),Object.assign(cli.config,arguments.length?r.reduce((e,i)=>t[i]?{...e,[i]:t[i]}:e,{}):t)}catch(e){log.configURLandExit(cli.msgs.error_failedToLoadConfigFile+":",cli.configPath,`
-`+e.message)}return env.args.forEach(i=>{var e,t;/^[^-]|--?(?:config|debug)/.test(i)&&"init"!=i||(!(e=Object.keys(this.controls).find(e=>this.controls[e]?.regex?.test(i)))&&cli.msgs&&log.errorAndExit(`[${i}] ${cli.msgs.error_notRecognized}.`),r.includes(e)&&((t=this.controls[e]).mode?cli.config.mode=e.replace(/mode$/i,"").toLowerCase():cli.config[e]="param"!=t.type||(i.split("=")[1]?.trim()??"")))}),this.parseValidateConfig(r),1==r.length?cli.config[r[0]]:cli.config},parseValidateConfig(e=Object.keys(this.controls)){let r=require("./language"+env.modExt);for(let t of[].concat(e)){let e=this.controls[t],i=cli.config[t];e.parser&&!e.parsed&&(cli.config[t]=e.parser(i),e.parsed=!0),e.valType&&{positiveInt(){var e=parseInt(i,10);(isNaN(e)||e<1)&&log.errorAndExit(`[${t}] ${cli.msgs.error_nonPositiveNum}: `+i),cli.config[t]=e},filepath(){i&&!fs.existsSync(i)&&log.errorAndExit(`[${t}] ${cli.msgs.error_invalidFilepath}: `+i)},langCode(){i&&!r.validateLangCode(i)&&log.errorAndExit(`[${t}] ${cli.msgs.error_invalidLangCode}: `+i)}}[e.valType]()}}};