generate-ip 2.6.0 → 2.7.0

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.6.0">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.6.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.7.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.7.0-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.6.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.6.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.7.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.7.0&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.6.0/dist/generate-ip.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/generate-ip@2.7.0/dist/generate-ip.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.6.0/dist/generate-ip.min.js')
+    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.7.0/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.6.0/dist/generate-ip.min.js
+// @require https://cdn.jsdelivr.net/npm/generate-ip@2.7.0/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.6.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.7.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
 
 <br>
 
@@ -151,10 +151,12 @@ ipv4.generate() » 194.84.176.172, 192.186.53.120, 50.191.111.87
 
 Available options:
 
-Name        | Type    | Description                         | Default Value
-------------|---------|-------------------------------------|---------------
-`verbose`   | Boolean | Show logging in console/terminal.   | `true`
-`qty`       | Integer | Number of IP addresses to generate. | `1`
+Name         | Type    | Description                                              | Default Value
+-------------|---------|----------------------------------------------------------|---------------
+`verbose`    | Boolean | Show logging in console/terminal.                        | `true`
+`qty`        | Integer | Number of IP addresses to generate.                      | `1`
+`sequential` | Boolean | Generate addresses in sequence.                          | `false`
+`network`    | String  | starting network address (required for sequential mode). | `null`
 
 #
 
@@ -220,12 +222,14 @@ ipv6.generate() » 8218:19b9:7709:4282:65e1:7ee:319e:32ef, e940:754d:ae46:ae18:9
 
 Available options:
 
-Name           | Type    | Description                          | Default Value
----------------|---------|--------------------------------------|---------------
-`verbose`      | Boolean | Show logging in console/terminal.    | `true`
-`qty`          | Integer | Number of IP addresses to generate.  | `1`
-`leadingZeros` | Boolean | Include leading zeros in hex pieces. | `false`
-`doubleColon`  | Boolean | Replace series of zeros w/ `::`      | `true`
+Name           | Type    | Description                                              | Default Value
+---------------|---------|----------------------------------------------------------|---------------
+`verbose`      | Boolean | Show logging in console/terminal.                        | `true`
+`qty`          | Integer | Number of IP addresses to generate.                      | `1`
+`leadingZeros` | Boolean | Include leading zeros in hex pieces.                     | `false`
+`doubleColon`  | Boolean | Replace series of zeros w/ `::`                          | `true`
+`sequential`   | Boolean | Generate addresses in sequence.                          | `false`
+`network`      | String  | Starting network address (required for sequential mode). | `null`
 
 #
 
@@ -315,10 +319,12 @@ mac.generate() » 1d:3a:af:21:b1:8c, af:fb:6f:b6:1b:8a
 
 Available options:
 
-Name           | Type    | Description                          | Default Value
----------------|---------|--------------------------------------|---------------
-`verbose`      | Boolean | Show logging in console/terminal.    | `true`
-`qty`          | Integer | Number of IP addresses to generate.  | `1`
+Name           | Type    | Description                                              | Default Value
+---------------|---------|----------------------------------------------------------|---------------
+`verbose`      | Boolean | Show logging in console/terminal.                        | `true`
+`qty`          | Integer | Number of IP addresses to generate.                      | `1`
+`sequential`   | Boolean | Generate addresses in sequence.                          | `false`
+`network`      | String  | Starting network address (required for sequential mode). | `null`
 
 #
 
@@ -371,10 +377,12 @@ Parameter options:
  --qty=n                     Generate n IP address(es).
  --ui-lang="code"            ISO 639-1 code of language to display UI in.
  --config="path/to/file"     Load custom config file.
+ --network="address"         Starting network address (required for sequential mode).
 
 Boolean options:
  -6, --ipv6                  Generate IPv6 address.
  -m, --mac                   Generate MAC address.
+ -s, --sequential            Generate addresses in sequence.
  -q, --quiet                 Suppress all logging except errors.
 
 Commands:

package/dist/data/generate-ip.config.mjs

@@ -9,8 +9,10 @@
  */
 
 export default {
-    mode: 'ipv4',     // <ipv4|ipv6|mac> type of address to generate
-    qty: 1,           // # of IPs to generate
-    quietMode: false, // suppress all logging except errors
-    uiLang: ''        // ISO 639-1 code of language to display UI in
+    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

@@ -7,6 +7,8 @@
   "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" },
@@ -14,6 +16,9 @@
   "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" },  
@@ -36,6 +41,8 @@
   "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" },

package/dist/data/package-data.json

@@ -13,6 +13,6 @@
     "src": "https://github.com/adamlui/js-utils/tree/main/generate-ip/src"
   },
   "commitHashes": {
-    "locales": "c20c989"
+    "locales": "6dc65c4"
   }
 }

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.6.0">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.6.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.7.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.7.0-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.6.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.6.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.7.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.7.0&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.6.0/dist/generate-ip.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/generate-ip@2.7.0/dist/generate-ip.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.6.0/dist/generate-ip.min.js')
+    await import('https://cdn.jsdelivr.net/npm/generate-ip@2.7.0/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.6.0/dist/generate-ip.min.js
+// @require https://cdn.jsdelivr.net/npm/generate-ip@2.7.0/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.6.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.7.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
 
 <br>
 
@@ -151,10 +151,12 @@ ipv4.generate() » 194.84.176.172, 192.186.53.120, 50.191.111.87
 
 Available options:
 
-Name        | Type    | Description                         | Default Value
-------------|---------|-------------------------------------|---------------
-`verbose`   | Boolean | Show logging in console/terminal.   | `true`
-`qty`       | Integer | Number of IP addresses to generate. | `1`
+Name         | Type    | Description                                              | Default Value
+-------------|---------|----------------------------------------------------------|---------------
+`verbose`    | Boolean | Show logging in console/terminal.                        | `true`
+`qty`        | Integer | Number of IP addresses to generate.                      | `1`
+`sequential` | Boolean | Generate addresses in sequence.                          | `false`
+`network`    | String  | starting network address (required for sequential mode). | `null`
 
 #
 
@@ -220,12 +222,14 @@ ipv6.generate() » 8218:19b9:7709:4282:65e1:7ee:319e:32ef, e940:754d:ae46:ae18:9
 
 Available options:
 
-Name           | Type    | Description                          | Default Value
----------------|---------|--------------------------------------|---------------
-`verbose`      | Boolean | Show logging in console/terminal.    | `true`
-`qty`          | Integer | Number of IP addresses to generate.  | `1`
-`leadingZeros` | Boolean | Include leading zeros in hex pieces. | `false`
-`doubleColon`  | Boolean | Replace series of zeros w/ `::`      | `true`
+Name           | Type    | Description                                              | Default Value
+---------------|---------|----------------------------------------------------------|---------------
+`verbose`      | Boolean | Show logging in console/terminal.                        | `true`
+`qty`          | Integer | Number of IP addresses to generate.                      | `1`
+`leadingZeros` | Boolean | Include leading zeros in hex pieces.                     | `false`
+`doubleColon`  | Boolean | Replace series of zeros w/ `::`                          | `true`
+`sequential`   | Boolean | Generate addresses in sequence.                          | `false`
+`network`      | String  | Starting network address (required for sequential mode). | `null`
 
 #
 
@@ -315,10 +319,12 @@ mac.generate() » 1d:3a:af:21:b1:8c, af:fb:6f:b6:1b:8a
 
 Available options:
 
-Name           | Type    | Description                          | Default Value
----------------|---------|--------------------------------------|---------------
-`verbose`      | Boolean | Show logging in console/terminal.    | `true`
-`qty`          | Integer | Number of IP addresses to generate.  | `1`
+Name           | Type    | Description                                              | Default Value
+---------------|---------|----------------------------------------------------------|---------------
+`verbose`      | Boolean | Show logging in console/terminal.                        | `true`
+`qty`          | Integer | Number of IP addresses to generate.                      | `1`
+`sequential`   | Boolean | Generate addresses in sequence.                          | `false`
+`network`      | String  | Starting network address (required for sequential mode). | `null`
 
 #
 
@@ -371,10 +377,12 @@ Parameter options:
  --qty=n                     Generate n IP address(es).
  --ui-lang="code"            ISO 639-1 code of language to display UI in.
  --config="path/to/file"     Load custom config file.
+ --network="address"         Starting network address (required for sequential mode).
 
 Boolean options:
  -6, --ipv6                  Generate IPv6 address.
  -m, --mac                   Generate MAC address.
+ -s, --sequential            Generate addresses in sequence.
  -q, --quiet                 Suppress all logging except errors.
 
 Commands:
@@ -387,7 +395,7 @@ Commands:
 
 ### Configuration file
 
-**generate-ip** can be customized using `generate-ip.config.mjs` or `generate-ip.config.js` placed in your project root.
+**generate-ip** can be customized using a `generate-ip.config.mjs` or `generate-ip.config.js` placed in your project root.
 
 Example defaults:
 
@@ -400,7 +408,7 @@ export default {
 }
 ```
 
-💡 Use the `--init` command to generate a template `generate-ip.config.mjs` in your project root.
+💡 Run `generate-ip init` to generate a template `generate-ip.config.mjs` in your project root.
 
 <br>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generate-ip",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Randomly generate, format, and validate IPv4 + IPv6 + MAC addresses.",
   "author": {
     "name": "Adam Lui",
@@ -43,7 +43,7 @@
     "build:data": "node utils/build --data",
     "build:json": "node utils/build --json",
     "debug": "node src/cli --debug",
-    "translate": "py utils/translate-en-messages.py",
+    "translate": "translate-messages",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
     "bump:major": "bash utils/bump.sh major"
@@ -53,16 +53,20 @@
     "url": "git+https://github.com/adamlui/js-utils.git"
   },
   "keywords": [
-    "ip",
-    "generator",
-    "unique",
-    "generate",
+    "address",
     "api",
     "cli",
-    "address",
+    "generate",
+    "generator",
+    "internet",
+    "ip",
     "ipv4",
     "ipv6",
-    "mac"
+    "mac",
+    "network",
+    "privacy",
+    "utility",
+    "unique"
   ],
   "bugs": {
     "url": "https://github.com/adamlui/js-utils/issues"
@@ -71,6 +75,6 @@
     "node-clipboardy": "^1.0.3"
   },
   "devDependencies": {
-    "@adamlui/minify.js": "^2.2.1"
+    "@adamlui/minify.js": "^2.3.0"
   }
 }

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));var e,i=require("node-clipboardy"),{ipv4:n,ipv6:o,mac:s}=require(`../generate-ip${env.devMode?"":".min"}.js`),r=require(`./lib/language${env.devMode?"":".min"}.js`),g=require(`./lib/log${env.devMode?"":".min"}.js`),a=require(`./lib/settings${env.devMode?"":".min"}.js`);Object.assign(globalThis.cli??={},require(`../${env.devMode?"../":"data/"}package-data.json`)),a.load("uiLang"),env.sysLang=cli.config.uiLang||(env.debugMode?r.generateRandomLang({excludes:["en"]}):r.getSysLang()),cli.msgs=await r.getMsgs(env.sysLang),cli.urls.docs+="/#-command-line-usage";for(e of env.args){if(a.controls.init.regex.test(e))return a.initConfigFile();if(a.controls.help.regex.test(e))return g.help();if(a.controls.version.regex.test(e))return g.version()}a.load();r={qty:cli.config.qty,verbose:!cli.config.quietMode},n={ipv4:n,ipv6:o,mac:s}[cli.config.mode||"ipv4"].generate(r);g.ifNotQuiet(`
-${cli.msgs.info_copyingToClip}...`),i.writeSync([].concat(n).join("\n"))})();

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/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.devMode?"":".min"}.js`),log=require(`./log${env.devMode?"":".min"}.js`);module.exports={formatCode(e){return e.replace(/([a-z]{2,8})[-_]([a-z]{2})/i,(e,r,a)=>r.toLowerCase()+"_"+a.toUpperCase())},generateRandomLang({includes:e=[],excludes:r=[]}={}){let t=require("fs"),s=require("path"),a=e.length?e:(()=>{var e=s.join(__dirname,"..",".cache"),r=s.join(e,"locales.json");if(t.existsSync(r))try{return JSON.parse(t.readFileSync(r,"utf8"))}catch(e){}var a=s.resolve(process.cwd(),"_locales");return t.existsSync(a)?(a=t.readdirSync(a,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).filter(e=>/^\w{2}[-_]?\w{0,2}$/.test(e)),t.mkdirSync(e,{recursive:!0}),data.atomicWrite(r,JSON.stringify(a,null,2)),a):["en"]})(),n=new Set(r),l="en";return(a=a.filter(e=>!n.has(e))).length&&(l=a[Math.floor(Math.random()*a.length)]),log.debug(`Random language: ${l}
-`),l},async getMsgs(t="en"){t=module.exports.formatCode(t);let e=data.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`));if(!t.startsWith("en")){var s=`${cli.urls.jsdelivr}@${cli.commitHashes.locales}/${cli.name}/_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"}}};

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:"",blk:"",tlBG:""},configURL(){this.info(`
-${cli.msgs.info_exampleValidConfigFile}: `+cli.urls.config)},configURLandExit(...o){this.error(...o),this.configURL(),process.exit(1)},data(o){console.log(`
-`+this.colors.bw+o+this.colors.nc)},debug(o){env.debugMode&&console.debug(`
-${this.colors.bo}DEBUG:`,o,this.colors.nc,"\n")},error(...o){console.error(`
-${this.colors.br}ERROR:`,...o,this.colors.nc)},errorAndExit(...o){this.error(...o),this.helpCmdAndDocURL(),process.exit(1)},ifNotQuiet(o){cli.config.quietMode||console.info(o)},info(o){console.info(`
-`+this.colors.by+o+this.colors.nc)},tip(o){console.info(this.colors.by+"TIP: "+o+this.colors.nc)},success(o){console.log(`
-`+this.colors.bg+o+this.colors.nc)},warn(...o){console.warn(`
-${this.colors.bo}WARNING:`,...o,this.colors.nc)},help(o=["header","usage","params","flags","cmds"]){cli.prefix=""+this.colors.tlBG+this.colors.blk+` ${cli.name} ${this.colors.nc} `;let s={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}.`],flags:[`
-${this.colors.bw}o ${cli.msgs.helpSection_flags}:`+this.colors.nc,` -6, --ipv6                  ${cli.msgs.optionDesc_ipv6}.`,` -m, --mac                   ${cli.msgs.optionDesc_mac}.`,` -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}.`]};o.forEach(r=>s[r]?.forEach(s=>{{var e=/header|usage/.test(r)?1:29;let i=process.stdout.columns||80,o=s.match(/\S+|\s+/g),c=[],l="";o.forEach(o=>{var s=i-(c.length?e:0);l.length+"| ".length+o.length>s&&(c.push(c.length?l.trimStart():l),l=""),l+=o}),c.push(c.length?l.trimStart():l),c.forEach((o,s)=>console.info("| "+(0==s?o:" ".repeat(e)+o)))}})),console.info(`
-${cli.msgs.info_moreHelp}, ${cli.msgs.info_visit}: `+this.colors.bw+cli.urls.docs+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 o=require(`./pkg${env.devMode?"":".min"}.js`).getVer;this.info(cli.name),this.data(`${cli.msgs.prefix_globalVer}: ${o("global")||"none"}
-${cli.msgs.prefix_localVer}: `+(o("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.devMode?"":".min"}.js`);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.devMode?"":".min"}.js`),path=require("path");(globalThis.cli??={}).config={},module.exports={configFilename:"generate-ip.config.mjs",controls:{qty:{type:"param",defaultVal:1,regex:/^--?qu?a?n?ti?t?y(?:=.*|$)/,parser:e=>parseInt(e,10)},uiLang:{type:"param",regex:/^--?ui-?lang(?:=.*|$)/},config:{type:"param",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)?$/},init:{type:"cmd",regex:/^-{0,2}i(?:nit)?$/},help:{type:"cmd",regex:/^--?h(?:elp)?$/},version:{type:"cmd",regex:/^--?ve?r?s?i?o?n?$/}},async initConfigFile(e=this.configFilename){var i={target:path.resolve(process.cwd(),e)};if(fs.existsSync(i.target))return log.warn(cli.msgs.warn_configFileExists+":",i.target);if(fs.existsSync(i.src=path.resolve(__dirname,"../../"+(env.devMode?"../":"data/")+e)))fs.copyFileSync(i.src,i.target);else{cli.version??=require(`./pkg${env.devMode?"":".min"}.js`).getVer("local");var t=require(`./data${env.devMode?"":".min"}.js`),o=cli.version?cli.name+"-"+cli.version:"latest",o=cli.urls.jsdelivr+`@${o}/${cli.name}/`+e;log.data(cli.msgs.info_fetchingRemoteConfigFrom+` ${o}...`);try{var r=await t.fetch(o);if(!r.ok)return log.warn(`${cli.msgs.warn_remoteConfigNotFound}: ${o} (${r.status})`);t.atomicWrite(i.target,await r.text())}catch(e){return log.warn(cli.msgs.warn_remoteConfigFailed+`: ${o} `+e.message)}}log.success(`${cli.msgs.info_configFileCreated}: ${i.target}\n`),log.tip(cli.msgs.tip_editToSetDefaults+"."),log.tip(cli.msgs.tip_cliArgsPrioritized+".")},load(e=Object.keys(this.controls)){let r=[].concat(e);if(arguments.length||cli.defaultsSet||(r.forEach(e=>{var i=this.controls[e];i.mode||"cmd"==i.type||(cli.config[e]??=i.defaultVal??("flag"!=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=>{if(!/^[^-]|--?(?:config|debug)/.test(i)){var t=Object.keys(this.controls).find(e=>this.controls[e]?.regex?.test(i));if(t||arguments.length||log.errorAndExit(`[${i}] ${cli.msgs.error_notRecognized}.`),r.includes(t)){var o=this.controls[t];if("cmd"!=o.type){let e="param"!=o.type||i.split("=")[1]?.trim();o.mode?cli.config.mode=t.replace(/mode$/i,"").toLowerCase():((o=o.parser)&&(e=o(e),isNaN(e)||e<1)&&log.errorAndExit(`[${t}] ${cli.msgs.error_nonPositiveNum}.`),cli.config[t]=e)}}}}),cli.config}};

package/dist/generate-ip.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
- */
-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={verbose:!0,qty:1};if(log.prefix="ipv4.generate()",validateOptions({options:t,defaultOptions:e,helpURL:"https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv4generateoptions",exampleCall:"ipv4.generate({ verbose: false, qty: 3 })"})){(t={...e,...t}).verbose&&log.info(`Generating IPv4 address${1<t.qty?"es":""}...`);var o=[];if(1<t.qty)for(let e=0;e<t.qty;e++)o.push(this.generate({...t,qty:1,verbose:!1}));else{var i=[];for(let e=0;e<4;e++)i.push(random.int(0,256));o.push(i.join("."))}e=1<t.qty?o:o[0];return t.verbose&&(log.info(`IPv4 address${1<t.qty?"es":""} generated!`),log.info(1==t.qty?e:e.join(", "))),e}},validate(e,t={}){var o="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv4validateaddress-options",i={verbose:!0};return log.prefix="ipv4.validate()","string"!=typeof e?(log.error("1st arg <address> must be a string."),log.helpURL(o)):validateOptions({options:t,defaultOptions:i,helpURL:o,exampleCall:"ipv4.validate('0.0.255.255', { verbose: false })"})?((t={...i,...t}).verbose&&log.info(`Validating ${e}...`),i=!(4!=(o=e.split(".")).length||o.some(e=>!/^\d+$/.test(e)||parseInt(e,10)<0||255<parseInt(e,10))),t.verbose&&log.info(`IP is ${i?"":"in"}valid IPv4 address!`),i):void 0}},ipv6={generate(i={}){var e={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0};if(log.prefix="ipv6.generate()",validateOptions({options:i,defaultOptions:e,helpURL:"https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv6generateoptions",exampleCall:"ipv6.generate({ leadingZeros: true, qty: 5 })"})){(i={...e,...i}).verbose&&log.info(`Generating IPv6 address${1<i.qty?"es":""}...`);var r=[];if(1<i.qty)for(let e=0;e<i.qty;e++)r.push(this.generate({...i,qty:1,verbose:!1}));else{let t=[],{qty:e,...o}=i;for(let e=0;e<8;e++)t.push(random.hex(4));r.push(this.format(t.join(":"),{...o,verbose:!1}))}e=1<i.qty?r:r[0];return i.verbose&&(log.info(`IPv6 address${1<i.qty?"es":""} generated!`),log.info(1==i.qty?e:e.join(", "))),e}},format(t,o={}){var i="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv6formatipv6address-options",r={verbose:!0,leadingZeros:!1,doubleColon:!0};if(log.prefix="ipv6.format()","string"!=typeof t)return log.error("1st arg <ipv6address> must be a string."),log.helpURL(i);if(!this.validate(t,{verbose:!1}))return log.error(t+" is not a valid IPv6 address."),log.helpURL(i);if(validateOptions({options:o,defaultOptions:r,helpURL:i,exampleCall:"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })"})){o={...r,...o};let e=t;if(e=o.doubleColon?(o.verbose&&log.info("Replacing zero series w/ '::'..."),e.replace(/:(?:0+:)+/,"::")):(o.verbose&&log.info("Expanding '::' into zero series..."),i=e.split(":").filter(Boolean).length,r=o.leadingZeros?"0000":"0",i=Array(8-i).fill(r).join(":"),e.replace("::",`:${i}:`)),o.leadingZeros){o.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 o.verbose&&log.info("Stripping leading zeros..."),e=t.replace(/(^|(?<=:))0+(?!:)/g,"$1");return o.verbose&&(e!=t?log.info("IP formatted successfully!"):log.info("IP already formatted to specs."),log.info(e)),e}},validate(o,i={}){var r="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#ipv6validateaddress-options",a={verbose:!0};if(log.prefix="ipv6.validate()","string"!=typeof o)return log.error("1st arg <address> must be a string."),log.helpURL(r);if(validateOptions({options:i,defaultOptions:a,helpURL:r,exampleCall:"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })"})){(i={...a,...i}).verbose&&log.info(`Validating ${o}...`);let e=o.split(/::?/),t=e[e.length-1];r=!(o.includes("::")&&2<o.split("::").length||/:{3,}/.test(o)||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 i.verbose&&log.info(`IP is ${r?"":"in"}valid IPv6 address!`),r}}},mac={generate(t={}){var e={verbose:!0,qty:1};if(log.prefix="mac.generate()",validateOptions({options:t,defaultOptions:e,helpURL:"https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#macgenerateoptions",exampleCall:"mac.generate({ verbose: false, qty: 2 })"})){(t={...e,...t}).verbose&&log.info(`Generating MAC address${1<t.qty?"es":""}...`);var o=[];if(1<t.qty)for(let e=0;e<t.qty;e++)o.push(this.generate({...t,qty:1,verbose:!1}));else{var[e,i]=Array.from({length:2},()=>{var t=[];for(let e=0;e<3;e++)t.push(random.hex(2));return t.join(":")});o.push(e+":"+i)}e=1<t.qty?o:o[0];return t.verbose&&(log.info(`MAC address${1<t.qty?"es":""} generated!`),log.info(1==t.qty?e:e.join(", "))),e}},validate(e,t={}){var o="https://github.com/adamlui/js-utils/tree/main/generate-ip/docs/#macvalidateaddress-options",i={verbose:!0};return log.prefix="mac.validate()","string"!=typeof e?(log.error("1st arg <address> must be a string."),log.helpURL(o)):validateOptions({options:t,defaultOptions:i,helpURL:o,exampleCall:"mac.validate('00:1A:2B:3C:4D:5E', { verbose: false })"})?((t={...i,...t}).verbose&&log.info(`Validating ${e}...`),o=/^(?:[\da-f]{2}[:-]){5}[\da-f]{2}$/i.test(e),t.verbose&&log.info(`Address is ${o?"":"in"}valid MAC address!`),o):void 0}};function validateOptions({options:e,defaultOptions:t,helpURL:o,exampleCall:i}){var r,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 r=i.split(",").findIndex(e=>e.trim().startsWith("{"))+1,r+=["st","nd","rd"][r-1]||"th",log.error(`${"0th"==r?"[O":r+" arg [o"}ptions] can only be an object of key/vals.`),log.info("Example valid call:",i),log.validOptions(t),log.helpURL(o),!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(o),!1;if(s.includes(a)&&"boolean"!=typeof e[a])return log.error(`[${a}] option can only be \`true\` or \`false\`.`),log.helpURL(o),!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(o),!1}return!0}let random={int(e,t){var o;return"undefined"==typeof require?(o=(window.crypto||window.msCrypto)?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random(),Math.floor(o*(t-e))+e):require("crypto").randomInt(e,t)},hex(t){let o="";for(let e=0;e<t;e++)o+=random.int(0,16).toString(16);return o}},log={prefix:api.name,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){}});