@adamlui/geolocate 2.0.16 → 2.2.0

package/README.md

@@ -8,12 +8,12 @@
     <img height=31 src="https://img.shields.io/npm/dm/@adamlui/geolocate?logo=npm&color=af68ff&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="#%EF%B8%8F-mit-license">
     <img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://github.com/adamlui/js-utils/releases/tag/geolocate-2.0.16">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.0.16-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/geolocate-2.2.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/@adamlui/geolocate?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/%40adamlui%2Fgeolocate?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://github.com/adamlui/js-utils/blob/geolocate-2.0.16/geolocate/dist/geolocate.min.js">
-    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/geolocate/dist/geolocate.min.js?branch=geolocate-2.0.16&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/geolocate-2.2.0/geolocate/dist/geolocate.min.js">
+    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/geolocate/dist/geolocate.min.js?branch=geolocate-2.2.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:geolocate/src/geolocate.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%3Ageolocate%2Fsrc%2Fgeolocate.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">
@@ -66,14 +66,35 @@ Sample output:
 ### Command line options
 
 ```
+Parameter options:
+ --ui-lang="code"            ISO 639-1 code of language to display UI in.
+ --config="path/to/file"     Load custom config file.
+
 Boolean options:
  -q, --quiet                 Suppress all logging except errors.
 
-Info commands:
+Commands:
+ -i, --init                  Create config file (in project root).
  -h, --help                  Display help screen.
  -v, --version               Show version number.
 ```
 
+#
+
+### Configuration file
+
+**generate-ip** can be customized using a `geolocate.config.mjs` or `geolocate.config.js` placed in your project root.
+
+Example defaults:
+
+```js
+export default {
+    quietMode: false // suppress all logging except errors
+}
+```
+
+💡 Run `geolocate init` to generate a template `geolocate.config.mjs` in your project root.
+
 <br>
 
 <img height=6px width="100%" src="https://assets.js-utils.org/images/separators/aqua-gradient.png?v=0d36e26">
@@ -87,7 +108,7 @@ You can also import **geolocate** into your app to use its main API method.
 #### ECMAScript*:
 
 ```js
-import geo from '@adamlui/geolocate';
+import geo from '@adamlui/geolocate'
 ```
 
 #### CommonJS:
@@ -103,14 +124,14 @@ const geo = require('@adamlui/geolocate')
 #### <> HTML script tag:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.0.16/dist/geolocate.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.2.0/dist/geolocate.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.0.16/dist/geolocate.min.js')
+    await import('https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.2.0/dist/geolocate.min.js')
     // Your code here...
 })()
 ```
@@ -119,7 +140,7 @@ const geo = require('@adamlui/geolocate')
 
 ```js
 ...
-// @require https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.0.16/dist/geolocate.min.js
+// @require https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.2.0/dist/geolocate.min.js
 // ==/UserScript==
 
 // Your code here...
@@ -127,7 +148,7 @@ const geo = require('@adamlui/geolocate')
 
 <br>
 
-**📝 Note:** To always import the latest version (not recommended in production!) remove the `@2.0.16` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/@adamlui/geolocate/dist/geolocate.min.js`
+**📝 Note:** To always import the latest version (not recommended in production!) remove the `@2.2.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/@adamlui/geolocate/dist/geolocate.min.js`
 
 <br>
 

package/dist/cli/index.min.js

@@ -1,11 +1,8 @@
 #!/usr/bin/env node
 /**
- *  © 2024–2026 Adam Lui under the MIT license.
- *  Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
- *  Documentation: github.com/adamlui/js-utils/tree/main/geolocate/docs
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
  */
-(async()=>{globalThis.env={devMode:__dirname.match(/[\\/]src/)};let e=require("node-clipboardy"),o=require(`../geolocate${env.devMode?"":".min"}.js`),{getMsgs:p,getSysLang:s}=require(`./lib/language${env.devMode?"":".min"}.js`),a=require(`./lib/print${env.devMode?"":".min"}.js`);if(Object.assign(globalThis.app??={},require(`../${env.devMode?"../":"./data/"}app.json`)),app.urls.docs+="/#-command-line-usage",app.msgs=await p(s()),app.colors={nc:"",br:"",by:"",bg:"",bw:"",blk:"",tlBG:""},app.regex={flags:{quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/},version:/^[~^>=]?\d+\.\d+\.\d+$/},app.config={},process.argv.forEach(o=>{var e,p;o.startsWith("-")&&(e=Object.keys(app.regex.flags).find(e=>app.regex.flags[e].test(o)),p=Object.keys(app.regex.infoCmds).find(e=>app.regex.infoCmds[e].test(o)),e?app.config[e]=!0:p||(console.error(`
-${app.colors.br}${app.msgs.prefix_error}: Arg [${o}] ${app.msgs.error_notRecognized}.`+app.colors.nc),console.info(`
-${app.colors.by}${app.msgs.info_validArgs}.`+app.colors.nc),a.help(["paramOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>app.regex.infoCmds.help.test(e)))a.help();else if(process.argv.some(e=>app.regex.infoCmds.version.test(e)))a.version();else{var r,i,c=[];for(r of process.argv.slice(2))r.startsWith("-")||(i=r.replace(/[[\]]/g,""),c.push(i));var n,l=await o.locate(c,{verbose:!app.config.quietMode});l||process.exit(1),app.config.quietMode||1!=l.length||(n=l[0],console.info([`
-IP: `+app.colors.bw+n.ip+app.colors.nc,app.msgs.geoLabel_country+": "+app.colors.bw+n.country+app.colors.nc,app.msgs.geoLabel_region+": "+app.colors.bw+n.regionName+app.colors.nc,app.msgs.geoLabel_city+": "+app.colors.bw+n.city+app.colors.nc,app.msgs.geoLabel_zip+": "+app.colors.bw+n.zip+app.colors.nc,app.msgs.geoLabel_lat+": "+app.colors.bw+n.lat+app.colors.nc,app.msgs.geoLabel_lon+": "+app.colors.bw+n.lon+app.colors.nc,app.msgs.geoLabel_timeZone+": "+app.colors.bw+n.timezone.replace(/_/g," ").replace(/\//g," / ")+app.colors.nc,"ISP: "+app.colors.bw+n.isp+app.colors.nc].join("\n"))),a.ifNotQuiet(`
-${app.msgs.info_copying}...`),e.writeSync(JSON.stringify(l,void 0,2))}})();
+(async()=>{globalThis.env={args:process.argv.slice(2),devMode:/[\\/]src(?:[\\/]|$)/i.test(__dirname)},env.debugMode=env.args.some(e=>/^--?debug(?:-?mode)?$/.test(e)),env.modExt=`${env.devMode?"":".min"}.js`;var e=require("node-clipboardy"),i=require("../geolocate"+env.modExt),o=require("./lib/init"+env.modExt),r=require("./lib/log"+env.modExt);if(await o.cli(),cli.config.init)return o.configFile();if(cli.config.help)return r.help();if(cli.config.version)return r.version();var n,t=[];for(n of env.args)n.startsWith("-")||t.push(n.replace(/[[\]]/g,""));o=await i.locate(t,{verbose:!cli.config.quietMode});o||process.exit(1),cli.config.quietMode||1!=o.length||r.geoData(o[0]),r.ifNotQuiet(`
+${cli.msgs.info_copyingToClip}...`),e.writeSync(JSON.stringify(o,null,2))})();

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

@@ -1,6 +1,6 @@
 /**
- *  © 2024–2026 Adam Lui under the MIT license.
- *  Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
- *  Documentation: github.com/adamlui/js-utils/tree/main/geolocate/docs
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
  */
-module.exports={fetch(n){return 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)})},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}};
+module.exports={atomicWrite(e,r,t="utf8"){var n=require("fs"),a=require("path"),a=a.join(a.dirname(e),`.${a.basename(e)}.tmp`);n.writeFileSync(a,r,t),n.renameSync(a,e)},fetch(n){return"undefined"==typeof fetch?new Promise((t,e)=>{var r=n.match(/^([^:]+):\/\//)[1];/^https?$/.test(r)||e(new Error(cli.msgs.error_invalidURL+".")),require(r).get(n,e=>{let r="";e.on("data",e=>r+=e),e.on("end",()=>t({json:()=>JSON.parse(r)}))}).on("error",e)}):fetch(n)},flatten(e,{key:r="message"}={}){var t,n={};for(t in e)n[t]="object"==typeof e[t]&&r in e[t]?e[t][r]:e[t];return n}};

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

@@ -0,0 +1,6 @@
+/**
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
+ */
+let language=require("./language"+env.modExt),log=require("./log"+env.modExt),settings=require("./settings"+env.modExt),dataPath="../../"+(env.devMode?"../":"data/");module.exports={async cli(){Object.assign(globalThis.cli??={},require(dataPath+"package-data.json")),cli.lang=settings.load("uiLang")||(env.debugMode?language.generateRandomLang({excludes:["en"]}):language.getSysLang()),cli.msgs=await language.getMsgs(cli.lang),cli.urls.cliDocs||=cli.urls.docs+"/#-command-line-usage",settings.load()},async configFile(e=settings.configFilename){var t=require("fs"),a=require("path"),i={target:a.resolve(process.cwd(),e)};if(t.existsSync(i.target))return log.warn(cli.msgs.warn_configFileExists+":",i.target);if(t.existsSync(i.src=a.resolve(__dirname,""+dataPath+e)))t.copyFileSync(i.src,i.target);else{a=require("./jsdelivr"+env.modExt).pkgVerURL+`/${e}/`;log.data(cli.msgs.info_fetchingRemoteConfigFrom+` ${a}...`);try{var s=require("./data"+env.modExt),g=await s.fetch(a);if(!g.ok)return log.warn(`${cli.msgs.warn_remoteConfigNotFound}: ${a} (${g.status})`);s.atomicWrite(i.target,await g.text())}catch(e){return log.warn(cli.msgs.warn_remoteConfigFailed+`: ${a} `+e.message)}}log.success(`${cli.msgs.info_configFileCreated}: ${i.target}\n`),log.tip(cli.msgs.tip_editToSetDefaults+"."),log.tip(cli.msgs.tip_cliArgsPrioritized+".")}};

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

@@ -0,0 +1,6 @@
+/**
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
+ */
+module.exports={pkgVerURL(e){e||=cli.version||=require("./pkg"+env.modExt).getVer("local")||"none";var l=cli.name.split("/")[1],e=/^\d+\.\d+\.\d+$/.test(e)?l+"-"+e:"latest";return cli.urls.jsdelivr+`@${e}/`+l},commitURL(e="latest"){return cli.urls.jsdelivr+`@${e}/`+cli.name.split("/")[1]}};

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

@@ -1,6 +1,7 @@
 /**
- *  © 2024–2026 Adam Lui under the MIT license.
- *  Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
- *  Documentation: github.com/adamlui/js-utils/tree/main/geolocate/docs
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
  */
-module.exports={async getMsgs(r="en"){var e=require(`./data${env.devMode?"":".min"}.js`);let t=e.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`),{key:"message"});if(!r.startsWith("en")){var n=`${app.urls.jsdelivr}@${app.commitHashes.locales}/${app.name.split("/")[1]}/_locales/`;let s=n+`${r?r.replace("-","_"):"en"}/`+"messages.json",a=0;for(;a<3;)try{t=e.flatten(await(await e.fetch(s)).json(),{key:"message"});break}catch(e){if(3==++a)break;s=r.includes("-")&&1==a?s.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):n+"en/messages.json"}}return t},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 console.error("ERROR loading system language:",e.message),"en"}}};
+let data=require("./data"+env.modExt),log=require("./log"+env.modExt);module.exports={formatCode(e){return e.replace(/([a-z]{2,8})[-_]([a-z]{2})/i,(e,r,t)=>r.toLowerCase()+"_"+t.toUpperCase())},generateRandomLang({includes:e=[],excludes:r=[]}={}){let a=require("fs"),s=require("path"),t=e.length?e:(()=>{var e=s.join(__dirname,"..",".cache"),r=s.join(e,"locales.json");if(a.existsSync(r))try{return JSON.parse(a.readFileSync(r,"utf8"))}catch(e){}var t=s.resolve(process.cwd(),"_locales");return a.existsSync(t)?(t=a.readdirSync(t,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).filter(e=>/^\w{2}[-_]?\w{0,2}$/.test(e)),a.mkdirSync(e,{recursive:!0}),data.atomicWrite(r,JSON.stringify(t,null,2)),t):["en"]})(),n=new Set(r),l="en";return(t=t.filter(e=>!n.has(e))).length&&(l=t[Math.floor(Math.random()*t.length)]),log.debug(`Random language: ${l}
+`),l},async getMsgs(a="en"){if(a=module.exports.formatCode(a),env.msgs&&a==cli.lang)return env.msgs;let e=data.flatten(require(`../../${env.devMode?"../_locales/en/":"data/"}messages.json`));if(!a.startsWith("en")){var s=require("./jsdelivr"+env.modExt).commitURL(cli.commitHashes.locales)+"/_locales/";let r=s+a+"/messages.json",t=0;for(;t<3;)try{e=data.flatten(await(await data.fetch(r)).json());break}catch(e){if(3<=++t)break;log.debug(r=a.includes("-")&&1==t?r.replace(/([^_]*)_[^/]*(\/.*)/,"$1$2"):s+"en/messages.json")}}return e},getSysLang(){try{var e;return"win32"==process.platform?require("child_process").execSync("(Get-Culture).TwoLetterISOLanguageName",{shell:"powershell",encoding:"utf-8"}).trim():((e=process.env).LANG||e.LANGUAGE||e.LC_ALL||e.LC_MESSAGES||e.LC_NAME).split(".")[0]}catch(e){return log.error(cli.msgs.error_failedToFetchSysLang+":",e.message),"en"}}};

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

@@ -0,0 +1,23 @@
+/**
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
+ */
+module.exports={colors:{nc:"",br:"",by:"",bo:"",bg:"",bw:"",gry:"",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")},dim(o){console.log(""+this.colors.gry+o+this.colors.nc)},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)},geoData(o){console.info([`
+IP: `+this.colors.bw+o.ip+this.colors.nc,cli.msgs.geoLabel_country+": "+this.colors.bw+o.country+this.colors.nc,cli.msgs.geoLabel_region+": "+this.colors.bw+o.regionName+this.colors.nc,cli.msgs.geoLabel_city+": "+this.colors.bw+o.city+this.colors.nc,cli.msgs.geoLabel_zip+": "+this.colors.bw+o.zip+this.colors.nc,cli.msgs.geoLabel_lat+": "+this.colors.bw+o.lat+this.colors.nc,cli.msgs.geoLabel_lon+": "+this.colors.bw+o.lon+this.colors.nc,cli.msgs.geoLabel_timeZone+": "+this.colors.bw+o.timezone.replace(/_/g," ").replace(/\//g," / ")+this.colors.nc,"ISP: "+this.colors.bw+o.isp+this.colors.nc].join("\n"))},help(o=["header","usage","params","flags","cmds"]){cli.prefix=""+this.colors.tlBG+this.colors.blk+` ${cli.name.replace(/^@[^/]+\//,"")} ${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,` --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,` -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.cliDocs+this.colors.nc)},helpCmdAndDocURL(){console.info(`
+${cli.msgs.info_moreHelp}, ${cli.msgs.info_type} ${cli.name.split("/")[1]} --help' ${cli.msgs.info_or} ${cli.msgs.info_visit}
+`+this.colors.bw+cli.urls.docs+this.colors.nc)},version(){var o=require("./pkg"+env.modExt).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

@@ -0,0 +1,6 @@
+/**
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
+ */
+let log=require("./log"+env.modExt);module.exports={getVer(e="any"){let r;if("global"!=e)try{var l=require("path").resolve(process.cwd(),"node_modules",cli.name,"package.json");r=require(l).version}catch(e){log.debug(cli.msgs.error_readingLocalPkgVer+": "+e.message)}if("global"==e||"all"==e&&!r)try{r=require("child_process").execSync(`npm view ${JSON.stringify(cli.name)} version`).toString().trim()}catch(e){log.debug(cli.msgs.error_failedToFetchGlobalVer+": "+e.message)}return r}};

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

@@ -0,0 +1,7 @@
+/**
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
+ */
+let fs=require("fs"),log=require("./log"+env.modExt),path=require("path");(globalThis.cli??={}).config={},module.exports={configFilename:"geolocate.config.mjs",controls:{uiLang:{type:"param",regex:/^--?ui-?lang(?:=.*|$)/},config:{type:"param",regex:/^--?config(?:=.*|$)/},quietMode:{type:"flag",regex:/^--?q(?:uiet)?(?:-?mode)?$/},init:{type:"cmd",regex:/^-{0,2}i(?:nit)?$/},help:{type:"cmd",regex:/^--?h(?:elp)?$/},version:{type:"cmd",regex:/^--?ve?r?s?i?o?n?$/}},load(e=Object.keys(this.controls)){let c=[].concat(e);if(arguments.length||cli.defaultsSet||(c.forEach(e=>{var i=this.controls[e];i.mode||(cli.config[e]??=i.defaultVal??("param"==i.type&&""))}),cli.defaultsSet=!0),!cli.configPathTried){e=env.args.find(e=>this.controls.config.regex.test(e));if(e){/=/.test(e)||log.errorAndExit(`[${e}] `+cli.msgs.error_mustIncludePath);e=e.split("=")[1];cli.configPath=path.isAbsolute(e)?e:path.resolve(process.cwd(),e),fs.existsSync(cli.configPath)||log.configURLandExit(cli.msgs.error_configFileNotFound+":",cli.configPath)}else for(var i of[".mjs",".cjs",".js"]){i=path.resolve(process.cwd(),this.configFilename.replace(/\.[^.]+$/,i));if(fs.existsSync(i)){cli.configPath=i;break}}cli.configPathTried=!0}if(cli.configPath)try{let e=require(cli.configPath),o=e?.default??e;o&&"object"==typeof o||log.configURLandExit(cli.msgs.error_invalidConfigFile+"."),Object.assign(cli.config,arguments.length?c.reduce((e,i)=>o[i]?{...e,[i]:o[i]}:e,{}):o)}catch(e){log.configURLandExit(cli.msgs.error_failedToLoadConfigFile+":",cli.configPath,`
+`+e.message)}return env.args.forEach(i=>{if(!/^[^-]|--?(?:config|debug)/.test(i)||"init"==i){var o=Object.keys(this.controls).find(e=>this.controls[e]?.regex?.test(i));if(!o&&cli.msgs&&log.errorAndExit(`[${i}] ${cli.msgs.error_notRecognized}.`),c.includes(o)){var t=this.controls[o];if(t.mode)cli.config.mode=o.replace(/mode$/i,"").toLowerCase();else{let e="param"!=t.type||i.split("=")[1]?.trim();t=t.parser;t&&(e=t(e),isNaN(e)||e<1)&&log.errorAndExit(`[${o}] ${cli.msgs.error_nonPositiveNum}.`),cli.config[o]=e}}}}),1==c.length?cli.config[c[0]]:cli.config}};

package/dist/data/geolocate.config.mjs

@@ -0,0 +1,14 @@
+/**
+ * geolocate.config.mjs
+ *
+ * Optional config file for the geolocate 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/geolocate/#-command-line-usage
+ */
+
+export default {
+    uiLang: '',      // ISO 639-1 code of language to display UI in
+    quietMode: false // suppress all logging except errors
+}

package/dist/data/messages.json

@@ -1,16 +1,32 @@
 {
   "appName": { "message": "geolocate" },
   "appCopyright": { "message": "© 2024–2026 Adam Lui under the MIT license" },
-  "prefix_error": { "message": "ERROR" },
   "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_invalidURL": { "message": "Invalid URL" },
-  "info_validArgs": { "message": "Valid arguments are below" },
-  "info_copying": { "message": "Copying to clipboard" },
-  "info_moreHelp": { "message": "For more help" },
+  "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" },
+  "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" },
   "geoLabel_country": { "message": "Country" },
   "geoLabel_region": { "message": "Region" },
   "geoLabel_city": { "message": "City" },
@@ -19,9 +35,13 @@
   "geoLabel_lon": { "message": "Longitude" },
   "geoLabel_timeZone": { "message": "Time zone" },
   "helpSection_usage": { "message": "Usage" },
-  "helpSection_configOptions": { "message": "Config options" },
-  "helpSection_infoCmds": { "message": "Info commands" },
+  "helpSection_params": { "message": "Parameter options" },
+  "helpSection_flags": { "message": "Config options" },
+  "helpSection_cmds": { "message": "Commands" },
+  "optionDesc_uiLang": { "message": "ISO 639-1 code of language to display UI in" },
+  "optionDesc_config": { "message": "Load custom config file" },
   "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/{app.json → package-data.json}

@@ -5,6 +5,7 @@
   "copyrightYear": "2024–2026",
   "cmdFormat": "geolocate [ip1] [ip2] [...] [options|commands]",
   "urls": {
+    "config": "https://github.com/adamlui/js-utils/blob/main/geolocate/geolocate-ip.config.mjs",
     "docs": "https://github.com/adamlui/js-utils/tree/main/geolocate/docs",
     "github": "https://github.com/adamlui/js-utils",
     "jsdelivr": "https://cdn.jsdelivr.net/gh/adamlui/js-utils",
@@ -12,6 +13,6 @@
     "src": "https://github.com/adamlui/js-utils/tree/main/geolocate/src"
   },
   "commitHashes": {
-    "locales": "0e30af1"
+    "locales": "c20c989"
   }
 }

package/dist/geolocate.min.js

@@ -1,6 +1,6 @@
 /**
- *  © 2024–2026 Adam Lui under the MIT license.
- *  Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
- *  Documentation: github.com/adamlui/js-utils/tree/main/geolocate/docs
+ * © 2024–2026 Adam Lui & contributors under the MIT license.
+ * Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
+ * Documentation: https://github.com/adamlui/js-utils/tree/main/geolocate/docs
  */
-async function geolocate(e,n={}){var t,o={verbose:!0};log.prefix="geolocate()",(e=[].concat(e))[0]||=await getOwnIP();for(t of e){n.verbose&&log.info(`Validating ${t}...`);let o;try{o=require("generate-ip").ipv4.validate}catch(e){await import("https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js"),o=window.ipv4.validate}if(o&&!o(t,{verbose:!1}))return log.error(t+" is not a valid IPv4 address.")}if(validateOptions({options:n,defaultOptions:o,helpURL:"https://github.com/adamlui/js-utils/tree/main/geolocate/docs/#-command-line-usage/#locateips-options",exampleCall:"geolocate('8.8.8.8', { verbose: false })"})){n={...o,...n};try{var l,s=[];for(l of e){n.verbose&&log.info(`Fetching geolocation data for ${l}...`);let e=await fetchData("http://ip-api.com/json/"+l),{status:o,org:t,as:r,query:a,...i}=await e.json();s.push({ip:l,...i})}return n.verbose&&"undefined"!=typeof window&&log.info("Success!","Check returned array."),s}catch(e){log.error(e.message)}}}function fetchData(r){return"undefined"==typeof fetch?new Promise((t,o)=>{try{var e=r.match(/^([^:]+):\/\//)[1];/^https?$/.test(e)||o(new Error("Invalid fetchData() URL.")),require(e).get(r,e=>{let o="";e.on("data",e=>o+=e),e.on("end",()=>t({json:()=>JSON.parse(o)}))}).on("error",e=>o(new Error(e.message)))}catch(e){o(new Error("Environment not supported."))}}):fetch(r)}async function getOwnIP(){return fetch("https://ifconfig.me/ip").then(e=>e.text()).catch(()=>fetch("http://ip-api.com/json/").then(e=>e.json()).then(e=>e.query)).catch(async()=>{try{var e=require("child_process").exec,o=require("util").promisify,{stdout:t,stderr:r}=await o(e)("curl -s ifconfig.me");return r?log.error(r):t.trim()}catch(e){log.error(e.message)}})}function validateOptions({options:e,defaultOptions:o,helpURL:t,exampleCall:r}){var a,i,n=Object.keys(o).filter(e=>"boolean"==typeof o[e]),l=Object.keys(o).filter(e=>Number.isInteger(o[e]));if("object"!=typeof e)return a=r.split(",").findIndex(e=>e.trim().startsWith("{"))+1,a+=["st","nd","rd"][a-1]||"th",log.error(`${"0th"==a?"[O":a+" arg [o"}ptions] can only be an object of key/vals.`),log.info("Example valid call:",r),log.validOptions(o),log.helpURL(t),!1;for(i in e){if(!Object.prototype.hasOwnProperty.call(o,i))return log.error(`\`${i}\` is an invalid option.`),log.validOptions(o),log.helpURL(t),!1;if(n.includes(i)&&"boolean"!=typeof e[i])return log.error(`[${i}] option can only be \`true\` or \`false\`.`),log.helpURL(t),!1;if(l.includes(i)&&(e[i]=parseInt(e[i],10),isNaN(e[i])||e[i]<1))return log.error(`[${i}] option can only be an integer > 0.`),log.helpURL(t),!1}return!0}Object.assign(globalThis.app??={},{name:"geolocate",aliases:{geolocate:["Geolocate","geoLocate","GeoLocate","locate","Locate"]}});let 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 o=Object.keys(e).join(", "),e=JSON.stringify(e,void 0,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," ");this.info(`Valid options: [${o}]`),this.info("If omitted, default settings are: "+e)}};try{module.exports={geolocate:geolocate}}catch(e){}try{window.geo={geolocate:geolocate}}catch(e){}for(let o in app.aliases){try{app.aliases[o].forEach(e=>module.exports[e]=module.exports[o])}catch(e){}try{app.aliases[o].forEach(e=>window.geo[e]=window.geo[o])}catch(e){}}
+async function geolocate(e,n={}){var t,o={verbose:!0};log.prefix="geolocate()",(e=[].concat(e))[0]||=await getOwnIP();for(t of e){n.verbose&&log.info(`Validating ${t}...`);let o;try{o=require("generate-ip").ipv4.validate}catch(e){await import("https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js"),o=window.ipv4.validate}if(o&&!o(t,{verbose:!1}))return log.error(t+" is not a valid IPv4 address.")}if(validateOptions({options:n,defaultOptions:o,helpURL:"https://github.com/adamlui/js-utils/tree/main/geolocate/docs/#locateips-options",exampleCall:"geolocate('8.8.8.8', { verbose: false })"})){n={...o,...n};try{var l,s=[];for(l of e){n.verbose&&log.info(`Fetching geolocation data for ${l}...`);let e=await fetchData("http://ip-api.com/json/"+l),{status:o,org:t,as:r,query:a,...i}=await e.json();s.push({ip:l,...i})}return n.verbose&&"undefined"!=typeof window&&log.info("Success!","Check returned array."),s}catch(e){log.error(e.message)}}}function fetchData(r){return"undefined"==typeof fetch?new Promise((t,o)=>{try{var e=r.match(/^([^:]+):\/\//)[1];/^https?$/.test(e)||o(new Error("Invalid fetchData() URL.")),require(e).get(r,e=>{let o="";e.on("data",e=>o+=e),e.on("end",()=>t({json:()=>JSON.parse(o)}))}).on("error",e=>o(new Error(e.message)))}catch(e){o(new Error("Environment not supported."))}}):fetch(r)}async function getOwnIP(){return fetchData("https://ifconfig.me/ip").then(e=>e.text()).catch(()=>fetchData("http://ip-api.com/json/").then(e=>e.json()).then(e=>e.query)).catch(async()=>{try{var e=require("child_process").exec,o=require("util").promisify,{stdout:t,stderr:r}=await o(e)("curl -s ifconfig.me");return r?log.error(r):t.trim()}catch(e){log.error(e.message)}})}function validateOptions({options:e,defaultOptions:o,helpURL:t,exampleCall:r}){var a,i,n=Object.keys(o).filter(e=>"boolean"==typeof o[e]),l=Object.keys(o).filter(e=>Number.isInteger(o[e]));if("object"!=typeof e)return a=r.split(",").findIndex(e=>e.trim().startsWith("{"))+1,a+=["st","nd","rd"][a-1]||"th",log.error(`${"0th"==a?"[O":a+" arg [o"}ptions] can only be an object of key/vals.`),log.info("Example valid call:",r),log.validOptions(o),log.helpURL(t),!1;for(i in e){if(!Object.prototype.hasOwnProperty.call(o,i))return log.error(`\`${i}\` is an invalid option.`),log.validOptions(o),log.helpURL(t),!1;if(n.includes(i)&&"boolean"!=typeof e[i])return log.error(`[${i}] option can only be \`true\` or \`false\`.`),log.helpURL(t),!1;if(l.includes(i)&&(e[i]=parseInt(e[i],10),isNaN(e[i])||e[i]<1))return log.error(`[${i}] option can only be an integer > 0.`),log.helpURL(t),!1}return!0}Object.assign(globalThis.api??={},{name:"geolocate",aliases:{geolocate:["Geolocate","geoLocate","GeoLocate","locate","Locate"]}});let 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 o=Object.keys(e).join(", "),e=JSON.stringify(e,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," ");this.info(`Valid options: [${o}]`),this.info("If omitted, default settings are: "+e)}};try{module.exports={geolocate:geolocate}}catch(e){}try{window.geo={geolocate:geolocate}}catch(e){}for(let o in api.aliases){try{api.aliases[o].forEach(e=>module.exports[e]??=module.exports[o])}catch(e){}try{api.aliases[o].forEach(e=>window.geo[e]??=window.geo[o])}catch(e){}}

package/docs/README.md

@@ -8,12 +8,12 @@
     <img height=31 src="https://img.shields.io/npm/dm/@adamlui/geolocate?logo=npm&color=af68ff&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="#%EF%B8%8F-mit-license">
     <img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://github.com/adamlui/js-utils/releases/tag/geolocate-2.0.16">
-    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.0.16-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/js-utils/releases/tag/geolocate-2.2.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/@adamlui/geolocate?activeTab=code">
     <img height=31 src="https://img.shields.io/npm/unpacked-size/%40adamlui%2Fgeolocate?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://github.com/adamlui/js-utils/blob/geolocate-2.0.16/geolocate/dist/geolocate.min.js">
-    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/geolocate/dist/geolocate.min.js?branch=geolocate-2.0.16&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/geolocate-2.2.0/geolocate/dist/geolocate.min.js">
+    <img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/geolocate/dist/geolocate.min.js?branch=geolocate-2.2.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:geolocate/src/geolocate.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%3Ageolocate%2Fsrc%2Fgeolocate.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">
@@ -66,14 +66,35 @@ Sample output:
 ### Command line options
 
 ```
+Parameter options:
+ --ui-lang="code"            ISO 639-1 code of language to display UI in.
+ --config="path/to/file"     Load custom config file.
+
 Boolean options:
  -q, --quiet                 Suppress all logging except errors.
 
-Info commands:
+Commands:
+ -i, --init                  Create config file (in project root).
  -h, --help                  Display help screen.
  -v, --version               Show version number.
 ```
 
+#
+
+### Configuration file
+
+**generate-ip** can be customized using a `geolocate.config.mjs` or `geolocate.config.js` placed in your project root.
+
+Example defaults:
+
+```js
+export default {
+    quietMode: false // suppress all logging except errors
+}
+```
+
+💡 Run `geolocate init` to generate a template `geolocate.config.mjs` in your project root.
+
 <br>
 
 <img height=6px width="100%" src="https://assets.js-utils.org/images/separators/aqua-gradient.png?v=0d36e26">
@@ -87,7 +108,7 @@ You can also import **geolocate** into your app to use its main API method.
 #### ECMAScript*:
 
 ```js
-import geo from '@adamlui/geolocate';
+import geo from '@adamlui/geolocate'
 ```
 
 #### CommonJS:
@@ -103,14 +124,14 @@ const geo = require('@adamlui/geolocate')
 #### <> HTML script tag:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.0.16/dist/geolocate.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.2.0/dist/geolocate.min.js"></script>
 ```
 
 #### ES6:
 
 ```js
 (async () => {
-    await import('https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.0.16/dist/geolocate.min.js')
+    await import('https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.2.0/dist/geolocate.min.js')
     // Your code here...
 })()
 ```
@@ -119,7 +140,7 @@ const geo = require('@adamlui/geolocate')
 
 ```js
 ...
-// @require https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.0.16/dist/geolocate.min.js
+// @require https://cdn.jsdelivr.net/npm/@adamlui/geolocate@2.2.0/dist/geolocate.min.js
 // ==/UserScript==
 
 // Your code here...
@@ -127,7 +148,7 @@ const geo = require('@adamlui/geolocate')
 
 <br>
 
-**📝 Note:** To always import the latest version (not recommended in production!) remove the `@2.0.16` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/@adamlui/geolocate/dist/geolocate.min.js`
+**📝 Note:** To always import the latest version (not recommended in production!) remove the `@2.2.0` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/@adamlui/geolocate/dist/geolocate.min.js`
 
 <br>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamlui/geolocate",
-  "version": "2.0.16",
+  "version": "2.2.0",
   "description": "Fetch IP geolocation data from the CLI.",
   "author": {
     "name": "Adam Lui",
@@ -40,7 +40,12 @@
     "doc": "./docs"
   },
   "scripts": {
-    "build": "bash utils/build.sh",
+    "build": "node utils/build",
+    "build:js": "node utils/build --js",
+    "build:data": "node utils/build --data",
+    "build:json": "node utils/build --json",
+    "debug": "node src/cli --debug",
+    "translate": "py utils/translate-en-messages.py",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
     "bump:major": "bash utils/bump.sh major"
@@ -50,12 +55,15 @@
     "url": "git+https://github.com/adamlui/js-utils.git"
   },
   "keywords": [
+    "api",
+    "cli",
+    "data",
     "geolocate",
     "geolocation",
     "ip",
     "networking",
-    "api",
-    "cli"
+    "sluething",
+    "utility"
   ],
   "bugs": {
     "url": "https://github.com/adamlui/js-utils/issues"
@@ -64,7 +72,7 @@
     "node-clipboardy": "^1.0.3"
   },
   "devDependencies": {
-    "@adamlui/minify.js": "^2.1.4",
-    "generate-ip": "^2.4.9"
+    "@adamlui/minify.js": "^2.2.1",
+    "generate-ip": "^2.5.0"
   }
 }

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

@@ -1,13 +0,0 @@
-/**
- *  © 2024–2026 Adam Lui under the MIT license.
- *  Source: https://github.com/adamlui/js-utils/tree/main/geolocate/src
- *  Documentation: github.com/adamlui/js-utils/tree/main/geolocate/docs
- */
-module.exports={help(p=["header","usage","configOptions","infoCmds"]){app.prefix=""+app.colors.tlBG+app.colors.blk+` ${app.name.replace(/^@[^/]+\//,"")} ${app.colors.nc} `;let e={header:[`
-├ ${app.prefix}${app.msgs.appCopyright||`© ${app.copyrightYear} ${app.author} under the ${app.license} license`}.`,""+app.prefix+app.msgs.prefix_source+": "+app.urls.src],usage:[`
-${app.colors.bw}o ${app.msgs.helpSection_usage}:`+app.colors.nc,` ${app.colors.bw}» `+app.colors.bg+app.cmdFormat+app.colors.nc],configOptions:[`
-${app.colors.bw}o ${app.msgs.helpSection_configOptions}:`+app.colors.nc,` -q, --quiet                 ${app.msgs.optionDesc_quiet}.`],infoCmds:[`
-${app.colors.bw}o ${app.msgs.helpSection_infoCmds}:`+app.colors.nc," -h, --help                  "+app.msgs.optionDesc_help,` -v, --version               ${app.msgs.optionDesc_version}.`]};p.forEach(n=>e[n]?.forEach(e=>{{var r=/header|usage/.test(n)?1:29;let o=process.stdout.columns||80,s=[],p=e.match(/\S+|\s+/g),a="";p.forEach(p=>{var e=o-(s.length?r:0);a.length+"| ".length+p.length>e&&(s.push(s.length?a.trimStart():a),a=""),a+=p}),s.push(s.length?a.trimStart():a),s.forEach((p,e)=>console.info("| "+(0==e?p:" ".repeat(r)+p)))}})),console.info(`
-${app.msgs.info_moreHelp}, ${app.msgs.info_visit}: `+app.colors.bw+app.urls.docs+app.colors.nc)},ifNotQuiet(p){app.config.quietMode||console.info(p)},version(){var p=require("path"),e=require("child_process").execSync(`npm view ${JSON.stringify(app.name)} version`).toString().trim()||"none";let o,s=process.cwd();for(;"/"!=s;){var a=p.join(s,"package.json");if(require("fs").existsSync(a)){a=require(a);o=(a.dependencies?.[app.name]||a.devDependencies?.[app.name])?.match(/^[~^>=]?\d+\.\d+\.\d+$/)?.[1]||"none";break}s=p.dirname(s)}console.info(`
-${app.msgs.prefix_globalVer}: ${e}
-${app.msgs.prefix_localVer}: `+o)}};