@mikezimm/fps-core-v7 1.0.6 → 1.0.8

package/lib/logic/Arrays/manipulation.js

@@ -0,0 +1,231 @@
+/***
+ *     .d8b.  d8888b. d8888b.  .d8b.  db    db .d8888.
+ *    d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8' 88'  YP
+ *    88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'  `8bo.
+ *    88~~~88 88`8b   88`8b   88~~~88    88      `Y8b.
+ *    88   88 88 `88. 88 `88. 88   88    88    db   8D
+ *    YP   YP 88   YD 88   YD YP   YP    YP    `8888Y'
+ *
+ *
+
+//Services
+import { spliceCopyArray, addItemToArrayIfItDoesNotExist, convertNumberArrayToRelativePercents,
+    removeItemFromArrayOnce, removeItemFromArrayAll } from '@mikezimm/npmfunctions/dist/Services/Arrays/services';
+*/
+export function convertArrayToLC(arr) {
+    let result = arr.map(str => { return str.toLowerCase(); });
+    return result;
+}
+export function expandArray(count) {
+    let theseInfos = [];
+    for (let index = 0; index < count; index++) {
+        theseInfos.push(null);
+    }
+    return theseInfos;
+}
+/***
+ *    .d8888. d8888b. db      d888888b  .o88b. d88888b  .o88b.  .d88b.  d8888b. db    db  .d8b.  d8888b. d8888b.  .d8b.  db    db
+ *    88'  YP 88  `8D 88        `88'   d8P  Y8 88'     d8P  Y8 .8P  Y8. 88  `8D `8b  d8' d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'
+ *    `8bo.   88oodD' 88         88    8P      88ooooo 8P      88    88 88oodD'  `8bd8'  88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'
+ *      `Y8b. 88~~~   88         88    8b      88~~~~~ 8b      88    88 88~~~      88    88~~~88 88`8b   88`8b   88~~~88    88
+ *    db   8D 88      88booo.   .88.   Y8b  d8 88.     Y8b  d8 `8b  d8' 88         88    88   88 88 `88. 88 `88. 88   88    88
+ *    `8888Y' 88      Y88888P Y888888P  `Y88P' Y88888P  `Y88P'  `Y88P'  88         YP    YP   YP 88   YD 88   YD YP   YP    YP
+ *
+ *
+ */
+/**
+ * This function will take an array of objects, and insert into another array of objects at a specific index.
+ * It will also remove objects at specific indexies.
+ *
+ * Example of call:  This will take an array of fields from a view, and just insert [ootbModified, ootbEditor ] at index #2 of the array.
+ * If you replace the startDel and countDelete with values, it will remove XX objects starting at index YY
+ * The unique thing about it though is for adding, you can give the original position to add things in.
+ * This way you don't have to figure out the new index if something is to be removed.
+ *
+ * export const ProjectRecentUpdatesFields = spliceCopyArray ( stdProjectViewFields, null, null, 2, [ootbModified, ootbEditor ] );
+ *
+ * In the example
+ *
+ * @param sourceArray - Original array of objects
+ * @param startDel - index of objects to start deleting
+ * @param countDelete - number of objects to delete starting at startDel
+ * @param startAddOrigPos - index to add 'addArray' in sourceArray... this is based on the original array you send, not what is left if you delete some items.
+ * @param addArray - array of items to insert into object a specified position.
+ */
+export function spliceCopyArray(sourceArray, startDel, countDelete, startAddOrigPos, addArray) {
+    let whole = [];
+    let skipMin = startDel === null ? "-1000" : startDel;
+    let skipMax = startDel === null ? "-1000" : startDel + countDelete - 1;
+    let addedArray = false;
+    if (startAddOrigPos <= 0) {
+        whole = whole.concat(addArray);
+        addedArray = true;
+    }
+    for (let i in sourceArray) {
+        let addedItem = false;
+        if (i < skipMin) {
+            whole.push(sourceArray[i]);
+            addedItem = true;
+        }
+        let startAddOrigPosTest = startAddOrigPos;
+        if (i == startAddOrigPosTest) {
+            whole = whole.concat(addArray);
+            addedArray = true;
+        }
+        if (i > skipMax && addedItem === false) {
+            whole.push(sourceArray[i]);
+        }
+    }
+    if (addedArray === false) {
+        whole = whole.concat(addArray);
+    }
+    return whole;
+}
+/***
+ *     .d8b.  d8888b. d8888b. d888888b d888888b d88888b .88b  d88.      d888888b  .d88b.   .d8b.  d8888b. d8888b.  .d8b.  db    db      d888888b d88888b      d888888b d888888b d8888b.  .d88b.  d88888b .d8888. d8b   db  .d88b.  d888888b d88888b db    db d888888b .d8888. d888888b
+ *    d8' `8b 88  `8D 88  `8D   `88'   `~~88~~' 88'     88'YbdP`88      `~~88~~' .8P  Y8. d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'        `88'   88'            `88'   `~~88~~' 88  `8D .8P  Y8. 88'     88'  YP 888o  88 .8P  Y8. `~~88~~' 88'     `8b  d8'   `88'   88'  YP `~~88~~'
+ *    88ooo88 88   88 88   88    88       88    88ooooo 88  88  88         88    88    88 88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'          88    88ooo           88       88    88   88 88    88 88ooooo `8bo.   88V8o 88 88    88    88    88ooooo  `8bd8'     88    `8bo.      88
+ *    88~~~88 88   88 88   88    88       88    88~~~~~ 88  88  88         88    88    88 88~~~88 88`8b   88`8b   88~~~88    88            88    88~~~           88       88    88   88 88    88 88~~~~~   `Y8b. 88 V8o88 88    88    88    88~~~~~  .dPYb.     88      `Y8b.    88
+ *    88   88 88  .8D 88  .8D   .88.      88    88.     88  88  88         88    `8b  d8' 88   88 88 `88. 88 `88. 88   88    88           .88.   88             .88.      88    88  .8D `8b  d8' 88.     db   8D 88  V888 `8b  d8'    88    88.     .8P  Y8.   .88.   db   8D    88
+ *    YP   YP Y8888D' Y8888D' Y888888P    YP    Y88888P YP  YP  YP         YP     `Y88P'  YP   YP 88   YD 88   YD YP   YP    YP         Y888888P YP           Y888888P    YP    Y8888D'  `Y88P'  Y88888P `8888Y' VP   V8P  `Y88P'     YP    Y88888P YP    YP Y888888P `8888Y'    YP
+ *
+ *     2020-09-24:  Updated from drilldown-filter webpart
+ */
+export function addItemToArrayIfItDoesNotExist(arr, item, suppressUndefined = true) {
+    if (item === undefined) {
+        if (suppressUndefined != true) {
+            console.log('addItemToArrayIfItDoesNotExist found undefined!');
+        }
+    }
+    //To close https://github.com/mikezimm/drilldown7/issues/94
+    if (typeof item === 'string') {
+        item = item.trim();
+    }
+    if (item != '' && item !== undefined && arr.indexOf(item) < 0) {
+        arr.push(item);
+    }
+    return arr;
+}
+/***
+ *     .o88b.  .d88b.  d8b   db db    db d88888b d8888b. d888888b      d8b   db db    db .88b  d88. d8888b. d88888b d8888b.  .d8b.  d8888b. d8888b.  .d8b.  db    db      d888888b  .d88b.  d8888b. d88888b db       .d8b.  d888888b d888888b db    db d88888b      d8888b. d88888b d8888b.  .o88b. d88888b d8b   db d888888b .d8888.
+ *    d8P  Y8 .8P  Y8. 888o  88 88    88 88'     88  `8D `~~88~~'      888o  88 88    88 88'YbdP`88 88  `8D 88'     88  `8D d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'      `~~88~~' .8P  Y8. 88  `8D 88'     88      d8' `8b `~~88~~'   `88'   88    88 88'          88  `8D 88'     88  `8D d8P  Y8 88'     888o  88 `~~88~~' 88'  YP
+ *    8P      88    88 88V8o 88 Y8    8P 88ooooo 88oobY'    88         88V8o 88 88    88 88  88  88 88oooY' 88ooooo 88oobY' 88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'          88    88    88 88oobY' 88ooooo 88      88ooo88    88       88    Y8    8P 88ooooo      88oodD' 88ooooo 88oobY' 8P      88ooooo 88V8o 88    88    `8bo.
+ *    8b      88    88 88 V8o88 `8b  d8' 88~~~~~ 88`8b      88         88 V8o88 88    88 88  88  88 88~~~b. 88~~~~~ 88`8b   88~~~88 88`8b   88`8b   88~~~88    88            88    88    88 88`8b   88~~~~~ 88      88~~~88    88       88    `8b  d8' 88~~~~~      88~~~   88~~~~~ 88`8b   8b      88~~~~~ 88 V8o88    88      `Y8b.
+ *    Y8b  d8 `8b  d8' 88  V888  `8bd8'  88.     88 `88.    88         88  V888 88b  d88 88  88  88 88   8D 88.     88 `88. 88   88 88 `88. 88 `88. 88   88    88            88    `8b  d8' 88 `88. 88.     88booo. 88   88    88      .88.    `8bd8'  88.          88      88.     88 `88. Y8b  d8 88.     88  V888    88    db   8D
+ *     `Y88P'  `Y88P'  VP   V8P    YP    Y88888P 88   YD    YP         VP   V8P ~Y8888P' YP  YP  YP Y8888P' Y88888P 88   YD YP   YP 88   YD 88   YD YP   YP    YP            YP     `Y88P'  88   YD Y88888P Y88888P YP   YP    YP    Y888888P    YP    Y88888P      88      Y88888P 88   YD  `Y88P' Y88888P VP   V8P    YP    `8888Y'
+ *
+ *
+ * @param arr
+ * @param percentsAsWholeNumbers -- If true, converts 25% from 0.25 to 25.
+ *
+ */
+export function convertNumberArrayToRelativePercents(arr, percentsAsWholeNumbers = true) {
+    let result = [];
+    //Get sum of array of numbers:  https://codeburst.io/javascript-arrays-finding-the-minimum-maximum-sum-average-values-f02f1b0ce332
+    // Can't do this:  const arrSum = arr => arr.reduce((a,b) => a + b, 0) like example.
+    // And THIS changes arr to single value:  const arrSum = arr.reduce((a,b) => a + b, 0);
+    let arrSum = 0;
+    arr.map(v => { if (v !== null && v !== undefined) {
+        arrSum += v;
+    } });
+    let multiplier = percentsAsWholeNumbers === true ? 100 : 1;
+    if (arrSum === 0) {
+        console.log('Unable to convertNumberArrayToRelativePercents because Sum === 0', arrSum, arr);
+    }
+    arr.map(v => {
+        result.push(arrSum !== 0 ? multiplier * v / arrSum : multiplier * v / 1);
+    });
+    return result;
+}
+/***
+ *    d8888b. d88888b .88b  d88.  .d88b.  db    db d88888b      d888888b d888888b d88888b .88b  d88.      d88888b d8888b.  .d88b.  .88b  d88.       .d8b.  d8888b. d8888b.  .d8b.  db    db       .d88b.  d8b   db  .o88b. d88888b
+ *    88  `8D 88'     88'YbdP`88 .8P  Y8. 88    88 88'            `88'   `~~88~~' 88'     88'YbdP`88      88'     88  `8D .8P  Y8. 88'YbdP`88      d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'      .8P  Y8. 888o  88 d8P  Y8 88'
+ *    88oobY' 88ooooo 88  88  88 88    88 Y8    8P 88ooooo         88       88    88ooooo 88  88  88      88ooo   88oobY' 88    88 88  88  88      88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'       88    88 88V8o 88 8P      88ooooo
+ *    88`8b   88~~~~~ 88  88  88 88    88 `8b  d8' 88~~~~~         88       88    88~~~~~ 88  88  88      88~~~   88`8b   88    88 88  88  88      88~~~88 88`8b   88`8b   88~~~88    88         88    88 88 V8o88 8b      88~~~~~
+ *    88 `88. 88.     88  88  88 `8b  d8'  `8bd8'  88.            .88.      88    88.     88  88  88      88      88 `88. `8b  d8' 88  88  88      88   88 88 `88. 88 `88. 88   88    88         `8b  d8' 88  V888 Y8b  d8 88.
+ *    88   YD Y88888P YP  YP  YP  `Y88P'     YP    Y88888P      Y888888P    YP    Y88888P YP  YP  YP      YP      88   YD  `Y88P'  YP  YP  YP      YP   YP 88   YD 88   YD YP   YP    YP          `Y88P'  VP   V8P  `Y88P' Y88888P
+ *
+ * import { removeItemFromArrayOnce, removeItemFromArrayAll } from '../../../services/arrayServices';
+ * https://stackoverflow.com/a/5767357
+ *
+ */
+export function removeItemFromArrayOnce(arr, value) {
+    if (arr === null || arr === undefined) {
+        //Do nothing... 
+    }
+    else {
+        var index = arr.indexOf(value);
+        if (index > -1) {
+            arr.splice(index, 1);
+        }
+    }
+    return arr;
+}
+/***
+ *    d8888b. d88888b .88b  d88.  .d88b.  db    db d88888b      d888888b d888888b d88888b .88b  d88.      d88888b d8888b.  .d88b.  .88b  d88.       .d8b.  d8888b. d8888b.  .d8b.  db    db       .d8b.  db      db
+ *    88  `8D 88'     88'YbdP`88 .8P  Y8. 88    88 88'            `88'   `~~88~~' 88'     88'YbdP`88      88'     88  `8D .8P  Y8. 88'YbdP`88      d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'      d8' `8b 88      88
+ *    88oobY' 88ooooo 88  88  88 88    88 Y8    8P 88ooooo         88       88    88ooooo 88  88  88      88ooo   88oobY' 88    88 88  88  88      88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'       88ooo88 88      88
+ *    88`8b   88~~~~~ 88  88  88 88    88 `8b  d8' 88~~~~~         88       88    88~~~~~ 88  88  88      88~~~   88`8b   88    88 88  88  88      88~~~88 88`8b   88`8b   88~~~88    88         88~~~88 88      88
+ *    88 `88. 88.     88  88  88 `8b  d8'  `8bd8'  88.            .88.      88    88.     88  88  88      88      88 `88. `8b  d8' 88  88  88      88   88 88 `88. 88 `88. 88   88    88         88   88 88booo. 88booo.
+ *    88   YD Y88888P YP  YP  YP  `Y88P'     YP    Y88888P      Y888888P    YP    Y88888P YP  YP  YP      YP      88   YD  `Y88P'  YP  YP  YP      YP   YP 88   YD 88   YD YP   YP    YP         YP   YP Y88888P Y88888P
+ *
+ * import { removeItemFromArrayOnce, removeItemFromArrayAll } from '../../../services/arrayServices';
+ * https://stackoverflow.com/a/5767357
+ */
+export function removeItemFromArrayAll(arr, value) {
+    if (arr === null || arr === undefined) {
+        //Do nothing... 
+    }
+    else {
+        var i = 0;
+        while (i < arr.length) {
+            if (arr[i] === value) {
+                arr.splice(i, 1);
+            }
+            else {
+                ++i;
+            }
+        }
+    }
+    return arr;
+}
+/***
+*    db    db d8888b. d8888b.  .d8b.  d888888b d88888b      d8b   db d88888b db    db d888888b       .d88b.  d8888b. d88888b d8b   db      d888888b d8b   db d8888b. d88888b db    db
+*    88    88 88  `8D 88  `8D d8' `8b `~~88~~' 88'          888o  88 88'     `8b  d8' `~~88~~'      .8P  Y8. 88  `8D 88'     888o  88        `88'   888o  88 88  `8D 88'     `8b  d8'
+*    88    88 88oodD' 88   88 88ooo88    88    88ooooo      88V8o 88 88ooooo  `8bd8'     88         88    88 88oodD' 88ooooo 88V8o 88         88    88V8o 88 88   88 88ooooo  `8bd8'
+*    88    88 88~~~   88   88 88~~~88    88    88~~~~~      88 V8o88 88~~~~~  .dPYb.     88         88    88 88~~~   88~~~~~ 88 V8o88         88    88 V8o88 88   88 88~~~~~  .dPYb.
+*    88b  d88 88      88  .8D 88   88    88    88.          88  V888 88.     .8P  Y8.    88         `8b  d8' 88      88.     88  V888        .88.   88  V888 88  .8D 88.     .8P  Y8.
+*    ~Y8888P' 88      Y8888D' YP   YP    YP    Y88888P      VP   V8P Y88888P YP    YP    YP          `Y88P'  88      Y88888P VP   V8P      Y888888P VP   V8P Y8888D' Y88888P YP    YP
+*
+*    import { updateNextOpenIndex } from '@mikezimm/npmfunctions/dist/Services/Arrays/manipulation';
+*
+* The purpose of this array is to get an array of items [ 0, 1, null, 3,  4,  null ]
+* Provide a start index
+* Find the first empty/null value in array starting at that index
+* Set the value in that slot to the value provided
+* Example:
+* updateNextOpenIndex( [ 0, 1, null, 3,  4,  null ], 0, 999 )
+* updateNextOpenIndex( [ 0, 1, null, 3,  4,  null ], 1, 999 )
+* updateNextOpenIndex( [ 0, 1, null, 3,  4,  null ], 2, 999 )
+*     ==>> will return [ 0, 1, 999, 3,  4,  null ]
+*
+* updateNextOpenIndex( [ 0, 1, null, 3,  4,  null ], 3, 777 )
+*     ==>> will return [ 0, 1, null, 3,  4,  777 ]
+*/
+/**
+ *
+ * @param targetArray
+ * @param start start index to start looking for a null value
+ * @param value value to set the next open slot to
+ */
+export function updateNextOpenIndex(targetArray, start, value) {
+    let exit = false;
+    for (let index = start; index < targetArray.length; index++) {
+        if (!exit && targetArray[index] === null) {
+            targetArray[index] = value;
+            exit = true;
+        }
+    }
+    return targetArray;
+}
+//# sourceMappingURL=manipulation.js.map

package/lib/logic/Arrays/manipulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulation.js","sourceRoot":"","sources":["../../../src/logic/Arrays/manipulation.ts"],"names":[],"mappings":"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"}

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKey.d.ts

@@ -0,0 +1,11 @@
+/**
+ *  This will take an array of objects, and return unique ones based on the key property.
+ *  If there are duplicate items with the same key value, the first one is returned and the rest are not returned.
+ *
+ * Originally written for processHubSubResults using chatGPT
+ * 2023-10-02:  Found this does only returns one item if the key values were PivotTiles and PivotTiles79
+ * @param arr
+ * @returns
+ */
+export declare function filterObjArrayByUniqueKey(arr: any[], key: string): any[];
+//# sourceMappingURL=filterObjArrayByUniqueKey.d.ts.map

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterObjArrayByUniqueKey.d.ts","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/filterObjArrayByUniqueKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAGxE"}

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKey.js

@@ -0,0 +1,13 @@
+/**
+ *  This will take an array of objects, and return unique ones based on the key property.
+ *  If there are duplicate items with the same key value, the first one is returned and the rest are not returned.
+ *
+ * Originally written for processHubSubResults using chatGPT
+ * 2023-10-02:  Found this does only returns one item if the key values were PivotTiles and PivotTiles79
+ * @param arr
+ * @returns
+ */
+export function filterObjArrayByUniqueKey(arr, key) {
+    return arr.filter((obj, index, self) => index === self.findIndex((t) => t[key] === obj[key]));
+}
+//# sourceMappingURL=filterObjArrayByUniqueKey.js.map

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterObjArrayByUniqueKey.js","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/filterObjArrayByUniqueKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,yBAAyB,CAAC,GAAU,EAAE,GAAW;IAC/D,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,KAAa,EAAE,IAAS,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAClH,CAAC;AACJ,CAAC"}

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKeyLONGWAY.d.ts

@@ -0,0 +1,2 @@
+export declare function filterObjArrayByUniqueKeyLONGWAY(arr: any[], key: string, keepAllNotEquals?: boolean): any[];
+//# sourceMappingURL=filterObjArrayByUniqueKeyLONGWAY.d.ts.map

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKeyLONGWAY.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterObjArrayByUniqueKeyLONGWAY.d.ts","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/filterObjArrayByUniqueKeyLONGWAY.ts"],"names":[],"mappings":"AAKA,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,GAAE,OAAc,GAAG,GAAG,EAAE,CA0BjH"}

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKeyLONGWAY.js

@@ -0,0 +1,35 @@
+// Only tested with string values!
+// Verified this nets the same results as filterObjArrayByUniqueKey
+// So just separating into separate file in case I need to revisit.
+export function filterObjArrayByUniqueKeyLONGWAY(arr, key, keepAllNotEquals = true) {
+    const results = [];
+    const values = [];
+    arr.map(item => {
+        const testVal = item[key];
+        let keepThis = false;
+        if (keepAllNotEquals === true && !testVal) {
+            keepThis = true;
+        }
+        else if (typeof testVal !== 'string') {
+            if (values.indexOf(testVal) < 0) {
+                keepThis = true;
+                values.push(testVal);
+            }
+        }
+        else if (typeof testVal !== 'number') {
+            if (values.indexOf(testVal) < 0) {
+                keepThis = true;
+                values.push(testVal);
+            }
+        }
+        else {
+            keepThis = true;
+        }
+        if (keepThis === true) {
+            results.push(item);
+        }
+    });
+    return results;
+    // return arr.filter((obj: any, index: number, self: any) => index === self.findIndex((t: any) => t[key] === obj[key]));
+}
+//# sourceMappingURL=filterObjArrayByUniqueKeyLONGWAY.js.map

package/lib/logic/Arrays/searching/filterObjArrayByUniqueKeyLONGWAY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterObjArrayByUniqueKeyLONGWAY.js","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/filterObjArrayByUniqueKeyLONGWAY.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,mEAAmE;AACnE,mEAAmE;AAEnE,MAAM,UAAU,gCAAgC,CAAC,GAAU,EAAE,GAAW,EAAE,mBAA4B,IAAI;IACxG,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,IAAI,gBAAgB,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YACzC,QAAQ,GAAG,IAAI,CAAC;SAEjB;aAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YACtC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC/B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;aACtB;SACF;aAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YACtC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC/B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;aACtB;SACF;aAAM;YAAE,QAAQ,GAAG,IAAI,CAAC;SAAE;QAC3B,IAAI,QAAQ,KAAK,IAAI,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAAE;IAChD,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;IACf,wHAAwH;AAC1H,CAAC"}

package/lib/logic/Arrays/searching/getNextIndex.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This will get the next zero-based index based on the length of an array
+ *    by default it looks forward but if back===true looks backwards
+ *    if going forward past the end it cycles back to zero
+ *
+ * @param length
+ * @param current
+ * @param back
+ * @returns
+ */
+export declare function getNextIndex(length: number, current: number, back?: boolean): number;
+//# sourceMappingURL=getNextIndex.d.ts.map

package/lib/logic/Arrays/searching/getNextIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNextIndex.d.ts","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/getNextIndex.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,OAAe,GAAG,MAAM,CAM3F"}

package/lib/logic/Arrays/searching/getNextIndex.js

@@ -0,0 +1,19 @@
+/**
+ * This will get the next zero-based index based on the length of an array
+ *    by default it looks forward but if back===true looks backwards
+ *    if going forward past the end it cycles back to zero
+ *
+ * @param length
+ * @param current
+ * @param back
+ * @returns
+ */
+export function getNextIndex(length, current, back = false) {
+    if (back === false) {
+        return current === length - 1 ? 0 : current + 1;
+    }
+    else {
+        return current === 0 ? length - 1 : current - 1;
+    }
+}
+//# sourceMappingURL=getNextIndex.js.map

package/lib/logic/Arrays/searching/getNextIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNextIndex.js","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/getNextIndex.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAe,EAAE,OAAgB,KAAK;IACjF,IAAI,IAAI,KAAK,KAAK,EAAE;QAClB,OAAO,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;KACjD;SAAM;QACL,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;KACjD;AACH,CAAC"}

package/lib/logic/Arrays/searching/objectfind.d.ts

@@ -0,0 +1,52 @@
+/***
+ *    d888888b d8b   db d8888b. d88888b db    db  .d88b.  d88888b       .d8b.  d8b   db db    db       .o88b.  .d8b.  .d8888. d88888b
+ *      `88'   888o  88 88  `8D 88'     `8b  d8' .8P  Y8. 88'          d8' `8b 888o  88 `8b  d8'      d8P  Y8 d8' `8b 88'  YP 88'
+ *       88    88V8o 88 88   88 88ooooo  `8bd8'  88    88 88ooo        88ooo88 88V8o 88  `8bd8'       8P      88ooo88 `8bo.   88ooooo
+ *       88    88 V8o88 88   88 88~~~~~  .dPYb.  88    88 88~~~        88~~~88 88 V8o88    88         8b      88~~~88   `Y8b. 88~~~~~
+ *      .88.   88  V888 88  .8D 88.     .8P  Y8. `8b  d8' 88           88   88 88  V888    88         Y8b  d8 88   88 db   8D 88.
+ *    Y888888P VP   V8P Y8888D' Y88888P YP    YP  `Y88P'  YP           YP   YP VP   V8P    YP          `Y88P' YP   YP `8888Y' Y88888P
+ *
+ *
+ */
+/**
+ * Based on:  https://bobbyhadz.com/blog/javascript-array-contains-string-case-insensitive
+ * Any non-string checks will be considered 'not a match'
+ * @param checkMe
+ * @param inArray
+ */
+export declare function indexOfAnyCase(checkMe: string, inArray: string[], consoleLog: boolean, alertMe: boolean): number;
+/***
+ *    d8888b.  .d88b.  d88888b .d8888.       .d88b.  d8888b.    d88b d88888b  .o88b. d888888b      d88888b db    db d888888b .d8888. d888888b      d888888b d8b   db  .d8b.  d8888b. d8888b.  .d8b.  db    db
+ *    88  `8D .8P  Y8. 88'     88'  YP      .8P  Y8. 88  `8D    `8P' 88'     d8P  Y8 `~~88~~'      88'     `8b  d8'   `88'   88'  YP `~~88~~'        `88'   888o  88 d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'
+ *    88   88 88    88 88ooooo `8bo.        88    88 88oooY'     88  88ooooo 8P         88         88ooooo  `8bd8'     88    `8bo.      88            88    88V8o 88 88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'
+ *    88   88 88    88 88~~~~~   `Y8b.      88    88 88~~~b.     88  88~~~~~ 8b         88         88~~~~~  .dPYb.     88      `Y8b.    88            88    88 V8o88 88~~~88 88`8b   88`8b   88~~~88    88
+ *    88  .8D `8b  d8' 88.     db   8D      `8b  d8' 88   8D db. 88  88.     Y8b  d8    88         88.     .8P  Y8.   .88.   db   8D    88           .88.   88  V888 88   88 88 `88. 88 `88. 88   88    88
+ *    Y8888D'  `Y88P'  Y88888P `8888Y'       `Y88P'  Y8888P' Y8888P  Y88888P  `Y88P'    YP         Y88888P YP    YP Y888888P `8888Y'    YP         Y888888P VP   V8P YP   YP 88   YD 88   YD YP   YP    YP
+ *
+ *
+ */
+/**
+ * This function checks to see if an element of an array (object) contains a specific property/value pair.
+ *
+ * example call:  if ( doesObjectExistInArray(currentFields, 'StaticName', checkField ) ) {
+ * This takes an array of field objects (currentFields), and looks to see if any of the objects has a key of StaticName which has a value of checkField variable.
+ *
+ * @param sourceArray
+ * @param objectProperty
+ * @param propValue
+ */
+export declare function doesObjectExistInArrayInt(sourceArray: any[], objectProperty: string, propValue: any, exact?: boolean): number;
+export declare function doesObjectExistInArray(sourceArray: any[], objectProperty: string, propValue: any, exact?: boolean): false | string;
+/**
+ *  Typical use case:  arr = ['a','b','c' ]
+ *  getNextElementInArray( arr, 'b', 'next, true, 'notfound' ) returns 'c'
+ *  getNextElementInArray( arr, 'c', 'next, true, 'notfound' ) returns 'a'
+ *
+ * @param arr array should be either numbers or strings, not objects
+ * @param current item to search for
+ * @param direction direction to search for
+ * @param roll true = if it's the last item and you pick 'next' it will get the first item in array etc.
+ * @param notFound = return result if not found ( either because current is not in array or roll === false and it's at an end )
+ */
+export declare function getNextElementInArray(arr: any[], current: any, direction: 'next' | 'prev', roll: boolean, notFound: any): any;
+//# sourceMappingURL=objectfind.d.ts.map

package/lib/logic/Arrays/searching/objectfind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectfind.d.ts","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/objectfind.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAK,MAAM,CAenH;AAGD;;;;;;;;;GASG;AAEH;;;;;;;;;GASG;AAEF,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,cAAc,EAAG,MAAM,EAAE,SAAS,EAAG,GAAG,EAAE,KAAK,GAAG,OAAc,GAAK,MAAM,CAGzI;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,cAAc,EAAG,MAAM,EAAE,SAAS,EAAG,GAAG,EAAE,KAAK,GAAG,OAAc,GAAK,KAAK,GAAG,MAAM,CAoB7I;AAGD;;;;;;;;;;GAUG;AACF,wBAAgB,qBAAqB,CAAE,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAG,IAAI,EAAG,OAAO,EAAE,QAAQ,EAAE,GAAG,GAAI,GAAG,CAyBlI"}

package/lib/logic/Arrays/searching/objectfind.js

@@ -0,0 +1,123 @@
+import { getHelpfullErrorV2 } from '../../Errors/friendly';
+/***
+ *    d888888b d8b   db d8888b. d88888b db    db  .d88b.  d88888b       .d8b.  d8b   db db    db       .o88b.  .d8b.  .d8888. d88888b
+ *      `88'   888o  88 88  `8D 88'     `8b  d8' .8P  Y8. 88'          d8' `8b 888o  88 `8b  d8'      d8P  Y8 d8' `8b 88'  YP 88'
+ *       88    88V8o 88 88   88 88ooooo  `8bd8'  88    88 88ooo        88ooo88 88V8o 88  `8bd8'       8P      88ooo88 `8bo.   88ooooo
+ *       88    88 V8o88 88   88 88~~~~~  .dPYb.  88    88 88~~~        88~~~88 88 V8o88    88         8b      88~~~88   `Y8b. 88~~~~~
+ *      .88.   88  V888 88  .8D 88.     .8P  Y8. `8b  d8' 88           88   88 88  V888    88         Y8b  d8 88   88 db   8D 88.
+ *    Y888888P VP   V8P Y8888D' Y88888P YP    YP  `Y88P'  YP           YP   YP VP   V8P    YP          `Y88P' YP   YP `8888Y' Y88888P
+ *
+ *
+ */
+/**
+ * Based on:  https://bobbyhadz.com/blog/javascript-array-contains-string-case-insensitive
+ * Any non-string checks will be considered 'not a match'
+ * @param checkMe
+ * @param inArray
+ */
+export function indexOfAnyCase(checkMe, inArray, consoleLog, alertMe) {
+    let result = -1;
+    //result = inArray.findIndex( element => { //NOTE:  findIndex does not work in my code (typescript error)
+    inArray.map((element, index) => {
+        try {
+            if (element.toLowerCase() === checkMe.toLowerCase()) {
+                result = index;
+            }
+        }
+        catch (e) {
+            //Sending false, false to getHelpfullErrorV2  because I'm handling that here
+            let errMessage = getHelpfullErrorV2(e, alertMe, consoleLog, 'indexOfAnyCase ~ 65');
+        }
+    });
+    return result;
+}
+/***
+ *    d8888b.  .d88b.  d88888b .d8888.       .d88b.  d8888b.    d88b d88888b  .o88b. d888888b      d88888b db    db d888888b .d8888. d888888b      d888888b d8b   db  .d8b.  d8888b. d8888b.  .d8b.  db    db
+ *    88  `8D .8P  Y8. 88'     88'  YP      .8P  Y8. 88  `8D    `8P' 88'     d8P  Y8 `~~88~~'      88'     `8b  d8'   `88'   88'  YP `~~88~~'        `88'   888o  88 d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'
+ *    88   88 88    88 88ooooo `8bo.        88    88 88oooY'     88  88ooooo 8P         88         88ooooo  `8bd8'     88    `8bo.      88            88    88V8o 88 88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'
+ *    88   88 88    88 88~~~~~   `Y8b.      88    88 88~~~b.     88  88~~~~~ 8b         88         88~~~~~  .dPYb.     88      `Y8b.    88            88    88 V8o88 88~~~88 88`8b   88`8b   88~~~88    88
+ *    88  .8D `8b  d8' 88.     db   8D      `8b  d8' 88   8D db. 88  88.     Y8b  d8    88         88.     .8P  Y8.   .88.   db   8D    88           .88.   88  V888 88   88 88 `88. 88 `88. 88   88    88
+ *    Y8888D'  `Y88P'  Y88888P `8888Y'       `Y88P'  Y8888P' Y8888P  Y88888P  `Y88P'    YP         Y88888P YP    YP Y888888P `8888Y'    YP         Y888888P VP   V8P YP   YP 88   YD 88   YD YP   YP    YP
+ *
+ *
+ */
+/**
+ * This function checks to see if an element of an array (object) contains a specific property/value pair.
+ *
+ * example call:  if ( doesObjectExistInArray(currentFields, 'StaticName', checkField ) ) {
+ * This takes an array of field objects (currentFields), and looks to see if any of the objects has a key of StaticName which has a value of checkField variable.
+ *
+ * @param sourceArray
+ * @param objectProperty
+ * @param propValue
+ */
+export function doesObjectExistInArrayInt(sourceArray, objectProperty, propValue, exact = true) {
+    let result = doesObjectExistInArray(sourceArray, objectProperty, propValue, exact);
+    if (result === false) {
+        return -1;
+    }
+    else {
+        return parseInt(result);
+    }
+}
+export function doesObjectExistInArray(sourceArray, objectProperty, propValue, exact = true) {
+    let result = false;
+    for (let i in sourceArray) {
+        let test = false;
+        if (exact === true) { //2020-10-07:  Added this to allow for Id string to number checks
+            test = sourceArray[i][objectProperty] === propValue ? true : false;
+        }
+        else {
+            test = sourceArray[i][objectProperty] == propValue ? true : false;
+        }
+        if (test === true) {
+            result = i;
+            break;
+        }
+    }
+    return result;
+}
+/**
+ *  Typical use case:  arr = ['a','b','c' ]
+ *  getNextElementInArray( arr, 'b', 'next, true, 'notfound' ) returns 'c'
+ *  getNextElementInArray( arr, 'c', 'next, true, 'notfound' ) returns 'a'
+ *
+ * @param arr array should be either numbers or strings, not objects
+ * @param current item to search for
+ * @param direction direction to search for
+ * @param roll true = if it's the last item and you pick 'next' it will get the first item in array etc.
+ * @param notFound = return result if not found ( either because current is not in array or roll === false and it's at an end )
+ */
+export function getNextElementInArray(arr, current, direction, roll, notFound) {
+    let result = null;
+    let idx = arr.indexOf(current);
+    if (arr.length === 0 || idx === -1) { } //result = notFound; }
+    else if (arr.length === 1) {
+        result = roll === true ? arr[0] : null;
+    }
+    else if (idx === 0) { //This is first item in the array
+        if (direction === 'next') {
+            result = arr[1];
+        }
+        else {
+            result = roll === true ? arr.length - 1 : null;
+        }
+    }
+    else if (idx === arr.length - 1) { //This is the last item in the array
+        if (direction === 'prev') {
+            result = arr[idx - 1];
+        }
+        else {
+            result = roll === true ? arr[0] : null;
+        }
+    }
+    else { //This is the last item in the array
+        result = arr[direction === 'next' ? idx + 1 : idx - 1];
+    }
+    if (result === null) {
+        result = notFound;
+        console.log(' ERROR in getNextElementInArray', arr, current, direction, roll, notFound);
+    }
+    return result;
+}
+//# sourceMappingURL=objectfind.js.map

package/lib/logic/Arrays/searching/objectfind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectfind.js","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/objectfind.ts"],"names":[],"mappings":"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"}

package/lib/logic/Arrays/searching/objectkeys.d.ts

@@ -0,0 +1,70 @@
+/***
+ *    .d8888. d888888b d8888b. d888888b d8b   db  d888b  d888888b d88888b db    db db   dD d88888b db    db db    db  .d8b.  db      db    db d88888b
+ *    88'  YP `~~88~~' 88  `8D   `88'   888o  88 88' Y8b   `88'   88'     `8b  d8' 88 ,8P' 88'     `8b  d8' 88    88 d8' `8b 88      88    88 88'
+ *    `8bo.      88    88oobY'    88    88V8o 88 88         88    88ooo    `8bd8'  88,8P   88ooooo  `8bd8'  Y8    8P 88ooo88 88      88    88 88ooooo
+ *      `Y8b.    88    88`8b      88    88 V8o88 88  ooo    88    88~~~      88    88`8b   88~~~~~    88    `8b  d8' 88~~~88 88      88    88 88~~~~~
+ *    db   8D    88    88 `88.   .88.   88  V888 88. ~8~   .88.   88         88    88 `88. 88.        88     `8bd8'  88   88 88booo. 88b  d88 88.
+ *    `8888Y'    YP    88   YD Y888888P VP   V8P  Y888P  Y888888P YP         YP    YP   YD Y88888P    YP       YP    YP   YP Y88888P ~Y8888P' Y88888P
+ *
+ *
+ */
+/**
+ * This just takes an object, and returns a string of the Key and Value.
+ * Used for logging
+ * @param thisOne
+ * @param keyNo
+ * @param delimiter
+ */
+/***
+ *     d888b  d88888b d888888b      .88b  d88.  .d8b.  db    db      d8888b. d8888b.  .d88b.  d8888b.       .d88b.  d88888b      db   dD d88888b db    db
+ *    88' Y8b 88'     `~~88~~'      88'YbdP`88 d8' `8b `8b  d8'      88  `8D 88  `8D .8P  Y8. 88  `8D      .8P  Y8. 88'          88 ,8P' 88'     `8b  d8'
+ *    88      88ooooo    88         88  88  88 88ooo88  `8bd8'       88oodD' 88oobY' 88    88 88oodD'      88    88 88ooo        88,8P   88ooooo  `8bd8'
+ *    88  ooo 88~~~~~    88         88  88  88 88~~~88  .dPYb.       88~~~   88`8b   88    88 88~~~        88    88 88~~~        88`8b   88~~~~~    88
+ *    88. ~8~ 88.        88         88  88  88 88   88 .8P  Y8.      88      88 `88. `8b  d8' 88           `8b  d8' 88           88 `88. 88.        88
+ *     Y888P  Y88888P    YP         YP  YP  YP YP   YP YP    YP      88      88   YD  `Y88P'  88            `Y88P'  YP           YP   YD Y88888P    YP
+ *
+ *    d888888b d8b   db       .d88b.  d8888b.    d88b d88888b  .o88b. d888888b       .d8b.  d8888b. d8888b.  .d8b.  db    db
+ *      `88'   888o  88      .8P  Y8. 88  `8D    `8P' 88'     d8P  Y8 `~~88~~'      d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8'
+ *       88    88V8o 88      88    88 88oooY'     88  88ooooo 8P         88         88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'
+ *       88    88 V8o88      88    88 88~~~b.     88  88~~~~~ 8b         88         88~~~88 88`8b   88`8b   88~~~88    88
+ *      .88.   88  V888      `8b  d8' 88   8D db. 88  88.     Y8b  d8    88         88   88 88 `88. 88 `88. 88   88    88
+ *    Y888888P VP   V8P       `Y88P'  Y8888P' Y8888P  Y88888P  `Y88P'    YP         YP   YP 88   YD 88   YD YP   YP    YP
+ *
+ *      2021-02-14:  Copied from generic solution
+ */
+export declare function getMaxPropOfKeyInObjectArray(arr: any[], key: string, find: 'max' | 'min', filterKey?: string, filterTest?: 'eq' | 'neq', filterVal?: any): any;
+export declare function stringifyKeyValue(thisOne: any, keyNo: any, delimiter: string): string;
+export interface ICompareResult {
+    checkForTheseItems: any[];
+    inThisArray: any[];
+    found: any[];
+    notFound: any[];
+    result: any[];
+    message: string;
+}
+/***
+ *     .o88b.  .d88b.  .88b  d88. d8888b.  .d8b.  d8888b. d88888b  .d8b.  d8888b. d8888b.  .d8b.  db    db .d8888.
+ *    d8P  Y8 .8P  Y8. 88'YbdP`88 88  `8D d8' `8b 88  `8D 88'     d8' `8b 88  `8D 88  `8D d8' `8b `8b  d8' 88'  YP
+ *    8P      88    88 88  88  88 88oodD' 88ooo88 88oobY' 88ooooo 88ooo88 88oobY' 88oobY' 88ooo88  `8bd8'  `8bo.
+ *    8b      88    88 88  88  88 88~~~   88~~~88 88`8b   88~~~~~ 88~~~88 88`8b   88`8b   88~~~88    88      `Y8b.
+ *    Y8b  d8 `8b  d8' 88  88  88 88      88   88 88 `88. 88.     88   88 88 `88. 88 `88. 88   88    88    db   8D
+ *     `Y88P'  `Y88P'  YP  YP  YP 88      YP   YP 88   YD Y88888P YP   YP 88   YD 88   YD YP   YP    YP    `8888Y'
+ *
+ *
+ * The original goal of this function, would be to remove objects from one array if it were in another array.
+ * As an example, I have an array of items I want to add to a list (addItemsArray)
+ * Then I run a process which creates another 'result' array of what things were actually added - minus any errors
+ * The function will remove the items in the 'result' array from the 'addItemsArray.
+ * Only the items that were not added (ie the ones that errored out) will be left... or maybe it would add a key with the result.
+ *
+  *
+  * @param checkForTheseItems - this is the array of items you want to check for in the sourceArray ('inThisArray')
+  * @param inThisArray - this is the array where you are looking for items in
+  * @param method - this tells what to do... either flage items in 'inThisArray' with found/not found, or remove the found ones
+  * @param keyToCheck - checkForTheseItems must have a key which has this syntax:  checkValue: "Title===Training"
+  *                     keyToCheck would === 'checkValue' and the value for that key must have the syntax:  PropertyKey===ValueOfProperty;
+  *                     In the example above, it will split Title===Training into ['Title','Training']
+  *                     Then look for all items in 'inThisArray' which have the value 'Training' in the key 'Title', and apply the method you want to apply.
+  */
+export declare function compareArrays(checkForTheseItems: any[], inThisArray: any[], method: 'AddTag' | 'ReturnNOTFound' | 'ReturnFound', keyToCheck: string, checkDelimiter: string, messsages: 'Console' | 'Alert' | 'Both' | 'None'): ICompareResult;
+//# sourceMappingURL=objectkeys.d.ts.map

package/lib/logic/Arrays/searching/objectkeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectkeys.d.ts","sourceRoot":"","sources":["../../../../src/logic/Arrays/searching/objectkeys.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,4BAA4B,CAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,EAAG,SAAS,CAAC,EAAG,GAAG,GAAK,GAAG,CA8CnK;AAGD,wBAAgB,iBAAiB,CAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAG,MAAM,GAAK,MAAM,CAIzF;AAGD,MAAM,WAAW,cAAc;IAC3B,kBAAkB,EAAE,GAAG,EAAG,CAAC;IAC3B,WAAW,EAAE,GAAG,EAAG,CAAC;IACpB,KAAK,EAAE,GAAG,EAAG,CAAC;IACd,QAAQ,EAAE,GAAG,EAAG,CAAC;IACjB,MAAM,EAAE,GAAG,EAAG,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAGD;;;;;;;;;;;;;;;;;;;;;;;IAuBI;AACH,wBAAgB,aAAa,CAAC,kBAAkB,EAAE,GAAG,EAAG,EAAE,WAAW,EAAE,GAAG,EAAG,EAAE,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAG,MAAM,EAAE,SAAS,EAAE,SAAS,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,GAAI,cAAc,CAiH5O"}