generate-ip 2.8.0 → 2.8.2

package/README.md

@@ -10,12 +10,12 @@
 
 <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-ip-2.8.0">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.8.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.8.2">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.8.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/generate-ip?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/generate-ip?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.8.0/generate-ip/dist/generate-ip.min.js">
-    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.8.0&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.8.2/generate-ip/dist/generate-ip.min.js">
+    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.8.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-ip/src/generate-ip.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-ip%2Fsrc%2Fgenerate-ip.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#networking">
@@ -87,14 +87,14 @@ const { ipv4, ipv6, mac } = require('generate-ip')
 #### <> HTML script tag:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/generate-ip@2.8.0/dist/generate-ip.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/generate-ip@2.8.2/dist/generate-ip.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.8.0/dist/generate-ip.min.js')
+    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.8.2/dist/generate-ip.min.js')
     // Your code here...
 })()
 ```
@@ -103,7 +103,7 @@ const { ipv4, ipv6, mac } = require('generate-ip')
 
 ```js
 ...
-// @require https://cdn.jsdelivr.net/npm/generate-ip@2.8.0/dist/generate-ip.min.js
+// @require https://cdn.jsdelivr.net/npm/generate-ip@2.8.2/dist/generate-ip.min.js
 // ==/UserScript==
 
 // Your code here...
@@ -111,7 +111,7 @@ const { ipv4, ipv6, mac } = require('generate-ip')
 
 <br>
 
-📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.8.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
+📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.8.2` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
 
 <br>
 

package/bin/generate-ip

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--ipv4', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generate-ipv4

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--ipv4', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generate-ipv6

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--ipv6', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), '--ipv6', ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generate-mac

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--mac', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), '--mac', ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generateip

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--ipv4', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generateipv4

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--ipv4', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generateipv6

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--ipv6', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), '--ipv6', ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/bin/generatemac

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-require('child_process').spawnSync('node',
-    [require.resolve('generate-ip/dist/cli/index.min.js'), '--mac', ...process.argv.slice(2)],
+require('child_process').spawnSync(
+    'node', [require('path').join(__dirname, '../dist/cli'), '--mac', ...process.argv.slice(2)],
     { stdio: 'inherit' }
-);
+)

package/dist/cli/.cache/locales.json

@@ -0,0 +1,102 @@
+[
+  "af",
+  "am",
+  "ar",
+  "az",
+  "be",
+  "bg",
+  "bn",
+  "bo",
+  "bs",
+  "ca",
+  "cs",
+  "cy",
+  "da",
+  "de",
+  "dv",
+  "dz",
+  "el",
+  "en",
+  "eo",
+  "es",
+  "et",
+  "eu",
+  "fa",
+  "fi",
+  "fo",
+  "fr",
+  "gd",
+  "gl",
+  "gu",
+  "he",
+  "hi",
+  "hr",
+  "ht",
+  "hu",
+  "hy",
+  "id",
+  "is",
+  "it",
+  "ja",
+  "ka",
+  "kk",
+  "km",
+  "kn",
+  "ko",
+  "ku",
+  "ky",
+  "la",
+  "lb",
+  "lo",
+  "lt",
+  "lv",
+  "mg",
+  "mi",
+  "mk",
+  "ml",
+  "mn",
+  "ms",
+  "mt",
+  "my",
+  "ne",
+  "nl",
+  "no",
+  "ny",
+  "pa",
+  "pl",
+  "ps",
+  "pt",
+  "ro",
+  "ru",
+  "rw",
+  "sg",
+  "si",
+  "sk",
+  "sl",
+  "sm",
+  "sn",
+  "so",
+  "sr",
+  "sv",
+  "sw",
+  "ta",
+  "te",
+  "tg",
+  "th",
+  "ti",
+  "tk",
+  "tn",
+  "tr",
+  "uk",
+  "ur",
+  "uz",
+  "vi",
+  "xh",
+  "yi",
+  "zh",
+  "zh_CN",
+  "zh_HK",
+  "zh_SG",
+  "zh_TW",
+  "zu"
+]

package/dist/cli/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+(async () => {
+    'use strict'
+
+    globalThis.env = {
+        args: process.argv.slice(2),
+        devMode: /[\\/]src(?:[\\/]|$)/i.test(__dirname)
+    }
+    env.debugMode = env.args.some(arg => /^--?debug(?:-?mode)?$/.test(arg))
+
+    // Import LIBS
+    const clipboardy = require('node-clipboardy'),
+          generateIP = require(`../generate-ip${ env.devMode ? '' : '.min' }.js`),
+          init = require('./lib/init'),
+          log = require('./lib/log')
+
+    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()
+
+    // Log/copy random IP(s)
+    const genOptions = {
+        qty: cli.config.qty,
+        sequential: cli.config.sequential,
+        network: cli.config.network,
+        verbose: !cli.config.quietMode
+    }
+    clipboardy.writeSync([].concat(generateIP[cli.config.mode || 'ipv4'].generate(genOptions)).join('\n'))
+    log.ifNotQuiet(`\n${cli.msgs.info_copyingToClip}...`)
+
+})()

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) }))
+            }).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,44 @@
+const language = require('./language'),
+      log = require('./log'),
+      settings = require('./settings')
+
+const 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`
+        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,93 @@
+const data = require('./data'),
+      log = require('./log')
+
+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()}`) },
+
+    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}\n`)
+
+        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.devMode ? '../_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,106 @@
+module.exports = {
+
+    colors: {
+        nc: '\x1b[0m',        // no color
+        br: '\x1b[1;91m',     // bright red
+        by: '\x1b[1;33m',     // bright yellow
+        bo: '\x1b[38;5;214m', // bright orange
+        bg: '\x1b[1;92m',     // bright green
+        bw: '\x1b[1;97m',     // bright white
+        gry: '\x1b[90m',      // gray
+        blk: '\x1b[30m',      // black
+        tlBG: '\x1b[106m'     // teal bg
+    },
+
+    configURL() { this.info(`\n${cli.msgs.info_exampleValidConfigFile}: ${cli.urls.config}`) },
+    configURLandExit(...args) { this.error(...args) ; this.configURL() ; process.exit(1) },
+    data(msg) { console.log(`\n${this.colors.bw}${msg}${this.colors.nc}`) },
+    debug(msg) { if (env.debugMode) console.debug(`\n${this.colors.bo}DEBUG:`, msg, this.colors.nc, '\n') },
+    dim(msg) { console.log(`${this.colors.gry}${msg}${this.colors.nc}`) },
+    error(...args) { console.error(`\n${this.colors.br}ERROR:`, ...args, this.colors.nc) },
+    errorAndExit(...args) { this.error(...args) ; this.helpCmdAndDocURL() ; process.exit(1) },
+    ifNotQuiet(msg) { if (!cli.config.quietMode) console.info(msg) },
+    info(msg) { console.info(`\n${this.colors.by}${msg}${this.colors.nc}`) },
+    tip(msg) { console.info(`${this.colors.by}TIP: ${msg}${this.colors.nc}`) },
+    success(msg) { console.log(`\n${this.colors.bg}${msg}${this.colors.nc}`) },
+    warn(...args) { console.warn(`\n${this.colors.bo}WARNING:`, ...args, this.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.appCopyright}.`,
+                `${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}`,
+                ` --qty=n                     ${cli.msgs.optionDesc_qty}.`,
+                ` --ui-lang="code"            ${cli.msgs.optionDesc_uiLang}.`,
+                ` --config="path/to/file"     ${cli.msgs.optionDesc_config}.`,
+                ` --network="address"         ${cli.msgs.optionDesc_network}.`
+            ],
+            flags: [
+                `\n${this.colors.bw}o ${cli.msgs.helpSection_flags}:${this.colors.nc}`,
+                ` -6, --ipv6                  ${cli.msgs.optionDesc_ipv6}.`,
+                ` -m, --mac                   ${cli.msgs.optionDesc_mac}.`,
+                ` -s, --sequential            ${cli.msgs.optionDesc_sequential}.`,
+                ` -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}.`
+            ]
+        }
+        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
+            )))
+        }
+    },
+
+    helpCmdAndDocURL() {
+        console.info(`\n${
+            cli.msgs.info_moreHelp}, ${cli.msgs.info_type} ${cli.name} --help' ${
+                cli.msgs.info_or} ${cli.msgs.info_visit}\n${
+                    this.colors.bw}${cli.urls.docs}${this.colors.nc}`
+        )
+    },
+
+    version() {
+        const { getVer } = require('./pkg')
+        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,20 @@
+const log = require('./log')
+
+module.exports = {
+    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,119 @@
+const fs = require('fs'),
+      log = require('./log'),
+      path = require('path')
+
+;(globalThis.cli ??= {}).config = {}
+
+module.exports = {
+    configFilename: 'generate-ip.config.mjs',
+
+    controls: {
+        qty: { type: 'param', valType: 'positiveInt', defaultVal: 1, regex: /^--?qu?a?n?ti?t?y(?:=.*|$)/ },
+        network: { type: 'param', regex: /^--network(?:=.*|$)/ },
+        uiLang: { type: 'param', valType: 'langCode', regex: /^--?ui[-_]?lang(?:=.*|$)/ },
+        config: { type: 'param', valType: 'filepath', regex: /^--?config(?:=.*|$)/ },
+        ipv6mode: { type: 'flag', mode: true, regex: /^--?(?:ip)?v?6(?:[-_]?mode)?$/ },
+        macMode: { type: 'flag', mode: true, regex: /^--?m(?:ac)?(?:[-_]?mode)?$/ },
+        quietMode: { type: 'flag', regex: /^--?q(?:uiet)?(?:[-_]?mode)?$/ },
+        sequential: { type: 'flag', regex: /^--(?:s|equen(?:tial|ce))$/ },
+        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(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) return
+                cli.config[key] ??= ctrl.defaultVal ?? ( ctrl.type == 'param' ? '' : false )
+            })
+            cli.defaultsSet = true
+        }
+
+        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}.`)
+                Object.assign(cli.config, arguments.length ?
+                    inputCtrlKeys.reduce((acc, key) => fileConfig[key] ? { ...acc, [key]: fileConfig[key] } : acc, {})
+                        : fileConfig // whole file on arg-less load()
+                )
+            } catch (err) {
+                log.configURLandExit(`${cli.msgs.error_failedToLoadConfigFile}:`, cli.configPath, `\n${err.message}`) }
+
+        env.args.forEach(arg => { // load from CLI arg (overriding config file loads)
+            if (/^[^-]|--?(?:config|debug)/.test(arg) && arg != 'init') return
+            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.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
+                cli.config[ctrlKey] = ctrl.type == 'param' ? arg.split('=')[1]?.trim() ?? '' : true
+        })
+
+        this.parseValidateConfig(inputCtrlKeys)
+
+        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]?.()
+
+            if (cli.config.sequential) {
+                if (!cli.config.network)
+                    log.errorAndExit(
+                        `--network ${cli.msgs.error_isRequired} ${cli.msgs.error_whenPassing} --sequential.`)
+                else if (cli.config.qty <= 1)
+                    log.errorAndExit(
+                        `--qty ${cli.msgs.error_mustBeGreaterThanOne} ${cli.msgs.error_whenPassing} --sequential.`)
+            }
+        }
+    }
+}

package/docs/README.md

@@ -10,12 +10,12 @@
 
 <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-ip-2.8.0">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.8.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.8.2">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.8.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/generate-ip?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/generate-ip?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.8.0/generate-ip/dist/generate-ip.min.js">
-    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.8.0&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.8.2/generate-ip/dist/generate-ip.min.js">
+    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.8.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-ip/src/generate-ip.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-ip%2Fsrc%2Fgenerate-ip.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#networking">
@@ -87,14 +87,14 @@ const { ipv4, ipv6, mac } = require('generate-ip')
 #### <> HTML script tag:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/generate-ip@2.8.0/dist/generate-ip.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/generate-ip@2.8.2/dist/generate-ip.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.8.0/dist/generate-ip.min.js')
+    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.8.2/dist/generate-ip.min.js')
     // Your code here...
 })()
 ```
@@ -103,7 +103,7 @@ const { ipv4, ipv6, mac } = require('generate-ip')
 
 ```js
 ...
-// @require https://cdn.jsdelivr.net/npm/generate-ip@2.8.0/dist/generate-ip.min.js
+// @require https://cdn.jsdelivr.net/npm/generate-ip@2.8.2/dist/generate-ip.min.js
 // ==/UserScript==
 
 // Your code here...
@@ -111,7 +111,7 @@ const { ipv4, ipv6, mac } = require('generate-ip')
 
 <br>
 
-📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.8.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
+📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.8.2` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
 
 <br>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generate-ip",
-  "version": "2.8.0",
+  "version": "2.8.2",
   "description": "Randomly generate, format, and validate IPv4 + IPv6 + MAC addresses.",
   "author": {
     "name": "Adam Lui",
@@ -38,6 +38,7 @@
     "doc": "./docs"
   },
   "scripts": {
+    "dev": "npm run build && npm i -g",
     "build": "node utils/build",
     "build:js": "node utils/build --js",
     "build:data": "node utils/build --data",

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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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-ip"+env.modExt),n=require("./lib/init"+env.modExt),o=require("./lib/log"+env.modExt);return await n.cli(),cli.config.init?n.configFile():cli.config.help?o.help():cli.config.version?o.version():(n={qty:cli.config.qty,sequential:cli.config.sequential,network:cli.config.network,verbose:!cli.config.quietMode},e.writeSync([].concat(i[cli.config.mode||"ipv4"].generate(n)).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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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",settings.load()},async configFile(e=settings.configFilename){var t=require("fs"),a=require("path"),i={target:a.resolve(process.cwd(),e)};if(t.existsSync(i.target))return log.warn(cli.msgs.warn_configFileExists+":",i.target);if(t.existsSync(i.src=a.resolve(__dirname,""+dataPath+e)))t.copyFileSync(i.src,i.target);else{a=require("./jsdelivr"+env.modExt).pkgVerURL+`/${e}/`;log.data(cli.msgs.info_fetchingRemoteConfigFrom+` ${a}...`);try{var s=require("./data"+env.modExt),g=await s.fetch(a);if(!g.ok)return log.warn(`${cli.msgs.warn_remoteConfigNotFound}: ${a} (${g.status})`);s.atomicWrite(i.target,await g.text())}catch(e){return log.warn(cli.msgs.warn_remoteConfigFailed+`: ${a} `+e.message)}}log.success(`${cli.msgs.info_configFileCreated}: ${i.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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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,t)=>r.toLowerCase()+"_"+t.toUpperCase())},generateRandomLang({includes:e=[],excludes:r=[]}={}){let a=require("fs"),s=require("path"),t=e.length?e:(()=>{var e=s.join(__dirname,"..",".cache"),r=s.join(e,"locales.json");if(a.existsSync(r))try{return JSON.parse(a.readFileSync(r,"utf8"))}catch(e){}var t=s.resolve(process.cwd(),"_locales");return a.existsSync(t)?(t=a.readdirSync(t,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).filter(e=>/^\w{2}[-_]?\w{0,2}$/.test(e)),a.mkdirSync(e,{recursive:!0}),data.atomicWrite(r,JSON.stringify(t,null,2)),t):["en"]})(),n=new Set(r),l="en";return(t=t.filter(e=>!n.has(e))).length&&(l=t[Math.floor(Math.random()*t.length)]),log.debug(`Random language: ${l}
-`),l},async getMsgs(a="en"){if(a=module.exports.formatCode(a),env.msgs&&a==cli.lang)return env.msgs;let e=data.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`));if(!a.startsWith("en")){var s=require("./jsdelivr"+env.modExt).commitURL(cli.commitHashes.locales)+"/_locales/";let r=s+a+"/messages.json",t=0;for(;t<3;)try{e=data.flatten(await(await data.fetch(r)).json());break}catch(e){if(3<=++t)break;log.debug(r=a.includes("-")&&1==t?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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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,` --qty=n                     ${cli.msgs.optionDesc_qty}.`,` --ui-lang="code"            ${cli.msgs.optionDesc_uiLang}.`,` --config="path/to/file"     ${cli.msgs.optionDesc_config}.`,` --network="address"         ${cli.msgs.optionDesc_network}.`],flags:[`
-${this.colors.bw}o ${cli.msgs.helpSection_flags}:`+this.colors.nc,` -6, --ipv6                  ${cli.msgs.optionDesc_ipv6}.`,` -m, --mac                   ${cli.msgs.optionDesc_mac}.`,` -s, --sequential            ${cli.msgs.optionDesc_sequential}.`,` -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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/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-ip/src
- * Documentation: https://github.com/adamlui/js-utils/tree/main/generate-ip/docs
- */
-let fs=require("fs"),log=require("./log"+env.modExt),path=require("path");(globalThis.cli??={}).config={},module.exports={configFilename:"generate-ip.config.mjs",controls:{qty:{type:"param",valType:"positiveInt",defaultVal:1,regex:/^--?qu?a?n?ti?t?y(?:=.*|$)/},network:{type:"param",regex:/^--network(?:=.*|$)/},uiLang:{type:"param",valType:"langCode",regex:/^--?ui[-_]?lang(?:=.*|$)/},config:{type:"param",valType:"filepath",regex:/^--?config(?:=.*|$)/},ipv6mode:{type:"flag",mode:!0,regex:/^--?(?:ip)?v?6(?:[-_]?mode)?$/},macMode:{type:"flag",mode:!0,regex:/^--?m(?:ac)?(?:[-_]?mode)?$/},quietMode:{type:"flag",regex:/^--?q(?:uiet)?(?:[-_]?mode)?$/},sequential:{type:"flag",regex:/^--(?:s|equen(?:tial|ce))$/},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),o=e?.default??e;o&&"object"==typeof o||log.configURLandExit(cli.msgs.error_invalidConfigFile+"."),Object.assign(cli.config,arguments.length?r.reduce((e,i)=>o[i]?{...e,[i]:o[i]}:e,{}):o)}catch(e){log.configURLandExit(cli.msgs.error_failedToLoadConfigFile+":",cli.configPath,`
-`+e.message)}return env.args.forEach(i=>{var e,o;/^[^-]|--?(?: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)&&((o=this.controls[e]).mode?cli.config.mode=e.replace(/mode$/i,"").toLowerCase():cli.config[e]="param"!=o.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 o of[].concat(e)){let e=this.controls[o],i=cli.config[o];e.parser&&!e.parsed&&(cli.config[o]=e.parser(i),e.parsed=!0),e.valType&&{positiveInt(){var e=parseInt(i,10);(isNaN(e)||e<1)&&log.errorAndExit(`[${o}] ${cli.msgs.error_nonPositiveNum}: `+i),cli.config[o]=e},filepath(){i&&!fs.existsSync(i)&&log.errorAndExit(`[${o}] ${cli.msgs.error_invalidFilepath}: `+i)},langCode(){i&&!r.validateLangCode(i)&&log.errorAndExit(`[${o}] ${cli.msgs.error_invalidLangCode}: `+i)}}[e.valType]?.(),cli.config.sequential&&(cli.config.network?cli.config.qty<=1&&log.errorAndExit(`--qty ${cli.msgs.error_mustBeGreaterThanOne} ${cli.msgs.error_whenPassing} --sequential.`):log.errorAndExit(`--network ${cli.msgs.error_isRequired} ${cli.msgs.error_whenPassing} --sequential.`))}}};