tuijs-util 1.4.11 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tuijs-util",
-    "version": "1.4.11",
+    "version": "1.5.0",
     "module": "src/esm/index.js",
     "main": "src/cjs/index.cjs",
     "exports": {

package/src/cjs/index.cjs

@@ -3,17 +3,23 @@
 /**
  * List of RegEx variables for different patterns.
 */
-const regExLetters = /^[a-zA-Z]+$/;
-const regExLettersLower = /^[a-z]+$/;
-const regExLettersUpper = /^[A-Z]+$/;
-const regExNumbers = /^\d+$/;
-const regExBin = /^[01]+$/; // Matches entire string for binary characters
+const regExAllLetters = /^[a-zA-Z]+$/;
+const regExAnyLetter = /[a-zA-Z]/; // Matches if string contains any letter
+const regExAllLowercase = /^[a-z]+$/;
+const regExAnyLowercase = /[a-z]/; // Matches if string contains any lowercase letter
+const regExAllUppercase = /^[A-Z]+$/;
+const regExAnyUppercase = /[A-Z]/; // Matches if string contains any uppercase letter
+const regExAllNumbers = /^\d+$/;
+const regExAnyNumber = /\d/; // Matches if string contains any number
+const regExAllBin = /^[01]+$/; // Matches entire string for binary characters
+const regExAnyBin = /[01]/; // Matches if string contains any binary character
 const regExBinChar = /[01]/g; // Matches individual binary characters.
 const regExBinNon = /[^01]/g; // Matches characters not in the binary range
-const regExHex = /^[0-9A-Fa-f]+$/; // Matches entire string for hexadecimal characters
+const regExAllHex = /^[0-9A-Fa-f]+$/; // Matches entire string for hexadecimal characters
+const regExAnyHex = /[0-9A-Fa-f]/; // Matches if string contains any hexadecimal character
 const regExHexChar = /[0-9A-Fa-f]/g; // Matches individual hexadecimal characters.
 const regExHexNon = /[^0-9A-Fa-f]/g; // Matches characters not in the hexadecimal range
-const regExSpecial = /^[\!\@\#\$\%\^\&\*\(\)\_\+\-\=\[\]\{\}\|\;\:\'\"\,\.\<\>\/\?\`\\\~]+$/;
+const regExAnySpecial = /[\!\@\#\$\%\^\&\*\(\)\_\+\-\=\[\]\{\}\|\;\:\'\"\,\.\<\>\/\?\`\\\~]/;
 const regExFqdn = /^(?=.{1,253}$)(([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+([a-zA-Z]{2,}|[a-zA-Z0-9-]{2,}))$/;
 const regExUrl = new RegExp('^(https?:\\/\\/)?' +
 // protocol
@@ -144,16 +150,16 @@ function checkIpv6(string) {
 /**
  * Checks for special characters (Uses RegEx).
  * @param {string} string 
- * @returns {boolean} - Returns true if a special character is found and false if the string is not validated or the RegEx test fails.
+ * @returns {boolean} - Returns true if any special character is found and false if the string is not validated or the RegEx test fails.
  * @throws {Error} - Throws error message if error occurs.
  */
-function checkSpecialChar(string) {
+function checkAnySpecialChar(string) {
   try {
     if (typeof string !== 'string' || string.length === 0) {
       return false;
     }
     ;
-    return regExSpecial.test(string);
+    return regExAnySpecial.test(string);
   } catch (er) {
     console.error(er);
   }
@@ -165,13 +171,13 @@ function checkSpecialChar(string) {
  * @returns {boolean} - Returns true if a number is found and false if not.
  * @throws {Error} - Throws error message if error occurs.
  */
-function checkNum(string) {
+function checkAnyNum(string) {
   try {
     if (typeof string !== 'string' || string.length === 0) {
       return false;
     }
     ;
-    return regExNumbers.test(string);
+    return regExAnyNumber.test(string);
   } catch (er) {
     console.error(er);
   }
@@ -183,13 +189,13 @@ function checkNum(string) {
  * @returns {boolean} - Returns true if a lowercase character is found and false if not.
  * @throws {Error} - Throws error message if error occurs.
  */
-function checkLowercase(string) {
+function checkAnyLowercase(string) {
   try {
     if (typeof string !== 'string' || string.length === 0) {
       return false;
     }
     ;
-    return regExLettersLower.test(string);
+    return regExAnyLowercase.test(string);
   } catch (er) {
     console.error(er);
   }
@@ -201,49 +207,49 @@ function checkLowercase(string) {
  * @returns {boolean} - Returns true if a uppercase character is found and false if not.
  * @throws {Error} - Throws error message if error occurs.
  */
-function checkUppercase(string) {
+function checkAnyUppercase(string) {
   try {
     if (typeof string !== 'string' || string.length === 0) {
       return false;
     }
     ;
-    return regExLettersUpper.test(string);
+    return regExAnyUppercase.test(string);
   } catch (er) {
     console.error(er);
   }
 }
 
 /**
- * Checks for a valid email address. (Uses RegEx).
+ * Checks for a space in a string
  * @param {string} string 
- * @returns {boolean} - Returns true if email pattern test is successful and false if the string is not validated or the RegEx test fails.
+ * @returns {boolean} - Returns true if space is found and false if the string is not validated or if a space is not found.
  * @throws {Error} - Throws error message if error occurs.
  */
-function checkEmail(string) {
+function checkAnySpaces(string) {
   try {
     if (typeof string !== 'string' || string.length === 0) {
       return false;
     }
     ;
-    return regExEmail.test(string);
+    return string.indexOf(' ') >= 0;
   } catch (er) {
     console.error(er);
   }
 }
 
 /**
- * Checks for a space in a string
+ * Checks for a valid email address. (Uses RegEx).
  * @param {string} string 
- * @returns {boolean} - Returns true if space is found and false if the string is not validated or if a space is not found.
+ * @returns {boolean} - Returns true if email pattern test is successful and false if the string is not validated or the RegEx test fails.
  * @throws {Error} - Throws error message if error occurs.
  */
-function checkSpaces(string) {
+function checkEmail(string) {
   try {
     if (typeof string !== 'string' || string.length === 0) {
       return false;
     }
     ;
-    return string.indexOf(' ') >= 0;
+    return regExEmail.test(string);
   } catch (er) {
     console.error(er);
   }
@@ -1108,6 +1114,11 @@ function parseFunctionString(string) {
 }
 
 exports.addLeadZero = addLeadZero;
+exports.checkAnyLowercase = checkAnyLowercase;
+exports.checkAnyNum = checkAnyNum;
+exports.checkAnySpaces = checkAnySpaces;
+exports.checkAnySpecialChar = checkAnySpecialChar;
+exports.checkAnyUppercase = checkAnyUppercase;
 exports.checkEmail = checkEmail;
 exports.checkFqdn = checkFqdn;
 exports.checkIp = checkIp;
@@ -1118,13 +1129,8 @@ exports.checkIsElement = checkIsElement;
 exports.checkIsFunction = checkIsFunction;
 exports.checkIsJson = checkIsJson;
 exports.checkIsObject = checkIsObject;
-exports.checkLowercase = checkLowercase;
 exports.checkMac = checkMac;
-exports.checkNum = checkNum;
-exports.checkSpaces = checkSpaces;
-exports.checkSpecialChar = checkSpecialChar;
 exports.checkSubnetMask = checkSubnetMask;
-exports.checkUppercase = checkUppercase;
 exports.checkUrl = checkUrl;
 exports.convertBitsToMask = convertBitsToMask;
 exports.convertMaskToBits = convertMaskToBits;
@@ -1142,19 +1148,27 @@ exports.listUpChar = listUpChar;
 exports.parseFunctionString = parseFunctionString;
 exports.parseTemplate = parseTemplate;
 exports.preloadImages = preloadImages;
-exports.regExBin = regExBin;
+exports.regExAllBin = regExAllBin;
+exports.regExAllHex = regExAllHex;
+exports.regExAllLetters = regExAllLetters;
+exports.regExAllLowercase = regExAllLowercase;
+exports.regExAllNumbers = regExAllNumbers;
+exports.regExAllUppercase = regExAllUppercase;
+exports.regExAnyBin = regExAnyBin;
+exports.regExAnyHex = regExAnyHex;
+exports.regExAnyLetter = regExAnyLetter;
+exports.regExAnyLowercase = regExAnyLowercase;
+exports.regExAnyNumber = regExAnyNumber;
+exports.regExAnySpecial = regExAnySpecial;
+exports.regExAnyUppercase = regExAnyUppercase;
 exports.regExBinChar = regExBinChar;
 exports.regExBinNon = regExBinNon;
 exports.regExEmail = regExEmail;
 exports.regExFqdn = regExFqdn;
-exports.regExHex = regExHex;
 exports.regExHexChar = regExHexChar;
 exports.regExHexNon = regExHexNon;
 exports.regExIpv4 = regExIpv4;
 exports.regExIpv6 = regExIpv6;
-exports.regExLetters = regExLetters;
-exports.regExLettersLower = regExLettersLower;
-exports.regExLettersUpper = regExLettersUpper;
 exports.regExMacColonPairs = regExMacColonPairs;
 exports.regExMacColonQuads = regExMacColonQuads;
 exports.regExMacDotPairs = regExMacDotPairs;
@@ -1162,8 +1176,6 @@ exports.regExMacDotQuads = regExMacDotQuads;
 exports.regExMacHyphenPairs = regExMacHyphenPairs;
 exports.regExMacHyphenQuads = regExMacHyphenQuads;
 exports.regExMacNoSeparator = regExMacNoSeparator;
-exports.regExNumbers = regExNumbers;
-exports.regExSpecial = regExSpecial;
 exports.regExUrl = regExUrl;
 exports.removeChar = removeChar;
 exports.reqGet = reqGet;

package/src/esm/index.js

@@ -1,4 +1,9 @@
 export {
+    checkAnyLowercase,
+    checkAnyNum,
+    checkAnySpaces,
+    checkAnySpecialChar,
+    checkAnyUppercase,
     checkEmail,
     checkFqdn,
     checkIp,
@@ -9,21 +14,16 @@ export {
     checkIsFunction,
     checkIsJson,
     checkIsObject,
-    checkLowercase,
     checkMac,
-    checkNum,
-    checkSpaces,
-    checkSpecialChar,
     checkSubnetMask,
-    checkUppercase,
     checkUrl
-} from './lib/util.check.js';
+} from './lib/_check.js';
 export {
     elmCleaner,
     elmCleanerArray,
     elmCleanerTr,
-    parseTemplate,
-} from './lib/util.dom.js';
+    parseTemplate
+} from './lib/_dom.js';
 export {
     createReqInstance,
     reqGet,
@@ -33,7 +33,7 @@ export {
     reqPostJson,
     urlAddHttp,
     urlAddHttps
-} from './lib/util.http.js';
+} from './lib/_http.js';
 export {
     listHtmlTags,
     listLowChar,
@@ -41,7 +41,7 @@ export {
     listSpecChar,
     listSubnets,
     listUpChar
-} from './lib/util.lists.js';
+} from './lib/_lists.js';
 export {
     addLeadZero,
     convertBitsToMask,
@@ -50,24 +50,32 @@ export {
     preloadImages,
     scrollIntoView,
     sleep
-} from './lib/util.misc.js';
+} from './lib/_misc.js';
 export {
     parseFunctionString
-} from './lib/util.parse.js';
+} from './lib/_parse.js';
 export {
-    regExBin,
+    regExAllBin,
+    regExAllHex,
+    regExAllLetters,
+    regExAllLowercase,
+    regExAllNumbers,
+    regExAllUppercase,
+    regExAnyBin,
+    regExAnyHex,
+    regExAnyLetter,
+    regExAnyLowercase,
+    regExAnyNumber,
+    regExAnySpecial,
+    regExAnyUppercase,
     regExBinChar,
     regExBinNon,
     regExEmail,
     regExFqdn,
-    regExHex,
     regExHexChar,
     regExHexNon,
     regExIpv4,
     regExIpv6,
-    regExLetters,
-    regExLettersLower,
-    regExLettersUpper,
     regExMacColonPairs,
     regExMacColonQuads,
     regExMacDotPairs,
@@ -75,9 +83,6 @@ export {
     regExMacHyphenPairs,
     regExMacHyphenQuads,
     regExMacNoSeparator,
-    regExNumbers,
-    regExSpecial,
     regExUrl,
     removeChar
-} from './lib/util.regex.js';
-
+} from './lib/_regex.js';

package/src/esm/lib/{util.check.js → _check.js}

@@ -1,8 +1,8 @@
 import {
-    regExNumbers,
-    regExLettersLower,
-    regExLettersUpper,
-    regExSpecial,
+    regExAnyNumber,
+    regExAnyLowercase,
+    regExAnyUppercase,
+    regExAnySpecial,
     regExFqdn,
     regExUrl,
     regExEmail,
@@ -15,7 +15,7 @@ import {
     regExMacHyphenQuads,
     regExMacDotPairs,
     regExMacDotQuads
-} from "./util.regex.js";
+} from "./_regex.js";
 
 /**
  * Checks for a valid FQDN (Uses RegEx).
@@ -111,15 +111,15 @@ export function checkIpv6(string) {
 /**
  * Checks for special characters (Uses RegEx).
  * @param {string} string 
- * @returns {boolean} - Returns true if a special character is found and false if the string is not validated or the RegEx test fails.
+ * @returns {boolean} - Returns true if any special character is found and false if the string is not validated or the RegEx test fails.
  * @throws {Error} - Throws error message if error occurs.
  */
-export function checkSpecialChar(string) {
+export function checkAnySpecialChar(string) {
     try {
         if (typeof string !== 'string' || string.length === 0) {
             return false;
         };
-        return regExSpecial.test(string);
+        return regExAnySpecial.test(string);
     } catch (er) {
         console.error(er);
     }
@@ -131,12 +131,12 @@ export function checkSpecialChar(string) {
  * @returns {boolean} - Returns true if a number is found and false if not.
  * @throws {Error} - Throws error message if error occurs.
  */
-export function checkNum(string) {
+export function checkAnyNum(string) {
     try {
         if (typeof string !== 'string' || string.length === 0) {
             return false;
         };
-        return regExNumbers.test(string);
+        return regExAnyNumber.test(string);
     } catch (er) {
         console.error(er);
     }
@@ -148,12 +148,12 @@ export function checkNum(string) {
  * @returns {boolean} - Returns true if a lowercase character is found and false if not.
  * @throws {Error} - Throws error message if error occurs.
  */
-export function checkLowercase(string) {
+export function checkAnyLowercase(string) {
     try {
         if (typeof string !== 'string' || string.length === 0) {
             return false;
         };
-        return regExLettersLower.test(string);
+        return regExAnyLowercase.test(string);
     } catch (er) {
         console.error(er);
     }
@@ -165,46 +165,46 @@ export function checkLowercase(string) {
  * @returns {boolean} - Returns true if a uppercase character is found and false if not.
  * @throws {Error} - Throws error message if error occurs.
  */
-export function checkUppercase(string) {
+export function checkAnyUppercase(string) {
     try {
         if (typeof string !== 'string' || string.length === 0) {
             return false;
         };
-        return regExLettersUpper.test(string);
+        return regExAnyUppercase.test(string);
     } catch (er) {
         console.error(er);
     }
 }
 
 /**
- * Checks for a valid email address. (Uses RegEx).
+ * Checks for a space in a string
  * @param {string} string 
- * @returns {boolean} - Returns true if email pattern test is successful and false if the string is not validated or the RegEx test fails.
+ * @returns {boolean} - Returns true if space is found and false if the string is not validated or if a space is not found.
  * @throws {Error} - Throws error message if error occurs.
  */
-export function checkEmail(string) {
+export function checkAnySpaces(string) {
     try {
         if (typeof string !== 'string' || string.length === 0) {
             return false;
         };
-        return regExEmail.test(string);
+        return string.indexOf(' ') >= 0;
     } catch (er) {
         console.error(er);
     }
 }
 
 /**
- * Checks for a space in a string
+ * Checks for a valid email address. (Uses RegEx).
  * @param {string} string 
- * @returns {boolean} - Returns true if space is found and false if the string is not validated or if a space is not found.
+ * @returns {boolean} - Returns true if email pattern test is successful and false if the string is not validated or the RegEx test fails.
  * @throws {Error} - Throws error message if error occurs.
  */
-export function checkSpaces(string) {
+export function checkEmail(string) {
     try {
         if (typeof string !== 'string' || string.length === 0) {
             return false;
         };
-        return string.indexOf(' ') >= 0;
+        return regExEmail.test(string);
     } catch (er) {
         console.error(er);
     }

package/src/esm/lib/{util.http.js → _http.js}

@@ -1,4 +1,4 @@
-import { checkUrl, checkIsJson } from './util.check.js';
+import { checkUrl } from './_check.js';
 
 /**
  * Adds 'http://' if valid URL and 'http://' or 'https://' is missing.

package/src/esm/lib/{util.misc.js → _misc.js}

@@ -1,4 +1,4 @@
-import { checkSubnetMask } from "./util.check.js";
+import { checkSubnetMask } from "./_check.js";
 
 /**
  * Adds zero in front of numbers less than 10 and returns as a string.

package/src/esm/lib/{util.regex.js → _regex.js}

@@ -1,14 +1,20 @@
 /**
  * List of RegEx variables for different patterns.
 */
-export const regExLetters = /^[a-zA-Z]+$/;
-export const regExLettersLower = /^[a-z]+$/;
-export const regExLettersUpper = /^[A-Z]+$/;
-export const regExNumbers = /^\d+$/;
-export const regExBin = /^[01]+$/; // Matches entire string for binary characters
+export const regExAllLetters = /^[a-zA-Z]+$/;
+export const regExAnyLetter = /[a-zA-Z]/; // Matches if string contains any letter
+export const regExAllLowercase = /^[a-z]+$/;
+export const regExAnyLowercase = /[a-z]/; // Matches if string contains any lowercase letter
+export const regExAllUppercase = /^[A-Z]+$/;
+export const regExAnyUppercase = /[A-Z]/; // Matches if string contains any uppercase letter
+export const regExAllNumbers = /^\d+$/;
+export const regExAnyNumber = /\d/; // Matches if string contains any number
+export const regExAllBin = /^[01]+$/; // Matches entire string for binary characters
+export const regExAnyBin = /[01]/; // Matches if string contains any binary character
 export const regExBinChar = /[01]/g; // Matches individual binary characters.
 export const regExBinNon = /[^01]/g; // Matches characters not in the binary range
-export const regExHex = /^[0-9A-Fa-f]+$/; // Matches entire string for hexadecimal characters
+export const regExAllHex = /^[0-9A-Fa-f]+$/; // Matches entire string for hexadecimal characters
+export const regExAnyHex = /[0-9A-Fa-f]/; // Matches if string contains any hexadecimal character
 export const regExHexChar = /[0-9A-Fa-f]/g // Matches individual hexadecimal characters.
 export const regExHexNon = /[^0-9A-Fa-f]/g; // Matches characters not in the hexadecimal range
 export const regExAnySpecial = /[\!\@\#\$\%\^\&\*\(\)\_\+\-\=\[\]\{\}\|\;\:\'\"\,\.\<\>\/\?\`\\\~]/;