generate-ip 2.8.1 → 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.1">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.8.1-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.1/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.1&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.1/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.1/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.1/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.1` 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/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/dist/data/generate-ip.config.mjs

@@ -0,0 +1,18 @@
+/**
+ * generate-ip.config.mjs
+ *
+ * Optional config file for the generate-ip CLI.
+ * Copy this file to your project root to set default options.
+ * CLI arguments always override these values.
+ *
+ * Docs: https://github.com/adamlui/js-utils/tree/main/generate-ip/#-command-line-usage
+ */
+
+export default {
+    mode: 'ipv4',      // <ipv4|ipv6|mac> type of address to generate
+    qty: 1,            // # of IPs to generate
+    sequential: false, // generate addresses in sequence
+    network: null,     // starting network address (required for sequential mode)
+    quietMode: false,  // suppress all logging except errors
+    uiLang: ''         // ISO 639-1 code of language to display UI in
+}

package/dist/data/messages.json

@@ -0,0 +1,50 @@
+{
+  "appName": { "message": "generate-ip" },
+  "appCopyright": { "message": "© 2024–2026 Adam Lui & contributors under the MIT license" },
+  "prefix_globalVer": { "message": "Global version" },
+  "prefix_localVer": { "message": "Local version" },
+  "prefix_source": { "message": "Source" },
+  "error_readingLocalPkgVer": { "message": "Error reading local package version" },
+  "error_notRecognized": { "message": "not recognized" },
+  "error_nonPositiveNum": { "message": "argument can only be > 0" },
+  "error_invalidFilepath": { "message": "must be a valid existing file path. Got" },
+  "error_invalidLangCode": { "message": "is an invalid language code" },
+  "error_invalidURL": { "message": "Invalid URL" },
+  "error_invalidConfigFile": { "message": "Config file must export an object" },
+  "error_configFileNotFound": { "message": "Config file not found" },
+  "error_failedToLoadConfigFile": { "message": "Failed to load config file" },
+  "error_failedToFetchGlobalVer": { "message": "Failed to fetch global version" },
+  "error_failedToFetchSysLang": { "message": "Failed to fetch system language" },
+  "error_mustIncludePath": { "message": "must include =path" },
+  "error_isRequired": { "message": "is required" },
+  "error_whenPassing": { "message": "when passing" },
+  "error_mustBeGreaterThanOne": { "message": "must be > 1" },
+  "warn_configFileExists": { "message": "Config file already exists" },
+  "warn_remoteConfigNotFound": { "message": "Remote config file not found" },
+  "warn_remoteConfigFailed": { "message": "Failed to fetch remote 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_configFileCreated": { "message": "Config file created" },
+  "info_fetchingRemoteConfigFrom": { "message": "Fetching remote config file from" },
+  "tip_editToSetDefaults": { "message": "Edit this file to customize defaults" },
+  "tip_cliArgsPrioritized": { "message": "CLI arguments always override these values" },
+  "helpSection_usage": { "message": "Usage" },
+  "helpSection_params": { "message": "Parameter options" },
+  "helpSection_flags": { "message": "Boolean options" },
+  "helpSection_cmds": { "message": "Commands" },
+  "optionDesc_uiLang": { "message": "ISO 639-1 code of language to display UI in" },
+  "optionDesc_qty": { "message": "Generate n IP address(es)" },
+  "optionDesc_config": { "message": "Load custom config file" },
+  "optionDesc_ipv6": { "message": "Generate IPv6 address" },
+  "optionDesc_mac": { "message": "Generate MAC address" },
+  "optionDesc_sequential": { "message": "Generate addresses in sequence" },
+  "optionDesc_network": { "message": "Starting network address (required for sequential mode)" },
+  "optionDesc_quiet": { "message": "Suppress all logging except errors" },
+  "optionDesc_init": { "message": "Create config file (in project root)" },
+  "optionDesc_help": { "message": "Display help screen" },
+  "optionDesc_version": { "message": "Show version number" }
+}

package/dist/data/package-data.json

@@ -0,0 +1,18 @@
+{
+  "name": "generate-ip",
+  "author": "Adam Lui & contributors",
+  "license": "MIT",
+  "copyrightYear": "2024–2026",
+  "cmdFormat": "generate-[ip|ipv6|mac] [options|commands]",
+  "urls": {
+    "config": "https://github.com/adamlui/js-utils/blob/main/generate-ip/generate-ip.config.mjs",
+    "docs": "https://github.com/adamlui/js-utils/tree/main/generate-ip/docs",
+    "github": "https://github.com/adamlui/js-utils",
+    "jsdelivr": "https://cdn.jsdelivr.net/gh/adamlui/js-utils",
+    "npm": "https://www.npmjs.com/package/generate-ip",
+    "src": "https://github.com/adamlui/js-utils/tree/main/generate-ip/src"
+  },
+  "commitHashes": {
+    "locales": "6dc65c4"
+  }
+}

package/dist/generate-ip.min.js

@@ -0,0 +1,6 @@
+/**
+ * © 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
+ */
+Object.assign(globalThis.api??={},{name:"generate-ip",aliases:{ipv4:["ipV4","IPv4","IPV4","Ipv4","IpV4","ip","IP","Ip"],ipv6:["ipV6","IPv6","IPV6","Ipv6","IpV6"],mac:["MAC","Mac","ethernet","Ethernet"]}});let ipv4={generate(t={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv4generateoptions",r={verbose:!0,qty:1,sequential:!1,network:null};if(log.prefix="ipv4.generate()",validateOptions({options:t,defaultOptions:r,helpURL:e,exampleCall:"ipv4.generate({ verbose: false, qty: 3 })"})){(t={...r,...t}).verbose&&log.info(`Generating IPv4 address${1<t.qty?"es":""}...`);var o=[];if(t.sequential){t.network&&this.validate(t.network)?(!t.qty||t.qty<=1)&&log.errHelpURLandThrow({helpURL:e,errMsg:"options.qty must be > 1 when options.sequential is `true`."}):log.errHelpURLandThrow({helpURL:e,errMsg:"options.network must be a valid IP when options.sequential is `true`."});var[i,a,s,l]=t.network.split(".").map(Number);for(let e=0;e<t.qty;e++)o.push(i+`.${a}.${s}.`+(l+e))}else if(1<t.qty)for(let e=0;e<t.qty;e++)o.push(this.generate({...t,qty:1,verbose:!1}));else{var n=[];for(let e=0;e<4;e++)n.push(random.int(0,256));o.push(n.join("."))}r=1<t.qty?o:o[0];return t.verbose&&(log.info(`IPv4 address${1<t.qty?"es":""} generated!`),log.info(1==t.qty?r:r.join(", "))),r}},validate(e,t={}){var r="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv4validateaddress-options",o={verbose:!0};if(log.prefix="ipv4.validate()","string"!=typeof e&&log.errHelpURLandThrow({errMsg:"1st arg <address> must be a string.",helpURL:r}),validateOptions({options:t,defaultOptions:o,helpURL:r,exampleCall:"ipv4.validate('0.0.255.255', { verbose: false })"}))return(t={...o,...t}).verbose&&log.info(`Validating ${e}...`),o=!(4!=(r=e.split(".")).length||r.some(e=>!/^\d+$/.test(e)||parseInt(e,10)<0||255<parseInt(e,10))),t.verbose&&log.info(`IP is ${o?"":"in"}valid IPv4 address!`),o}},ipv6={generate(a={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv6generateoptions",t={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0,sequential:!1,network:null};if(log.prefix="ipv6.generate()",validateOptions({options:a,defaultOptions:t,helpURL:e,exampleCall:"ipv6.generate({ leadingZeros: true, qty: 5 })"})){(a={...t,...a}).verbose&&log.info(`Generating IPv6 address${1<a.qty?"es":""}...`);var s=[];if(a.sequential){a.network&&this.validate(a.network)?(!a.qty||a.qty<=1)&&log.errHelpURLandThrow({helpURL:e,errMsg:"options.qty must be > 1 when options.sequential is `true`."}):log.errHelpURLandThrow({helpURL:e,errMsg:"options.network must be a valid IP when options.sequential is `true`."});var r=a.network.split(":").map(e=>parseInt(e,16)||0);for(let e=0;e<a.qty;e++){var o=r[7];r[7]=o+e,r[7]>o+1&&(r[7]=o+1),s.push(r.map(e=>e.toString(16).padStart(4,"0")).join(":"))}}else if(1<a.qty)for(let e=0;e<a.qty;e++)s.push(this.generate({...a,qty:1,verbose:!1}));else{let t=[],{qty:e,sequential:r,network:o,...i}=a;for(let e=0;e<8;e++)t.push(random.hex(4));s.push(this.format(t.join(":"),{...i,verbose:!1}))}t=1<a.qty?s:s[0];return a.verbose&&(log.info(`IPv6 address${1<a.qty?"es":""} generated!`),log.info(1==a.qty?t:t.join(", "))),t}},format(t,r={}){var o="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv6formatipv6address-options",i={verbose:!0,leadingZeros:!1,doubleColon:!0};if(log.prefix="ipv6.format()","string"!=typeof t&&log.errHelpURLandThrow({errMsg:"1st arg <ipv6address> must be a string.",helpURL:o}),this.validate(t,{verbose:!1})||log.errHelpURLandThrow({errMsg:t+" is not a valid IPv6 address.",helpURL:o}),validateOptions({options:r,defaultOptions:i,helpURL:o,exampleCall:"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })"})){r={...i,...r};let e=t;if(e=r.doubleColon?(r.verbose&&log.info("Replacing zero series w/ '::'..."),e.replace(/:(?:0+:)+/,"::")):(r.verbose&&log.info("Expanding '::' into zero series..."),o=e.split(":").filter(Boolean).length,i=r.leadingZeros?"0000":"0",o=Array(8-o).fill(i).join(":"),e.replace("::",`:${o}:`)),r.leadingZeros){r.verbose&&log.info("Adding leading zeros...");var a=e.split(":");for(let e=0;e<a.length;e++)for(;a[e].length<4;)a[e]="0"+a[e];e=a.join(":")}else r.verbose&&log.info("Stripping leading zeros..."),e=t.replace(/(^|(?<=:))0+(?!:)/g,"$1");return r.verbose&&(e!=t?log.info("IP formatted successfully!"):log.info("IP already formatted to specs."),log.info(e)),e}},validate(r,o={}){var i="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv6validateaddress-options",a={verbose:!0};if(log.prefix="ipv6.validate()","string"!=typeof r&&log.errHelpURLandThrow({errMsg:"1st arg <address> must be a string.",helpURL:i}),validateOptions({options:o,defaultOptions:a,helpURL:i,exampleCall:"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })"})){(o={...a,...o}).verbose&&log.info(`Validating ${r}...`);let e=r.split(/::?/),t=e[e.length-1];i=!(r.includes("::")&&2<r.split("::").length||/:{3,}/.test(r)||e.length<2||8<e.length||e.some(e=>!(/^[\da-f]{1,4}$/i.test(e)||e==t&&ipv4.validate(t.replace(/\/(?:12[0-8]|[1-9]?\d)$/,""),{verbose:!1}))));return o.verbose&&log.info(`IP is ${i?"":"in"}valid IPv6 address!`),i}}},mac={generate(t={}){var e="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#macgenerateoptions",r={verbose:!0,qty:1,sequential:!1,network:null};if(log.prefix="mac.generate()",validateOptions({options:t,defaultOptions:r,helpURL:e,exampleCall:"mac.generate({ verbose: false, qty: 2 })"})){(t={...r,...t}).verbose&&log.info(`Generating MAC address${1<t.qty?"es":""}...`);var o=[];if(t.sequential){t.network&&this.validate(t.network)?(!t.qty||t.qty<=1)&&log.errHelpURLandThrow({helpURL:e,errMsg:"options.qty must be > 1 when options.sequential is `true`."}):log.errHelpURLandThrow({helpURL:e,errMsg:"options.network must be a valid MAC when options.sequential is `true`."});var i=t.network.split(":").map(e=>parseInt(e,16)||0);for(let e=0;e<t.qty;e++){var a=i[5];i[5]=a+e,i[5]>a+1&&(i[5]=a+1),o.push(i.map(e=>e.toString(16).padStart(2,"0")).join(":"))}}else if(1<t.qty)for(let e=0;e<t.qty;e++)o.push(this.generate({...t,qty:1,verbose:!1}));else{var[r,e]=Array.from({length:2},()=>{var t=[];for(let e=0;e<3;e++)t.push(random.hex(2));return t.join(":")});o.push(r+":"+e)}r=1<t.qty?o:o[0];return t.verbose&&(log.info(`MAC address${1<t.qty?"es":""} generated!`),log.info(1==t.qty?r:r.join(", "))),r}},validate(e,t={}){var r="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#macvalidateaddress-options",o={verbose:!0};if(log.prefix="mac.validate()","string"!=typeof e&&log.errHelpURLandThrow({errMsg:"1st arg <address> must be a string.",helpURL:r}),validateOptions({options:t,defaultOptions:o,helpURL:r,exampleCall:"mac.validate('00:1A:2B:3C:4D:5E', { verbose: false })"}))return(t={...o,...t}).verbose&&log.info(`Validating ${e}...`),r=/^(?:[\da-f]{2}[:-]){5}[\da-f]{2}$/i.test(e),t.verbose&&log.info(`Address is ${r?"":"in"}valid MAC address!`),r}};function validateOptions({options:e,defaultOptions:t,helpURL:r,exampleCall:o}){var i,a,s=Object.keys(t).filter(e=>"boolean"==typeof t[e]),l=Object.keys(t).filter(e=>Number.isInteger(t[e]));if("object"!=typeof e)return i=o.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:",o),log.validOptions(t),log.helpURL(r),!1;for(a in e){if(!Object.prototype.hasOwnProperty.call(t,a))return log.error(`\`${a}\` is an invalid option.`),log.validOptions(t),log.helpURL(r),!1;if(s.includes(a)&&"boolean"!=typeof e[a])return log.error(`[${a}] option can only be \`true\` or \`false\`.`),log.helpURL(r),!1;if(l.includes(a)&&(e[a]=parseInt(e[a],10),isNaN(e[a])||e[a]<1))return log.error(`[${a}] option can only be an integer > 0.`),log.helpURL(r),!1}return!0}let random={int(e,t){var r;return"undefined"==typeof require?(r=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(r*(t-e))+e):require("crypto").randomInt(e,t)},hex(t){let r="";for(let e=0;e<t;e++)r+=random.int(0,16).toString(16);return r}},log={prefix:api.name,errHelpURLandThrow({errMsg:e,helpURL:t}){throw this.error(e),this.helpURL(t),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 t=Object.keys(e).join(", "),e=JSON.stringify(e,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," ");this.info(`Valid options: [${t}]`),this.info("If omitted, default settings are: "+e)}};api.exports={ipv4:ipv4,ipv6:ipv6,mac:mac};try{module.exports={...api.exports}}catch(e){}try{Object.assign(window,api.exports)}catch(e){}for(let t in api.aliases)api.aliases[t].forEach(e=>{try{module.exports[e]??=module.exports[t]}catch(e){}try{window[e]??=window[t]}catch(e){}});

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.1">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.8.1-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.1/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.1&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.1/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.1/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.1/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.1` 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.1",
+  "version": "2.8.2",
   "description": "Randomly generate, format, and validate IPv4 + IPv6 + MAC addresses.",
   "author": {
     "name": "Adam Lui",