generate-ip 2.5.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.5.0">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.5.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.5.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.5.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.5.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.5.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.5.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.5.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`
 
 #
 
@@ -369,11 +375,14 @@ Sample output:
 ```
 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,7 +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
+    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

@@ -1,41 +1,48 @@
 {
   "appName": { "message": "generate-ip" },
   "appCopyright": { "message": "© 2024–2026 Adam Lui & contributors under the MIT license" },
-  "prefix_error": { "message": "ERROR" },
-  "prefix_tip": { "message": "TIP" },
-  "prefix_warning": { "message": "WARNING" },
   "prefix_globalVer": { "message": "Global version" },
   "prefix_localVer": { "message": "Local version" },
   "prefix_source": { "message": "Source" },
-  "error_noEqual": { "message": "requires '=' followed by a value" },
+  "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" },
-  "info_exampleValidConfigFile": { "message": "Example valid config file" },
-  "info_copying": { "message": "Copying to clipboard" },
-  "info_moreHelp": { "message": "For more help" },
+  "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" },
-  "warn_remoteConfigNotFound": { "message": "Remote config file not found" },
-  "warn_remoteConfigFailed": { "message": "Remote config file not found" },
   "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" },

package/dist/data/{app.json → package-data.json}

@@ -13,6 +13,6 @@
     "src": "https://github.com/adamlui/js-utils/tree/main/generate-ip/src"
   },
   "commitHashes": {
-    "locales": "198b91f"
+    "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.5.0">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.5.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.5.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.5.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.5.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.5.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.5.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.5.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`
 
 #
 
@@ -369,11 +375,14 @@ Sample output:
 ```
 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:
@@ -386,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:
 
@@ -399,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.5.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.0"
+    "@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()=>{var e,i=process.argv.slice(2),n=(globalThis.env={debugMode:i.some(e=>/^--?debug(?:-?mode)?$/.test(e)),devMode:/[\\/]src(?:[\\/]|$)/i.test(__dirname)},require("node-clipboardy")),{generateRandomLang:o,getMsgs:r,getSysLang:s}=require(`./lib/language${env.devMode?"":".min"}.js`),{ipv4:t,ipv6:a,mac:g}=require(`../generate-ip${env.devMode?"":".min"}.js`),d=require(`./lib/log${env.devMode?"":".min"}.js`),p=require(`./lib/settings${env.devMode?"":".min"}.js`);Object.assign(globalThis.app??={},require(`../${env.devMode?"../":"./data/"}app.json`)),app.msgs=await r(env.debugMode?o({excludes:["en"]}):s()),app.urls.docs+="/#-command-line-usage";for(e of i){if(p.controls.init.regex.test(e))return p.initConfigFile();if(p.controls.help.regex.test(e))return d.help();if(p.controls.version.regex.test(e))return d.version()}p.load();r={qty:app.config.qty,verbose:!app.config.quietMode},o={ipv4:t,ipv6:a,mac:g}[app.config.mode||"ipv4"].generate(r);d.ifNotQuiet(`
-${app.msgs.info_copying}...`),n.writeSync([].concat(o).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("path"),a=require("fs"),n=n.join(n.dirname(e),`.${n.basename(e)}.tmp`);a.writeFileSync(n,r,t),a.renameSync(n,e)},fetch(n){return"undefined"==typeof fetch?new Promise((t,e)=>{var r=n.match(/^([^:]+):\/\//)[1];/^https?$/.test(r)||e(new Error(app.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,8 +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={generateRandomLang({includes:e=[],excludes:a=[]}={}){let t=require("fs"),s=require("path"),r=e.length?e:(()=>{var e=s.join(__dirname,"..",".cache"),a=s.join(e,"locales.json");if(t.existsSync(a))try{return JSON.parse(t.readFileSync(a,"utf8"))}catch(e){}var r=s.resolve(process.cwd(),"_locales");return t.existsSync(r)?(r=t.readdirSync(r,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).filter(e=>/^[a-z]{2}(?:_[A-Z]{2})?$/.test(e)),t.mkdirSync(e,{recursive:!0}),data.atomicWrite(a,JSON.stringify(r,null,2)),r):["en"]})(),n=new Set(a),l="en";return(r=r.filter(e=>!n.has(e))).length&&(l=r[Math.floor(Math.random()*r.length)]),log.debug(`
-Random language:  ${l}
-`),l},async getMsgs(t="en"){let e=data.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`),{key:"message"});if(!t.startsWith("en")){var s=`${app.urls.jsdelivr}@${app.commitHashes.locales}/${app.name}/_locales/`;let a=s+t.replace("-","_")+"/messages.json",r=0;for(;r<3;)try{log.debug(e=data.flatten(await(await data.fetch(a)).json(),{key:"message"}));break}catch(e){if(2<++r)break;a=t.includes("-")&&1==r?a.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):s+"en/messages.json"}}return e},getSysLang(){var e;if("win32"!=process.platform)return((e=process.env).LANG||e.LANGUAGE||e.LC_ALL||e.LC_MESSAGES||e.LC_NAME||"en").split(".")[0];try{return require("child_process").execSync("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim()}catch(e){return log.error("ERROR loading system language:",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(`
-${app.msgs.info_exampleValidConfigFile}: `+app.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.log(s)},error(...s){console.error(`
-${this.colors.br}${app.msgs.prefix_error}:`,...s,this.colors.nc)},errorAndExit(...s){this.error(...s),this.helpCmdAndDocURL(),process.exit(1)},ifNotQuiet(s){app.config.quietMode||console.info(s)},info(s){console.info(`
-`+this.colors.by+s+this.colors.nc)},tip(s){console.info(""+this.colors.by+app.msgs.prefix_tip+": "+s+this.colors.nc)},success(s){console.log(`
-`+this.colors.bg+s+this.colors.nc)},warn(...s){console.warn(`
-${this.colors.bo}${app.msgs.prefix_warning}:`,...s,this.colors.nc)},help(s=["header","usage","params","flags","cmds"]){app.prefix=""+this.colors.tlBG+this.colors.blk+` ${app.name} ${this.colors.nc} `;let o={header:[`
-├ ${app.prefix}${app.msgs.appCopyright}.`,""+app.prefix+app.msgs.prefix_source+": "+app.urls.src],usage:[`
-${this.colors.bw}o ${app.msgs.helpSection_usage}:`+this.colors.nc,` ${this.colors.bw}» `+this.colors.bg+app.cmdFormat+this.colors.nc],params:[`
-${this.colors.bw}o ${app.msgs.helpSection_params}:`+this.colors.nc,` --qty=n                     ${app.msgs.optionDesc_qty}.`,` --config="path/to/file"     ${app.msgs.optionDesc_config}.`],flags:[`
-${this.colors.bw}o ${app.msgs.helpSection_flags}:`+this.colors.nc,` -6, --ipv6                  ${app.msgs.optionDesc_ipv6}.`,` -m, --mac                   ${app.msgs.optionDesc_mac}.`,` -q, --quiet                 ${app.msgs.optionDesc_quiet}.`],cmds:[`
-${this.colors.bw}o ${app.msgs.helpSection_cmds}:`+this.colors.nc,` -i, --init                  ${app.msgs.optionDesc_init}.`,` -h, --help                  ${app.msgs.optionDesc_help}.`,` -v, --version               ${app.msgs.optionDesc_version}.`]};s.forEach(c=>o[c]?.forEach(o=>{{var r=/header|usage/.test(c)?1:29;let e=process.stdout.columns||80,s=o.match(/\S+|\s+/g),p=[],i="";s.forEach(s=>{var o=e-(p.length?r:0);i.length+"| ".length+s.length>o&&(p.push(p.length?i.trimStart():i),i=""),i+=s}),p.push(p.length?i.trimStart():i),p.forEach((s,o)=>console.info("| "+(0==o?s:" ".repeat(r)+s)))}})),console.info(`
-${app.msgs.info_moreHelp}, ${app.msgs.info_visit}: `+this.colors.bw+app.urls.docs+this.colors.nc)},helpCmdAndDocURL(){console.info(`
-${app.msgs.info_moreHelp}, ${app.msgs.info_type} ${app.name} --help' ${app.msgs.info_or} ${app.msgs.info_visit}
-`+this.colors.bw+app.urls.docs+this.colors.nc)},version(){var s=require("child_process").execSync(`npm view ${JSON.stringify(app.name)} version`).toString().trim()||"none";let o="none";try{var e=require("path").resolve(process.cwd(),"node_modules",app.name,"package.json");require("fs").existsSync(e)&&(o=require(e).version||"none")}catch(s){this.error("Error reading local package version:",s.message)}console.info(`
-${app.msgs.prefix_globalVer}: ${s}
-${app.msgs.prefix_localVer}: `+o)}};

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

@@ -1,8 +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.app??={}).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)},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(o=this.configFilename){var e=path.resolve(process.cwd(),o);if(fs.existsSync(e))return log.warn(app.msgs.warn_configFileExists+":",e);var i=path.resolve(__dirname,"../../"+(env.devMode?"../":"./data/")+o);if(fs.existsSync(i))fs.copyFileSync(i,e);else{i=require(`./data${env.devMode?"":".min"}.js`),o=app.urls.jsdelivr+"/generate-ip/"+o;log.data(app.msgs.info_fetchingRemoteConfigFrom+` ${o}...`);try{var r=await i.fetch(o);if(!r.ok)return log.warn(`${app.msgs.warn_remoteConfigNotFound}: ${o} (${r.status})`);i.atomicWrite(e,await r.text())}catch(e){return log.warn(app.msgs.warn_remoteConfigFailed+`: ${o} `+e.message)}}log.success(app.msgs.info_configFileCreated+`: ${e}
-`),log.tip(app.msgs.tip_editToSetDefaults+"."),log.tip(app.msgs.tip_cliArgsPrioritized+".")},load({args:e=process.argv.slice(2),ctrlKeys:t=Object.keys(this.controls)}={}){t.forEach(e=>{var o=this.controls[e];o.mode||"cmd"==o.type||(app.config[e]??=o.defaultVal??("flag"!=o.type&&""))});let o=null;var i=e.find(e=>this.controls.config.regex.test(e));if(i){/=/.test(i)||log.errorAndExit(`[${i}] `+app.msgs.error_mustIncludePath);i=i.split("=")[1];o=path.isAbsolute(i)?i:path.resolve(process.cwd(),i),fs.existsSync(o)||log.configURLandExit(app.msgs.error_configFileNotFound+":",o)}else for(var r of["mjs","cjs","js"]){r=path.resolve(process.cwd(),this.configFilename.replace(/\.[^.]+$/,"."+r));if(fs.existsSync(r)){o=r;break}}if(o)try{var s=require(o),a=s?.default??s;a&&"object"==typeof a||log.configURLandExit(app.msgs.error_invalidConfigFile+"."),Object.assign(app.config,a)}catch(e){log.configURLandExit(app.msgs.error_failedToLoadConfigFile+":",o,`
-`+e.message)}return e.forEach(o=>{if(!/^[^-]|--?(?:config|debug)/.test(o)){var i=t.find(e=>this.controls[e]?.regex?.test(o)),r=(i||log.errorAndExit(`[${o}] ${app.msgs.error_notRecognized}.`),this.controls[i]);if("cmd"!=r.type){let e="param"!=r.type||o.split("=")[1]?.trim();r.mode?app.config.mode=i.replace(/mode$/i,"").toLowerCase():((r=r.parser)&&(e=r(e),isNaN(e)||e<1)&&log.errorAndExit(`[${i}] ${app.msgs.error_nonPositiveNum}.`),app.config[i]=e)}}}),app.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.app??={},{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:app.name,error(...e){console.error(this.prefix+" » ERROR:",...e)},helpURL(e=app.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,void 0,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," ");this.info(`Valid options: [${t}]`),this.info("If omitted, default settings are: "+e)}};app.exports={ipv4:ipv4,ipv6:ipv6,mac:mac};try{module.exports={...app.exports}}catch(e){}try{Object.assign(window,app.exports)}catch(e){}for(let t in app.aliases)app.aliases[t].forEach(e=>{try{module.exports[e]??=module.exports[t]}catch(e){}try{window[e]??=window[t]}catch(e){}});