@putkoff/abstract-utilities 0.1.224 → 0.1.225

package/dist/cjs/index.js

@@ -1066,22 +1066,55 @@ function ensure_list(obj) {
     const objArray = Array.isArray(obj) ? obj : [obj];
     return objArray;
 }
-function assureString(obj) {
-    return String(obj);
+// coerce any single value into a number (0 if it can't)
+function ensure_number(x) {
+    const n = Number(x);
+    return isNaN(n) ? 0 : n;
 }
-function cleanArray(obj) {
-    obj = assureArray(obj);
-    return Array.from(new Set(obj));
-}
-function assureArray(input) {
+function ensure_array(input) {
     if (typeof input === 'string') {
         return [input];
     }
     if (Array.isArray(input)) {
-        return input.map(item => assureString(item));
+        return input.map(item => ensure_string(item));
     }
     return [];
 }
+function ensure_string(obj) {
+    return String(obj);
+}
+const assureList = ensure_list;
+const assureString = ensure_string;
+const assureNumber = ensure_number;
+const assureArray = ensure_array;
+const assure_list = ensure_list;
+const assure_string = ensure_string;
+const assure_number = ensure_number;
+const assure_array = ensure_array;
+const ensureList = ensure_list;
+const ensureString = ensure_string;
+const ensureNumber = ensure_number;
+const ensureArray = ensure_array;
+
+function cleanText(input) {
+    // Replace delimiters with spaces and split
+    const str = ensure_string(input);
+    const words = str.replace(/[_.-]/g, ' '); // Replace _, -, . with space
+    return words;
+}
+function cleanArray(obj) {
+    obj = ensure_array(obj);
+    return Array.from(new Set(obj));
+}
+function getCleanArray(obj) {
+    obj = obj.split(/\s+/) // Split on any whitespace
+        .filter((item) => typeof item === 'string' && item !== '');
+    // Get basename
+    // Remove duplicates using Set
+    const uniqueWords = cleanArray(obj);
+    return uniqueWords;
+}
+
 // Constrain T so 'in obj' is allowed
 function get_key_value(obj, key) {
     // we cast to any for the indexing, since TS can’t infer arbitrary string keys
@@ -1091,7 +1124,7 @@ function get_key_value(obj, key) {
     return null;
 }
 function get(obj, keys, defaultValue = null) {
-    const keyArray = assureArray(keys);
+    const keyArray = ensure_array(keys);
     if (!obj || keyArray.length === 0) {
         return defaultValue;
     }
@@ -1103,23 +1136,16 @@ function get(obj, keys, defaultValue = null) {
     }
     return defaultValue;
 }
-function cleanText(input) {
-    // Replace delimiters with spaces and split
-    const str = assureString(input);
-    const words = str.replace(/[_.-]/g, ' '); // Replace _, -, . with space
-    return words;
-}
-function getCleanArray(obj) {
-    obj = obj.split(/\s+/) // Split on any whitespace
-        .filter((item) => typeof item === 'string' && item !== '');
-    // Get basename
-    // Remove duplicates using Set
-    const uniqueWords = cleanArray(obj);
-    return uniqueWords;
+
+function isType(obj, type) {
+    if (typeof obj === type) {
+        return true;
+    }
+    return false;
 }
 function isStrInString(obj, string) {
-    const obj_str = assureString(obj).toLowerCase;
-    string = assureString(string).toLowerCase;
+    const obj_str = ensure_string(obj).toLowerCase;
+    string = ensure_string(string).toLowerCase;
     if (string.includes(obj_str)) {
         return true;
     }
@@ -1127,14 +1153,18 @@ function isStrInString(obj, string) {
 }
 function getChar(i, string) {
     if (string.length >= i) {
-        return assureString(string)[i];
+        return ensure_string(string)[i];
     }
 }
-function isType(obj, type) {
-    if (typeof obj === type) {
-        return true;
+function getAlphaNum(obj) {
+    const is_num = isNum(obj);
+    const alphas = getAlphas();
+    if (is_num) {
+        return getChar(obj, alphas);
+    }
+    if (isStrInString(obj, alphas)) {
+        return getChar(obj, alphas);
     }
-    return false;
 }
 function getNums() {
     return '0123456789';
@@ -1146,36 +1176,9 @@ function isNum(obj) {
     }
     return isStrInString(obj, getNums());
 }
-function ensure_number(object) {
-    if (isNum(object)) {
-        return Number(object);
-    }
-    let nuString = '';
-    const object_str = assureString(object);
-    const str_spl = object_str.split('');
-    for (const obj in str_spl) {
-        if (isNum(obj)) {
-            nuString += obj;
-        }
-    }
-    if (nuString != '') {
-        return Number(nuString);
-    }
-    return 0;
-}
 function getAlphas() {
     return 'abcdefghijklmnopqrstuvwxyz';
 }
-function getAlphaNum(obj) {
-    const is_num = isNum(obj);
-    const alphas = getAlphas();
-    if (is_num) {
-        return getChar(obj, alphas);
-    }
-    if (isStrInString(obj, alphas)) {
-        return getChar(obj, alphas);
-    }
-}
 
 function getSubstring(obj, maxLength = null, minLength = null) {
     const objLength = obj.length;
@@ -1625,6 +1628,32 @@ function get_keyword_string(keywords) {
     return allString;
 }
 
+// take N args and coerce them all to numbers
+function safeNums(...args) {
+    return args.map(ensure_number);
+}
+// divide the first value by each of the following
+function safeDivide(...args) {
+    const [head, ...rest] = safeNums(...args);
+    // if we don’t have a head or any divisor is zero, bail
+    if (head === 0 || rest.some((d) => d === 0))
+        return 0;
+    return rest.reduce((acc, d) => acc / d, head);
+}
+// multiply all the values together
+function safeMultiply(...args) {
+    const nums = safeNums(...args);
+    // if any number is zero, result is zero
+    if (nums.includes(0))
+        return 0;
+    return nums.reduce((acc, n) => acc * n, 1);
+}
+// round a value to two decimals by percent
+function roundPercentage(x) {
+    const pct = safeMultiply(ensure_number(x), 100);
+    return safeDivide(Math.round(pct), 100);
+}
+
 Object.defineProperty(exports, "useCallback", {
     enumerable: true,
     get: function () { return react.useCallback; }
@@ -1654,7 +1683,13 @@ exports.SUB_DIR = SUB_DIR;
 exports.Spinner = Spinner;
 exports.alertit = alertit;
 exports.assureArray = assureArray;
+exports.assureList = assureList;
+exports.assureNumber = assureNumber;
 exports.assureString = assureString;
+exports.assure_array = assure_array;
+exports.assure_list = assure_list;
+exports.assure_number = assure_number;
+exports.assure_string = assure_string;
 exports.callStorage = callStorage;
 exports.callWindowMethod = callWindowMethod;
 exports.capitalize = capitalize;
@@ -1670,8 +1705,14 @@ exports.eatAll = eatAll;
 exports.eatEnd = eatEnd;
 exports.eatInner = eatInner;
 exports.eatOuter = eatOuter;
+exports.ensureArray = ensureArray;
+exports.ensureList = ensureList;
+exports.ensureNumber = ensureNumber;
+exports.ensureString = ensureString;
+exports.ensure_array = ensure_array;
 exports.ensure_list = ensure_list;
 exports.ensure_number = ensure_number;
+exports.ensure_string = ensure_string;
 exports.fetchIndexHtml = fetchIndexHtml;
 exports.fetchIndexHtmlContainer = fetchIndexHtmlContainer;
 exports.fetchIt = fetchIt;
@@ -1749,7 +1790,11 @@ exports.processKeywords = processKeywords;
 exports.readJsonFile = readJsonFile;
 exports.removeToken = removeToken;
 exports.requireToken = requireToken;
+exports.roundPercentage = roundPercentage;
+exports.safeDivide = safeDivide;
 exports.safeGlobalProp = safeGlobalProp;
+exports.safeMultiply = safeMultiply;
+exports.safeNums = safeNums;
 exports.safeStorage = safeStorage;
 exports.sanitizeFilename = sanitizeFilename;
 exports.stripPrefixes = stripPrefixes;