generate-pw 1.2.0 → 1.2.2

package/README.md

@@ -5,8 +5,10 @@
             <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
         </picture>
         &nbsp;English |
-        <a href="https://github.com/adamlui/js-utils/tree/main/minify.js/docs/zh-cn#readme">简体中文</a> |
-        <a href="https://github.com/adamlui/js-utils/tree/main/minify.js/docs/zh-tw#readme">繁體中文</a>
+        <a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/zh-cn#readme">简体中文</a> |
+        <a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/zh-tw#readme">繁體中文</a> |
+        <a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/hi#readme">हिंदी</a> |
+        <a href="https://github.com/adamlui/js-utils/tree/main/generate-pw/docs/bn#readme">বাংলা</a>
     </h6>
 </div>
 
@@ -15,7 +17,7 @@
 ### Randomly generate cryptographically-secure passwords.
 
 <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://www.npmjs.com/package/generate-pw?activeTab=versions"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.2.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-pw-1.2.2"><img height=31 src="https://img.shields.io/badge/Latest_Build-1.2.2-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="https://www.npmjs.com/package/generate-pw?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-pw?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
 <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/generate-pw.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-pw%2Fgenerate-pw.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
 
@@ -101,14 +103,14 @@ See: [Available options](#available-options-for-generate-functions)
 
 ### `strictify(password[, requiredCharTypes])`
 
-Modifies `password` given to use at least one character of each `requiredCharTypes` element passed, returning a string.
+Modifies `password` given to use at least one character of each `requiredCharTypes` element passed, returning a string:
 
 ```js
 const password = 'abcdef',
       strictPW = pw.strictify(password, ['numbers', 'symbols']);
 
 console.log(strictPW);
-// sample output: 'a!c2eR'
+// sample output: 'a!c2ef'
 ```
 
 Available `requiredCharTypes` are: `['number', 'symbol', 'lower', 'upper']`
@@ -119,7 +121,12 @@ Available `requiredCharTypes` are: `['number', 'symbol', 'lower', 'upper']`
 
 ### `validateStrength(password)`
 
-Validates the strength of a password, returning an object containing `strengthScore` (out of 100) + `recommendations` array.
+Validates the strength of a password, returning an object containing:
+- `strengthScore` (0–100)
+- `recommendations` array
+- `isGood` boolean (`true` if `strengthScore` >= 80) 
+
+Example:
 
 ```js
 const password = 'AawiddsE',
@@ -128,9 +135,11 @@ const password = 'AawiddsE',
 console.log(pwStrength);
 
 /* outputs:
+
 {
   strengthScore: 60,
-  recommendations: [ 'Include at least one number.', 'Include at least one symbol.' ]
+  recommendations: [ 'Include at least one number.', 'Include at least one symbol.' ],
+  isGood: false
 }
 */
 ```
@@ -161,13 +170,13 @@ Name        | Type    | Description
 
 ## 💻 Command line usage
 
-When installed globally, **generate-pw** can also be used from the command line. The basic command is:
+When installed [globally](#-installation), **generate-pw** can also be used from the command line. The basic command is:
 
 ```
 $ generate-pw
 ```
 
-**💡 Note:** To generate multiple results, pass `--qty=n` where `n` is the number of passwords to generate.
+**💡 Note:** For security reasons, generated password(s) are stored in the clipboard.
 
 #
 

package/dist/generate-pw.min.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+const p=require("crypto")["randomInt"],s=require("child_process")["execSync"],u={lower:"abcdefghijklmnopqrstuvwxyz",upper:"ABCDEFGHIJKLMNOPQRSTUVWXYZ",numbers:"0123456789",symbols:"!@#$%^&*()-_=+[]{}/\\|;:'\",.<>?"};function a(o={}){var e,s={length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,strict:!1};o={...s,...o};for(const r of Object.keys(o))if(!Object.prototype.hasOwnProperty.call(s,r))return console.error(`generatePassword() » ERROR: \`${r}\` is an invalid option.`+`
+generatePassword() » Valid options:
+  [ ${Object.keys(s).join(", ")} ]`);for(const n of["length","qty"])if(isNaN(o[n])||o[n]<1)return console.error(`generatePassword() » ERROR: [${n}] option must be > 1.`);for(const a of["numbers","symbols","lowercase","uppercase","strict"])if("boolean"!=typeof o[a])return console.error(`generatePassword() » ERROR: [${a}] option can only be \`true\` or \`false\`.`);if(1<o.qty){const{qty:l,...c}=o;return i(l,c)}{let s=o.charset||(o.numbers?u.numbers:"")+(o.symbols?u.symbols:"")+(o.lowercase?u.lower:"")+(o.uppercase?u.upper:""),r=(s=(s=""===s?u.lower+u.upper:s).replace(new RegExp(`[${o.exclude}]`,"g"),""),"");for(let e=0;e<o.length;e++){var t=p(0,s.length);r+=s.charAt(t)}return o.strict&&(e=["number","symbol","lower","upper"].filter(e=>o[e+"s"]||o[e+"case"]),r=m(r,e)),r}}function i(s,r={}){var e={length:8,qty:1,charset:"",exclude:"",numbers:!1,symbols:!1,lowercase:!0,uppercase:!0,strict:!1};if(r={...e,...r},s=parseInt(s),isNaN(s))return console.error("generatePasswords() » ERROR: First argument [qty] of generatePasswords() must be an integer");for(const t of Object.keys(r))if(!Object.prototype.hasOwnProperty.call(e,t))return console.error(`generatePasswords() » ERROR: \`${t}\` is an invalid option.`+`
+generatePassword() » Valid options:
+  [ ${Object.keys(e).join(", ")} ]`);if(isNaN(r.length)||r.length<1)return console.error("generatePasswords() » ERROR: [length] options must be > 1.");for(const n of["numbers","symbols","lowercase","uppercase","strict"])if("boolean"!=typeof r[n])return console.error(`generatePasswords() » ERROR: [${n}] option can only be \`true\` or \`false\`.`);var o=[];for(let e=0;e<s;e++)o.push(a(r));return o}function m(s,r=["number","symbol","lower","upper"]){for(const l of r)global["has"+l.charAt(0).toUpperCase()+l.slice(1)]=!1;for(let e=0;e<s.length;e++)for(const c of r)(u[c]||u[c+"s"]).includes(s.charAt(e))&&(global["has"+c.charAt(0).toUpperCase()+c.slice(1)]=!0);var e=Math.min(s.length,r.length),o=[];let t=0,n=s;for(const i of r)if(t<e&&!global["has"+i.charAt(0).toUpperCase()+i.slice(1)]){let e;for(;e=p(0,s.length),o.includes(e););o.push(e);var a=u[i]||u[i+"s"];n=n.substring(0,e)+a.charAt(p(0,a.length))+n.substring(e+1),t++}return n}function e(e){var s={minLength:8,minLower:1,minUpper:1,minNumber:1,minSymbol:1},r={lower:0,upper:0,number:0,symbol:0};for(const n of e)for(const a of Object.keys(r))(u[a]||u[a+"s"]).includes(n)&&r[a]++;var o=[];e.length<s.minLength&&o.push(`Make it at least ${s.minLength} characters long.`);for(const l of Object.keys(r))r[l]<s["min"+l.charAt(0).toUpperCase()+l.slice(1)]&&o.push("Include at least one "+l+`${["upper","lower"].includes(l)?"case letter":""}.`);let t=0;t+=e.length>=s.minLength?20:0;for(const c of Object.keys(r))t+=r[c]>=s["min"+c.charAt(0).toUpperCase()+c.slice(1)]?20:0;return{strengthScore:t,recommendations:o,isGood:80<=t}}if(require.main!==module)module.exports={generatePassword:a,generatePasswords:i,strictify:m,validateStrength:e};else{const n="",l="",c="",h={},d={paramOptions:{length:/^--?length/,qty:/^--?qu?a?n?ti?t?y=.*$/,charset:/^--?chars/,excludeChars:/^--?exclude=/},flags:{includeNums:/^--?(?:n|(?:include-?)?num(?:ber)?s?=?(?:true|1)?)$/,includeSymbols:/^--?(?:s|(?:include-?)?symbols?=?(?:true|1)?)$/,excludeLowerChars:/^--?(?:L|(?:exclude|disable|no)-?lower-?(?:case)?|lower-?(?:case)?=(?:false|0))$/,excludeUpperChars:/^--?(?:U|(?:exclude|disable|no)-?upper-?(?:case)?|upper-?(?:case)?=(?:false|0))$/,strictMode:/^--?s(?:trict)?(?:-?mode)?$/},cmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(s=>{var e,r,o;s.startsWith("-")&&(o=Object.keys(d.flags).find(e=>d.flags[e].test(s)),e=Object.keys(d.paramOptions).find(e=>d.paramOptions[e].test(s)),r=Object.keys(d.cmds).find(e=>d.cmds[e].test(s)),o?h[o]=!0:e?(o=s.split("=")[1],h[e]=parseInt(o)||o):r||(console.error(`
+${l}ERROR: Arg [${s}] not recognized.`+n),console.info(`
+${c}Valid arguments are below.`+n),t(["paramOptions","booelanOptions","infoCmds"]),process.exit(1)))}),process.argv.some(e=>/^--?h(?:elp)?$/.test(e)))t();else if(process.argv.some(e=>/^--?ve?r?s?i?o?n?$/.test(e)))console.info("v"+require("./package.json").version);else{for(const g of["length","qty"])h[g]&&(isNaN(h[g])||h[g]<1)&&(console.error(`
+${l}Error: [${g}] argument must be > 1.`+n),process.exit(1));const o={length:h.length||8,qty:h.qty||1,charset:h.charset,exclude:h.excludeChars,numbers:!!h.includeNums,symbols:!!h.includeSymbols,lowercase:!h.excludeLowerChars,uppercase:!h.excludeUpperChars,strict:!!h.strictMode},f=a(o);r(Array.isArray(f)?f.join("\n"):f)}function t(e=["cmdFormat","paramOptions","booelanOptions","infoCmds"]){const s={cmdFormat:[`
+${c}generate-pw [options|commands]`+n],paramOptions:["\nParameter options:"," --length=n                  Generate password(s) of n length."," --qty=n                     Generate n password(s)."," --charset=chars             Only include chars in password(s)."," --charset=chars             Only include chars in password(s)."," --exclude=chars             Exclude chars from password(s)."],booelanOptions:["\nBoolean options:"," -n, --include-numbers       Allow numbers in password(s)."," -s, --include-symbols       Allow symbols in password(s)."," -L, --no-lowercase          Disallow lowercase letters in password(s)."," -U, --no-uppercase          Disallow uppercase letters in password(s)."],infoCmds:["\nInfo commands:"," -h, --help                  Display help screen."," -v, --version               Show version number."]};e.forEach(e=>{s[e]?.forEach(e=>{{const o=process.stdout.columns||80,t=[],s=e.match(/\S+|\s+/g);let r="";s.forEach(e=>{var s=o-(0===t.length?0:29);r.length+e.length>s&&(t.push(0===t.length?r:r.trimStart()),r=""),r+=e}),t.push(0===t.length?r:r.trimStart()),t.forEach((e,s)=>console.info(0===s?e:" ".repeat(29)+e))}})})}function r(e){e=e.replace(/\s+$/m,"").replace(/"/g,'""'),"darwin"===process.platform?s(`printf "${e}" | pbcopy`):"linux"===process.platform?s(`printf "${e}" | xclip -selection clipboard`):"win32"===process.platform&&s(`Set-Clipboard -Value "${e}"`,{shell:"powershell"})}}

package/docs/LICENSE.md

@@ -6,7 +6,9 @@
         </picture>
         &nbsp;English |
         <a href="zh-cn/LICENSE.md">简体中文</a> |
-        <a href="zh-tw/LICENSE.md">繁體中文</a>
+        <a href="zh-tw/LICENSE.md">繁體中文</a> |
+        <a href="hi/LICENSE.md">हिंदी</a> |
+        <a href="bn/LICENSE.md">বাংলা</a>
     </h6>
 </div>
 

package/docs/SECURITY.md

@@ -6,7 +6,9 @@
         </picture>
         &nbsp;English |
         <a href="zh-cn/SECURITY.md">简体中文</a> |
-        <a href="zh-tw/SECURITY.md">繁體中文</a>
+        <a href="zh-tw/SECURITY.md">繁體中文</a> |
+        <a href="hi/SECURITY.md">हिंदी</a> |
+        <a href="bn/SECURITY.md">বাংলা</a>
     </h6>
 </div>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generate-pw",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Randomly generate cryptographically-secure passwords.",
   "author": {
     "name": "Adam Lui",
@@ -9,13 +9,19 @@
   },
   "homepage": "https://github.com/adamlui/js-utils",
   "license": "MIT",
-  "main": "generate-pw.js",
+  "main": "dist/generate-pw.min.js",
+  "files": [
+    "dist",
+    "docs/",
+    "!docs/*/"
+  ],
   "bin": {
-    "generatepw": "generate-pw.js",
-    "generate-pw": "generate-pw.js"
+    "generatepw": "dist/generate-pw.min.js",
+    "generate-pw": "dist/generate-pw.min.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "minify-js generate-pw.js dist",
     "bump:patch": "bash utils/bump.sh patch",
     "bump:minor": "bash utils/bump.sh minor",
     "bump:major": "bash utils/bump.sh major",
@@ -31,7 +37,9 @@
     "password",
     "generator",
     "unique",
-    "generate"
+    "generate",
+    "api",
+    "cli"
   ],
   "bugs": {
     "url": "https://github.com/adamlui/js-utils/issues"
@@ -39,5 +47,8 @@
   "funding": {
     "type": "github",
     "url": "https://github.com/sponsors/adamlui"
+  },
+  "devDependencies": {
+    "@adamlui/minify.js": "^1.4.6"
   }
 }

package/docs/zh-cn/LICENSE.md

@@ -1,21 +0,0 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;简体中文 |
-        <a href="../LICENSE.md">English</a> |
-        <a href="../zh-tw/LICENSE.md">繁體中文</a>
-    </h6>
-</div>
-
-# 🏛️ MIT 许可证
-
-**版权所有 © 2024 [刘展鹏 (Adam Lui)](https://github.com/adamlui)**
-
-特此免费向任何获得副本的人授予许可本软件和相关文档文件（『软件』），处理在软件中不受限制，包括但不限于权利使用、复制、修改、合并、发布、分发、再许可和/或出售该软件的副本，并允许该软件是提供这样做，但须满足以下条件：
-
-上述版权声明和本许可声明应包含在所有软件的副本或重要部分。
-
-本软件『按原样』提供，不提供任何形式的明示或保证暗示的，包括但不限于适销性保证，适用于特定目的和非侵权。 在任何情况下都不得作者或版权持有人对任何索赔、损害或其他责任，无论是在合同、侵权或其他方面的行为中，由以下原因引起，出于或与软件或使用或其他交易有关软件。

package/docs/zh-cn/README.md

@@ -1,214 +0,0 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;简体中文 |
-        <a href="../..#readme">English</a> |
-        <a href="../zh-tw#readme">繁體中文</a>
-    </h6>
-</div>
-
-# > generate-pw
-
-### 随机生成加密安全密码。
-
-<a href="#%EF%B8%8F-mit-%E8%AE%B8%E5%8F%AF%E8%AF%81"><img height=31 src="https://img.shields.io/badge/许可证-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://www.npmjs.com/package/generate-pw?activeTab=versions"><img height=31 src="https://img.shields.io/badge/最新版本-1.2.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://www.npmjs.com/package/generate-pw?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-pw?label=%E6%8B%86%E5%B0%81%E5%B0%BA%E5%AF%B8&style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/generate-pw.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-pw%2Fgenerate-pw.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=%E6%BC%8F%E6%B4%9E&color=gold"></a>
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## ⚡ 安装
-
-作为**全局实用程序**：
-
-```
-$ npm install -g generate-pw
-```
-
-作为 **运行时依赖项**，从项目根目录：
-
-```
-$ npm install generate-pw
-```
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## 🔌 API 使用
-
-**generate-pw** 可以作为 ECMAScript 模块或 CommonJS 模块导入到您的应用程序中。
-
-#### ESM:
-
-```js
-import * as pw from 'generate-pw';
-```
-
-#### CJS:
-
-```js
-const pw = require('generate-pw');
-```
-
-#
-
-### `generatePassword([options])`
-
-如果未给出 `qty` 选项，则生成**一个**密码，并返回一个字符串：
-
-```js
-const password = pw.generatePassword({ length: 11, numbers: true });
-console.log(password);
-// 示例输出：'bAsZm3mq6Qn'
-```
-
-...或 **多个** 密码（如果给出了 `qty` 选项），返回一个字符串数组：
-
-```js
-const passwords = pw.generatePassword({ qty: 5, length: 8, symbols: true });
-console.log(passwords);
-// 示例输出：[ '!zSf@Q.s', '!,HT\\;m=', '?Lq&FV>^', 'gf}Y;}Ne', 'Stsx(GqE' ]
-```
-
-**💡 注意：**如果不传递任何选项，密码将为 8 个字符长，由大小写字母组成。
-
-请参阅：[可用选项](#available-options-for-generate-functions)
-
-#
-
-### `generatePasswords(qty[, options])`
-
-根据给定的 `qty` 生成**多个**密码，返回字符串数组：
-
-```js
-const passwords = pw.generatePasswords(5, { length: 3, uppercase: false });
-console.log(passwords);
-// 示例输出：[ 'yilppxru', 'ckvkyjfp', 'zolcpyfb' ]
-```
-
-**💡 注意：**如果没有传递 `qty` 参数，则只会生成一个密码，并以字符串形式返回。
-
-请参阅：[可用选项](#available-options-for-generate-functions)
-
-#
-
-### `strictify(password[, requiredCharTypes])`
-
-修改指定的 `password`，以使用传递的每个 `requiredCharTypes` 元素中的至少一个字符，返回一个字符串。
-
-```js
-const password = 'abcdef',
-      strictPW = pw.strictify(password, ['numbers', 'symbols']);
-
-console.log(strictPW);
-// 示例输出：'a!c2eR'
-```
-
-可用的 `requiredCharTypes` 有：`['number', 'symbol', 'lower', 'upper']`
-
-**💡注意：**如果没有传递 `requiredCharTypes` 数组，则所有可用类型都将是必需的。
-
-#
-
-### `validateStrength(password)`
-
-验证密码的强度，返回一个包含 `strengthScore`（满分 100）+ `recommendations` 数组的对象。
-
-```js
-const password = 'AawiddsE',
-      pwStrength = pw.validateStrength(password);
-
-console.log(pwStrength);
-
-/* 输出：
-{
-  strengthScore: 60,
-  recommendations: [ 'Include at least one number.', 'Include at least one symbol.' ]
-}
-*/
-```
-
-#
-
-### `generate*()` 函数的可用选项
-
-其中任何一个都可以传递到每个 `generate*()` 函数的选项对象中：
-
-姓名        | 类型   | 描述                                     | 默认值
-------------|--------|-----------------------------------------|--------
-`length`    | 整数   | 密码的长度。                              | `8`
-`qty`*      | 整数   | 要生成的密码数量。                         | `1`
-`charset`   | 字符串 | 密码中包含的字符。                         | `''`
-`exclude`   | 字符串 | 要从密码中排除的字符。                     | `''`
-`numbers`   | 布尔值 | 允许密码中包含数字。                       | `false`
-`symbols`   | 布尔值 | 允许密码中包含符号。                       | `false`
-`lowercase` | 布尔值 | 密码中允许使用小写字母。                   | `true`
-`uppercase` | 布尔值 | 密码中允许使用大写字母。                   | `true`
-`strict`    | 布尔值 | 要求密码中每个允许的字符集中至少有一个字符。 | `false`
-
-##### _*仅在 [`generatePassword([options])`](#generatepasswordoptions) 中可用，因为 [`generatePasswords(qty[, options])`](#generatepasswordsqty-options) 采用 `qty` 参数_
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## 💻 命令行使用
-
-全局安装时，**generate-pw** 也可以从命令行使用。 基本命令是：
-
-```
-$ generate-pw
-```
-
-**💡 注意：**要生成多个结果，请传递 `--qty=n`，其中 `n` 是要生成的密码数量。
-
-#
-
-### 命令行选项
-
-```
-参数选项：
- --length=n                  生成 n 长度的密码。
- --qty=n                     生成 n 个密码。
- --charset=chars             密码中仅包含 chars。
- --exclude=chars             从密码中排除 chars。
-
-布尔选项：
- -n, --include-numbers       允许密码中包含数字。
- -s, --include-symbols       允许密码中包含符号。
- -L, --no-lowercase          密码中不允许使用小写字母。
- -U, --no-uppercase          密码中不允许使用大写字母。
-
-信息命令：
- -h, --help                  显示帮助屏幕。
- -v, --version               显示版本号。
-```
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## 🏛️ MIT 许可证
-
-**版权所有 © 2024 [刘展鹏 (Adam Lui)](https://github.com/adamlui)**
-
-特此免费向任何获得副本的人授予许可本软件和相关文档文件（『软件』），处理在软件中不受限制，包括但不限于权利使用、复制、修改、合并、发布、分发、再许可和/或出售该软件的副本，并允许该软件是提供这样做，但须满足以下条件：
-
-上述版权声明和本许可声明应包含在所有软件的副本或重要部分。
-
-本软件『按原样』提供，不提供任何形式的明示或保证暗示的，包括但不限于适销性保证，适用于特定目的和非侵权。 在任何情况下都不得作者或版权持有人对任何索赔、损害或其他责任，无论是在合同、侵权或其他方面的行为中，由以下原因引起，出于或与软件或使用或其他交易有关软件。
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-<a href="https://github.com/adamlui/js-utils">**家**</a> /
-<a href="https://github.com/adamlui/js-utils/discussions">讨论</a> /
-<a href="#-generate-pw">回到顶部 ↑</a>

package/docs/zh-cn/SECURITY.md

@@ -1,17 +0,0 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;简体中文 |
-        <a href="../SECURITY.md">English</a> |
-        <a href="../zh-tw/SECURITY.md">繁體中文</a>
-    </h6>
-</div>
-
-# 🛡️ 安全政策
-
-如果您发现漏洞，请打开[安全公告草案](https://github.com/adamlui/js-utils/security/advisories/new)。
-
-也欢迎拉取请求，但出于安全原因，请发送电子邮件至 <adam@kudoai.com> 并等待回复后再公开。

package/docs/zh-tw/LICENSE.md

@@ -1,21 +0,0 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;繁體中文 |
-        <a href="../LICENSE.md">English</a> |
-        <a href="../zh-cn/LICENSE.md">简体中文</a>
-    </h6>
-</div>
-
-# 🏛️ MIT 许可证
-
-**版權所有 © 2024 [刘展鹏 (Adam Lui)](https://github.com/adamlui)**
-
-特此免費授予任何取得副本的人許可本軟體和相關文件文件（『軟體』），處理在軟體中不受限制，包括但不限於權利使用、複製、修改、合併、發布、分發、再授權和/或出售該軟體的副本，並允許該軟體是提供這樣做，但須滿足以下條件：
-
-上述版權聲明和本許可聲明應包含在所有軟體的副本或重要部分。
-
-本軟體『依現況』提供，不提供任何形式的明示或保證暗示的，包括但不限於適銷性保證，適用於特定目的和非侵權。 在任何情況下都不得作者或版權持有人對任何索賠、損害或其他責任，無論是在合約、侵權或其他方面的行為中，由以下原因引起，出於或與軟體或使用或其他交易有關軟體。

package/docs/zh-tw/README.md

@@ -1,214 +0,0 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;繁體中文 |
-        <a href="../..#readme">English</a> |
-        <a href="../zh-cn#readme">简体中文</a>
-    </h6>
-</div>
-
-# > generate-pw
-
-### 隨機產生加密安全密碼。
-
-<a href="#%EF%B8%8F-mit-%E8%AE%B8%E5%8F%AF%E8%AF%81"><img height=31 src="https://img.shields.io/badge/許可證-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://www.npmjs.com/package/generate-pw?activeTab=versions"><img height=31 src="https://img.shields.io/badge/最新版本-1.2.0-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a href="https://www.npmjs.com/package/generate-pw?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-pw?label=%E6%8B%86%E5%B0%81%E5%B0%BA%E5%AF%B8&style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
-<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-pw/generate-pw.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-pw%2Fgenerate-pw.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=%E6%BC%8F%E6%B4%9E&color=gold"></a>
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## ⚡ 安裝
-
-作為**全域實用程式**：
-
-```
-$ npm install -g generate-pw
-```
-
-作為 **運行時依賴項**，從專案根目錄：
-
-```
-$ npm install generate-pw
-```
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## 🔌 API 使用
-
-**generate-pw** 可以作為 ECMAScript 模組或 CommonJS 模組匯入到您的應用程式中。
-
-#### ESM:
-
-```js
-import * as pw from 'generate-pw';
-```
-
-#### CJS:
-
-```js
-const pw = require('generate-pw');
-```
-
-#
-
-### `generatePassword([options])`
-
-如果未給予 `qty` 選項，則產生**一個**密碼，並傳回字串：
-
-```js
-const password = pw.generatePassword({ length: 11, numbers: true });
-console.log(password);
-// 範例輸出：'bAsZm3mq6Qn'
-```
-
-...或 **多個** 密碼（如果給了 `qty` 選項），傳回一個字串陣列：
-
-```js
-const passwords = pw.generatePassword({ qty: 5, length: 8, symbols: true });
-console.log(passwords);
-// 範例輸出：[ '!zSf@Q.s', '!,HT\\;m=', '?Lq&FV>^', 'gf}Y;}Ne', 'Stsx(GqE' ]
-```
-
-**💡注意：**如果不傳遞任何選項，密碼將為 8 個字元長，由大小寫字母組成。
-
-請參閱：[可用選項](#available-options-for-generate-functions)
-
-#
-
-### `generatePasswords(qty[, options])`
-
-根據給定的 `qty` 產生**多個**密碼，傳回字串陣列：
-
-```js
-const passwords = pw.generatePasswords(5, { length: 3, uppercase: false });
-console.log(passwords);
-// 範例輸出：[ 'yilppxru', 'ckvkyjfp', 'zolcpyfb' ]
-```
-
-**💡 注意：** 如果沒有傳遞 `qty` 參數，則只會產生一個密碼，並以字串形式傳回。
-
-請參閱：[可用選項](#available-options-for-generate-functions)
-
-#
-
-### `strictify(password[, requiredCharTypes])`
-
-修改指定的 `password`，以使用傳遞的每個 `requiredCharTypes` 元素中的至少一個字符，傳回一個字串。
-
-```js
-const password = 'abcdef',
-      strictPW = pw.strictify(password, ['numbers', 'symbols']);
-
-console.log(strictPW);
-// 範例輸出：'a!c2eR'
-```
-
-可用的 `requiredCharTypes` 有：`['number', 'symbol', 'lower', 'upper']`
-
-**💡注意：**如果沒有傳遞 `requiredCharTypes` 數組，則所有可用類型都將是必需的。
-
-#
-
-### `validateStrength(password)`
-
-驗證密碼的強度，傳回一個包含 `strengthScore`（滿分 100）+ `recommendations` 陣列的物件。
-
-```js
-const password = 'AawiddsE',
-      pwStrength = pw.validateStrength(password);
-
-console.log(pwStrength);
-
-/* 輸出：
-{
-  strengthScore: 60,
-  recommendations: [ 'Include at least one number.', 'Include at least one symbol.' ]
-}
-*/
-```
-
-#
-
-### `generate*()` 函數的可用選項
-
-其中任何一個都可以傳遞到每個 `generate*()` 函數的選項物件中：
-
-姓名        | 類型   | 描述                                     | 預設值
-------------|--------|-----------------------------------------|---------
-`length`    | 整數   | 密碼的長度。                              | `8`
-`qty`*      | 整數   | 要產生的密碼數量。                         | `1`
-`charset`   | 字串   | 密碼中包含的字元。                         | `''`
-`exclude`   | 字串   | 要從密碼中排除的字元。                     | `''`
-`numbers`   | 布林值 | 允許密碼中包含數字。                       | `false`
-`symbols`   | 布林值 | 允許密碼中包含符號。                       | `false`
-`lowercase` | 布林值 | 密碼中允許使用小寫字母。                   | `true`
-`uppercase` | 布林值 | 密碼中允許使用大寫字母。                   | `true`
-`strict`    | 布林值 | 要求密碼中每個允許的字元集中至少有一個字元。 | `false`
-
-##### _*只在 [`generatePassword([options])`](#generatepasswordoptions) 中可用，因為 [`generatePasswords(qty[, options])`](#generatepasswordsqty-options) 採用 `qty` 參數_
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## 💻 命令列使用
-
-全域安裝時，**generate-pw** 也可以從命令列使用。 基本指令是：
-
-```
-$ generate-pw
-```
-
-**💡 注意：** 若要產生多個結果，請傳遞 `--qty=n`，其中 `n` 是要產生的密碼數量。
-
-#
-
-### 命令列選項
-
-```
-參數選項：
- --length=n                  產生 n 長度的密碼。
- --qty=n                     產生 n 個密碼。
- --charset=chars             密碼中僅包含 chars。
- --exclude=chars             從密碼中排除 chars。
-
-布林選項：
- -n, --include-numbers       允許密碼中包含數字。
- -s, --include-symbols       允許密碼中包含符號。
- -L, --no-lowercase          密碼中不允許使用小寫字母。
- -U, --no-uppercase          密碼中不允許使用大寫字母。
-
-訊息命令：
- -h, --help                  顯示幫助畫面。
- -v, --version               顯示版本號。
-```
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-## 🏛️ MIT 许可证
-
-**版權所有 © 2024 [刘展鹏 (Adam Lui)](https://github.com/adamlui)**
-
-特此免費授予任何取得副本的人許可本軟體和相關文件文件（『軟體』），處理在軟體中不受限制，包括但不限於權利使用、複製、修改、合併、發布、分發、再授權和/或出售該軟體的副本，並允許該軟體是提供這樣做，但須滿足以下條件：
-
-上述版權聲明和本許可聲明應包含在所有軟體的副本或重要部分。
-
-本軟體『依現況』提供，不提供任何形式的明示或保證暗示的，包括但不限於適銷性保證，適用於特定目的和非侵權。 在任何情況下都不得作者或版權持有人對任何索賠、損害或其他責任，無論是在合約、侵權或其他方面的行為中，由以下原因引起，出於或與軟體或使用或其他交易有關軟體。
-
-<br>
-
-<img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
-
-<a href="https://github.com/adamlui/js-utils">**家**</a> /
-<a href="https://github.com/adamlui/js-utils/discussions">討論</a> /
-<a href="#-generate-pw">回到頂部 ↑</a>

package/docs/zh-tw/SECURITY.md

@@ -1,17 +0,0 @@
-<div align="right">
-    <h6>
-        <picture>
-            <source type="image/svg+xml" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/white/icon32.svg">
-            <img height=14 src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/earth-icon/black/icon32.svg">
-        </picture>
-        &nbsp;繁體中文 |
-        <a href="../SECURITY.md">English</a> |
-        <a href="../zh-cn/SECURITY.md">简体中文</a>
-    </h6>
-</div>
-
-# 🛡️ 安全策略
-
-如果您發現漏洞，請打開[安全公告草案](https://github.com/adamlui/js-utils/security/advisories/new)。
-
-也歡迎拉取請求，但出於安全原因，請發送電子郵件至 <adam@kudoai.com> 並等待回復後再公開。

package/generate-pw.js

@@ -1,270 +0,0 @@
-#!/usr/bin/env node
-
-// Import crypto.randomInt() for secure RNG
-const { randomInt } = require('crypto');
-
-// Init CHARACTER SETS
-const charsets = {
-    lower: 'abcdefghijklmnopqrstuvwxyz',
-    upper: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ',
-    numbers: '0123456789',
-    symbols: '!@#$%^&*()-_=+[]{}/\\|;:\'",.<>?'
-};
-
-// Define MAIN functions
-
-function generatePassword(options = {}) { 
-
-    // Init options
-    const defaultOptions = {
-        length: 8,       // length of password
-        qty: 1,          // number of passwords to generate
-        charset: '',     // characters to include
-        exclude: '',     // characters to exclude
-        numbers: false,  // include numberChars
-        symbols: false,  // include symbolChars
-        lowercase: true, // include lowercase letters
-        uppercase: true, // include uppercase letters
-        strict: false    // require at least one char from each enabled set
-    };
-    options = { ...defaultOptions, ...options };
-
-    // Validate integer args
-    for (const numArgType of ['length', 'qty'])
-        if (isNaN(options[numArgType]) || options[numArgType] < 1)
-            return console.error(
-                `ERROR: [${ numArgType }] argument must be 1 or greater.`);
-
-    if (options.qty > 1) { // return array of [qty] password strings
-        const { qty, ...otherOptions } = options;
-        return generatePasswords(qty, otherOptions);
-
-    } else { // return single password string
-
-        // Init password's char set
-        let pwCharset = options.charset || ( // use passed [charset], or construct from options
-            (options.numbers ? charsets.numbers : '')
-              + (options.symbols ? charsets.symbols : '')
-              + (options.lowercase ? charsets.lower : '') 
-              + (options.uppercase ? charsets.upper : '')
-        );
-        if (pwCharset === '') // all flags false + no charset passed
-            pwCharset = charsets.lower + charsets.upper; // default to upper + lower
-
-        // Exclude passed `exclude` chars
-        pwCharset = pwCharset.replace(new RegExp(`[${ options.exclude }]`, 'g'), '');
-
-        // Generate unstrict password
-        let password = '';
-        for (let i = 0; i < options.length; i++) {
-            const randomIndex = randomInt(0, pwCharset.length);
-            password += pwCharset.charAt(randomIndex);
-        }
-
-        // Enforce strict mode if enabled
-        if (options.strict) {
-            const charTypes = ['number', 'symbol', 'lower', 'upper'],
-                  requiredCharTypes = charTypes.filter(charType => options[charType + 's'] || options[charType + 'case']);
-            password = strictify(password, requiredCharTypes);
-        }
-
-        return password;
-    }
-}
-
-function generatePasswords(qty, options) {
-    qty = parseInt(qty);
-    if (isNaN(qty)) return console.error(
-        'ERROR: First argument [qty] of generatePasswords() must be an integer');
-    const passwords = [];
-    for (let i = 0; i < qty; i++) passwords.push(generatePassword(options));
-    return passwords;
-}
-
-function strictify(password, requiredCharTypes = ['number', 'symbol', 'lower', 'upper']) {
-
-    // Init flags
-    for (const charType of requiredCharTypes)
-        global['has' + charType.charAt(0).toUpperCase() + charType.slice(1)] = false;
-    for (let i = 0; i < password.length; i++)
-        for (const charType of requiredCharTypes)
-            if ((charsets[charType] || charsets[charType + 's']).includes(password.charAt(i)))
-                global['has' + charType.charAt(0).toUpperCase() + charType.slice(1)] = true;
-
-    // Modify password if necessary
-    const maxReplacements = Math.min(password.length, requiredCharTypes.length),
-          replacedPositions = []; let replacementCnt = 0;
-    for (const charType of requiredCharTypes) {
-        if (replacementCnt < maxReplacements) {
-            if (!global['has' + charType.charAt(0).toUpperCase() + charType.slice(1)]) {
-                let replacementPos;
-                do replacementPos = randomInt(0, password.length); // pick random pos
-                while (replacedPositions.includes(replacementPos)); // check if pos already replaced
-                replacedPositions.push(replacementPos); // track new replacement pos
-                const replacementCharSet = charsets[charType] || charsets[charType + 's'];
-                password = password.substring(0, replacementPos) // perform actual replacement
-                         + replacementCharSet.charAt(randomInt(0, replacementCharSet.length))
-                         + password.substring(replacementPos + 1);
-                replacementCnt++;
-    }}}
-
-    return password;
-}
-
-function validateStrength(password) {
-    const strengthCriteria = { minLength: 8, minLower: 1, minUpper: 1, minNumber: 1, minSymbol: 1 };
-
-    // Count occurrences of each char type
-    const charCnts = { 'lower': 0, 'upper': 0, 'number': 0, 'symbol': 0 };
-    for (let i = 0; i < password.length; i++) {
-        const char = password[i];
-        for (const charType of Object.keys(charCnts))
-            if ((charsets[charType] || charsets[charType + 's']).includes(char))
-                charCnts[charType]++;
-    }
-
-    // Check criteria + add recommendations
-    const recommendations = [];
-    if (password.length < strengthCriteria.minLength)
-        recommendations.push(`Make it at least ${ strengthCriteria.minLength } characters long.`);
-    for (const charType of Object.keys(charCnts))
-        if (charCnts[charType] < strengthCriteria['min' + charType.charAt(0).toUpperCase() + charType.slice(1)])
-            recommendations.push('Include at least one ' + charType
-                + `${ ['upper', 'lower'].includes(charType) ? 'case letter' : '' }.`);
-
-    // Calculate strength score based on counts and criteria
-    let strengthScore = 0;
-    strengthScore += ( // +20 for satisfying min length
-        password.length >= strengthCriteria.minLength) ? 20 : 0;
-    for (const charType of Object.keys(charCnts))
-        strengthScore += ( // +20 per char type included
-            charCnts[charType] >= strengthCriteria['min' + charType.charAt(0).toUpperCase() + charType.slice(1)]) ? 20 : 0;
-
-    return { strengthScore, recommendations };
-}
-
-// EXPORT functions if script was required
-if (require.main !== module) module.exports = { generatePassword, generatePasswords, strictify, validateStrength };
-
-else { // run as CLI tool
-
-    // Init UI colors
-    const nc = '\x1b[0m',    // no color
-          br = '\x1b[1;91m', // bright red
-          by = '\x1b[1;33m', // bright yellow
-          bw = '\x1b[1;97m'; // bright white
-
-    // Load settings from ARGS
-    const config = {};
-    const argRegex = {
-        paramOptions: {
-            'length': /^--?length/,
-            'qty': /^--?qu?a?n?ti?t?y=\d+$/,
-            'charset': /^--?chars/,
-            'excludeChars': /^--?exclude=/
-        },
-        flags: {
-            'includeNums': /^--?(?:n|(?:include-?)?num(?:ber)?s?=?(?:true|1)?)$/,
-            'includeSymbols': /^--?(?:s|(?:include-?)?symbols?=?(?:true|1)?)$/,
-            'excludeLowerChars': /^--?(?:L|(?:exclude|disable|no)-?lower-?(?:case)?|lower-?(?:case)?=(?:false|0))$/,
-            'excludeUpperChars': /^--?(?:U|(?:exclude|disable|no)-?upper-?(?:case)?|upper-?(?:case)?=(?:false|0))$/,
-            'strictMode': /^--?s(?:trict)?(?:-?mode)?$/
-        },
-        cmds: {
-            'help': /^--?h(?:elp)?$/,
-            'version': /^--?ve?r?s?i?o?n?$/
-        }
-    };
-    process.argv.forEach(arg => {
-        if (!arg.startsWith('-')) return;
-        const matchedFlag = Object.keys(argRegex.flags).find(flag => argRegex.flags[flag].test(arg)),
-              matchedArgOption = Object.keys(argRegex.paramOptions).find(option => argRegex.paramOptions[option].test(arg)),
-              matchedCmd = Object.keys(argRegex.cmds).find(cmd => argRegex.cmds[cmd].test(arg));
-        if (matchedFlag) config[matchedFlag] = true;
-        else if (matchedArgOption) {
-            const value = arg.split('=')[1];
-            config[matchedArgOption] = parseInt(value) || value;
-        } else if (!matchedCmd) {
-            console.error(`\n${br}ERROR: Arg [${ arg }] not recognized.${nc}`);
-            console.info(`\n${by}Valid arguments are below.${nc}`);
-            printHelpScreen(['paramOptions', 'booelanOptions', 'infoCmds']);
-            process.exit(1);
-    }});
-
-    // Show HELP screen if -h or --help passed
-    if (process.argv.some(arg => /^--?h(?:elp)?$/.test(arg))) printHelpScreen();
-
-    // Show VERSION number if -v or --version passed
-    else if (process.argv.some(arg => /^--?ve?r?s?i?o?n?$/.test(arg)))
-        console.info('v' + require('./package.json').version);
-
-    else { // run MAIN routine
-        for (const numArgType of ['length', 'qty'])
-            if (config[numArgType] && (isNaN(config[numArgType]) || config[numArgType] < 1))
-                return console.error(`\n${br}Error: [${ numArgType }] argument must be 1 or greater.${nc}`);
-        const funcOptions = {
-            length: config.length || 8, qty: config.qty || 1,
-            charset: config.charset, exclude: config.excludeChars,
-            numbers: config.includeNums, symbols: config.includeSymbols,
-            lowercase: !config.excludeLowerChars, uppercase: !config.excludeUpperChars,
-            strict: config.strictMode
-        };
-        const pwResult = generatePassword(funcOptions);
-        console.log('\n' + bw + ( Array.isArray(pwResult) ? pwResult.join('\n') : pwResult ) + nc);
-    }
-
-    // Define LOGGING functions
-
-    function printHelpMsg(msg) { // wrap msg + indent 2nd+ lines (for --help screen)
-        const terminalWidth = process.stdout.columns || 80,
-              indentation = 29, lines = [], words = msg.match(/\S+|\s+/g);
-
-        // Split msg into lines of appropriate lengths
-        let currentLine = '';
-        words.forEach(word => {
-            const lineLength = terminalWidth - ( lines.length === 0 ? 0 : indentation );
-            if (currentLine.length + word.length > lineLength) { // cap/store it
-                lines.push(lines.length === 0 ? currentLine : currentLine.trimStart());
-                currentLine = '';
-            }
-            currentLine += word;
-        });
-        lines.push(lines.length === 0 ? currentLine : currentLine.trimStart());
-
-        // Print formatted msg
-        lines.forEach((line, index) => console.info(
-            index === 0 ? line // print 1st line unindented
-                : ' '.repeat(indentation) + line // print subsequent lines indented
-        ));
-    }
-
-    function printHelpScreen(includeSections = ['cmdFormat', 'paramOptions', 'booelanOptions', 'infoCmds']) {
-        const sections = {
-            'cmdFormat': [
-                `\n${by}generate-pw [options|commands]${nc}`
-            ],
-            'paramOptions': [
-                '\nParameter options:',
-                ' --length=n                  Generate password(s) of n length.',
-                ' --qty=n                     Generate n password(s).',
-                ' --charset=chars             Only include chars in password(s).',
-                ' --charset=chars             Only include chars in password(s).',
-                ' --exclude=chars             Exclude chars from password(s).'
-            ],
-            'booelanOptions': [
-                '\nBoolean options:',
-                ' -n, --include-numbers       Allow numbers in password(s).',
-                ' -s, --include-symbols       Allow symbols in password(s).',
-                ' -L, --no-lowercase          Disallow lowercase letters in password(s).',
-                ' -U, --no-uppercase          Disallow uppercase letters in password(s).'
-            ],
-            'infoCmds': [
-                '\nInfo commands:',
-                ' -h, --help                  Display help screen.',
-                ' -v, --version               Show version number.'
-            ]
-        };
-        includeSections.forEach(section => { // print valid arg elems
-            if (sections[section]) sections[section].forEach(line => printHelpMsg(line)); });
-    }
-}