@mikezimm/fps-core-v7 1.0.6 → 1.0.7

package/lib/logic/Arrays/compare.js

@@ -0,0 +1,166 @@
+import { getKeyChanges } from '../../logic/Objects/keys';
+export function buildEmptyCompareResults(ignoreKeys, flagStyle) {
+    let compareKeysResult = {
+        flagKeys: ignoreKeys,
+        flagStyle: flagStyle,
+        ignoredKeys: [],
+        compareKeys: [],
+        keyChanges: null,
+        identicalKeys: [],
+        differentKeys: [],
+        newKeys: [],
+        success: false,
+    };
+    return compareKeysResult;
+}
+/***
+ *     .o88b.  .d88b.  .88b  d88. d8888b.  .d8b.  d8888b. d88888b
+ *    d8P  Y8 .8P  Y8. 88'YbdP`88 88  `8D d8' `8b 88  `8D 88'
+ *    8P      88    88 88  88  88 88oodD' 88ooo88 88oobY' 88ooooo
+ *    8b      88    88 88  88  88 88~~~   88~~~88 88`8b   88~~~~~
+ *    Y8b  d8 `8b  d8' 88  88  88 88      88   88 88 `88. 88.
+ *     `Y88P'  `Y88P'  YP  YP  YP 88      YP   YP 88   YD Y88888P
+ *
+ *
+ *    d88888b db       .d8b.  d888888b       .d88b.  d8888b.    d88b d88888b  .o88b. d888888b .d8888.
+ *    88'     88      d8' `8b `~~88~~'      .8P  Y8. 88  `8D    `8P' 88'     d8P  Y8 `~~88~~' 88'  YP
+ *    88ooo   88      88ooo88    88         88    88 88oooY'     88  88ooooo 8P         88    `8bo.
+ *    88~~~   88      88~~~88    88         88    88 88~~~b.     88  88~~~~~ 8b         88      `Y8b.
+ *    88      88booo. 88   88    88         `8b  d8' 88   8D db. 88  88.     Y8b  d8    88    db   8D
+ *    YP      Y88888P YP   YP    YP          `Y88P'  Y8888P' Y8888P  Y88888P  `Y88P'    YP    `8888Y'
+ *
+ *
+ */
+/**
+ * This function will
+ *     take 2 flat objects baselineObject & compareObject
+ *     take array of strings to compare with baselineObject keys
+ *     take flagStyle which tells to include or ignore keys found in flagKeys
+ *
+ *     return compareKeysResult object back which gives all information regarding comparing the 2 objects
+ *
+ * @param baselineObject
+ * @param compareObject
+ * @param flagKeys
+ * @param flagStyle
+ * @param parseMe
+ */
+export function compareFlatObjects(baselineObject, compareObject, flagKeys, flagStyle) {
+    let identicalKeys = [];
+    let differentKeys = [];
+    let newKeys = [];
+    let isBaselineNull = false;
+    let compareKeysResult = getListOfKeysToCompare(baselineObject, flagKeys, flagStyle);
+    if (compareKeysResult.success === false) {
+        isBaselineNull = true;
+        compareKeysResult = getListOfKeysToCompare(compareObject, flagKeys, flagStyle);
+    }
+    compareKeysResult.keyChanges = getKeyChanges(baselineObject, compareKeysResult.compareKeys, compareObject, false);
+    //Get identical keys
+    compareKeysResult.compareKeys.map(compareKey => {
+        if (Object.keys(compareKeysResult.keyChanges).indexOf(compareKey) > -1) {
+            differentKeys.push(compareKey);
+        }
+        else {
+            identicalKeys.push(compareKey);
+        }
+    });
+    //Get newKeys not in the baselineObject
+    if (baselineObject && compareObject) {
+        //Only do this if baseline object exists
+        Object.keys(compareObject).map(oldKey => {
+            if (Object.keys(baselineObject).indexOf(oldKey) === -1) {
+                newKeys.push(oldKey);
+            }
+        });
+    }
+    else {
+        //If baseline object does not exist, newKeys is really all the keys in the compareObject
+        newKeys = compareKeysResult.compareKeys;
+    }
+    compareKeysResult.identicalKeys = identicalKeys;
+    compareKeysResult.differentKeys = differentKeys;
+    compareKeysResult.newKeys = newKeys;
+    return compareKeysResult;
+}
+/***
+ *     d888b  d88888b d888888b      db      d888888b .d8888. d888888b       .d88b.  d88888b
+ *    88' Y8b 88'     `~~88~~'      88        `88'   88'  YP `~~88~~'      .8P  Y8. 88'
+ *    88      88ooooo    88         88         88    `8bo.      88         88    88 88ooo
+ *    88  ooo 88~~~~~    88         88         88      `Y8b.    88         88    88 88~~~
+ *    88. ~8~ 88.        88         88booo.   .88.   db   8D    88         `8b  d8' 88
+ *     Y888P  Y88888P    YP         Y88888P Y888888P `8888Y'    YP          `Y88P'  YP
+ *
+ *
+ *    db   dD d88888b db    db .d8888.      d888888b  .d88b.        .o88b.  .d88b.  .88b  d88. d8888b.  .d8b.  d8888b. d88888b
+ *    88 ,8P' 88'     `8b  d8' 88'  YP      `~~88~~' .8P  Y8.      d8P  Y8 .8P  Y8. 88'YbdP`88 88  `8D d8' `8b 88  `8D 88'
+ *    88,8P   88ooooo  `8bd8'  `8bo.           88    88    88      8P      88    88 88  88  88 88oodD' 88ooo88 88oobY' 88ooooo
+ *    88`8b   88~~~~~    88      `Y8b.         88    88    88      8b      88    88 88  88  88 88~~~   88~~~88 88`8b   88~~~~~
+ *    88 `88. 88.        88    db   8D         88    `8b  d8'      Y8b  d8 `8b  d8' 88  88  88 88      88   88 88 `88. 88.
+ *    YP   YD Y88888P    YP    `8888Y'         YP     `Y88P'        `Y88P'  `Y88P'  YP  YP  YP 88      YP   YP 88   YD Y88888P
+ *
+ *
+ */
+/**
+ * This looks for keys of a data object based on an array of strings called flagKeys.
+ * It will return an array of actual keys from baselineObject that match the search criteria
+ * flagKeys example:  ['=Id','Date','By']
+ * baselineObject keys:  ['Id','id','UserId','Title','ModifiedDate','CreatedBy','Category1','SubCategory1']
+ *
+ * flagStyle = 'Include':  compareKeys = ['Id','ModifiedDate','CreatedBy'],
+ *    NOTE:  UserId would not be returned because criteria '=Id' will look for exact match.
+ *    id is not return because search is case sensitive
+ *
+ * flagStyle = 'Ignore':  compareKeys = ['id','UserId','Title','Category1','SubCategory1'],
+ *    NOTE:  Id is not included because this it will be ignored.  UserId is included because '=Id' looks for exact match
+ *    ModifiedDate && CreatedBy is excluded because setting is ignore for Date and By
+ *
+ * @param baselineObject
+ * @param flagKeys
+ * @param flagStyle
+ */
+export function getListOfKeysToCompare(baselineObject, flagKeys, flagStyle) {
+    let compareKeysResult = buildEmptyCompareResults([], flagStyle);
+    /**
+     * Identify keys to compare using flagKeys and flagStyle
+     */
+    if (baselineObject === null || baselineObject === undefined) {
+        compareKeysResult.success = false;
+    }
+    else {
+        /**
+         * Identify keys to compare using flagKeys and flagStyle
+         */
+        Object.keys(baselineObject).map(ObjectKey => {
+            let thisKeyMatchesFlags = false;
+            flagKeys.map(flagKey => {
+                let partialOrExact = flagKey.indexOf('=') === 0 ? 'Exact' : 'Partial';
+                let actualKey = partialOrExact === 'Exact' ? flagKey.substr(1) : flagKey;
+                if (partialOrExact === 'Partial' && ObjectKey.indexOf(actualKey) > -1) {
+                    thisKeyMatchesFlags = true;
+                }
+                if (partialOrExact === 'Exact' && ObjectKey === actualKey) {
+                    thisKeyMatchesFlags = true;
+                }
+            });
+            if (flagStyle === 'Include') {
+                if (thisKeyMatchesFlags === true) {
+                    compareKeysResult.compareKeys.push(ObjectKey);
+                }
+                else {
+                    compareKeysResult.ignoredKeys.push(ObjectKey);
+                }
+            }
+            else {
+                if (thisKeyMatchesFlags === true) {
+                    compareKeysResult.ignoredKeys.push(ObjectKey);
+                }
+                else {
+                    compareKeysResult.compareKeys.push(ObjectKey);
+                }
+            }
+        });
+    }
+    return compareKeysResult;
+}
+//# sourceMappingURL=compare.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../src/logic/Arrays/compare.ts"],"names":[],"mappings":"AACC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA6B1D,MAAM,UAAU,wBAAwB,CAAE,UAAoB,EAAE,SAA6B;IAE3F,IAAI,iBAAiB,GAAuB;QACxC,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,KAAK;KACjB,CAAC;IACF,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AAEF;;;;;;;;;;;;;GAaG;AACJ,MAAM,UAAU,kBAAkB,CAAE,cAAmB,EAAE,aAAmB,EAAE,QAAkB,EAAE,SAA2B;IAG3H,IAAI,aAAa,GAAa,EAAE,CAAC;IACjC,IAAI,aAAa,GAAa,EAAE,CAAC;IACjC,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,IAAI,iBAAiB,GAAuB,sBAAsB,CAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAE,CAAC;IAC1G,IAAK,iBAAiB,CAAC,OAAO,KAAK,KAAK,EAAG;QACvC,cAAc,GAAG,IAAI,CAAC;QACtB,iBAAiB,GAAG,sBAAsB,CAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAE,CAAC;KACpF;IAED,iBAAiB,CAAC,UAAU,GAAG,aAAa,CAAE,cAAc,EAAE,iBAAiB,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,CAAE,CAAC;IAEpH,oBAAoB;IACpB,iBAAiB,CAAC,WAAW,CAAC,GAAG,CAAE,UAAU,CAAC,EAAE;QAC9C,IAAK,MAAM,CAAC,IAAI,CAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,OAAO,CAAE,UAAU,CAAE,GAAG,CAAC,CAAC,EAAG;YAAE,aAAa,CAAC,IAAI,CAAE,UAAU,CAAE,CAAC;SAAE;aAAM;YAAE,aAAa,CAAC,IAAI,CAAE,UAAU,CAAE,CAAC;SAAE;IAC/J,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,IAAK,cAAc,IAAI,aAAa,EAAG;QACnC,wCAAwC;QACxC,MAAM,CAAC,IAAI,CAAE,aAAa,CAAE,CAAC,GAAG,CAAE,MAAM,CAAC,EAAE;YACvC,IAAK,MAAM,CAAC,IAAI,CAAE,cAAc,CAAE,CAAC,OAAO,CAAE,MAAM,CAAE,KAAK,CAAC,CAAC,EAAG;gBAAE,OAAO,CAAC,IAAI,CAAE,MAAM,CAAE,CAAE;aAAE;QAC5F,CAAC,CAAC,CAAC;KACR;SAAO;QACJ,wFAAwF;QACxF,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC;KAC3C;IAED,iBAAiB,CAAC,aAAa,GAAG,aAAa,CAAC;IAChD,iBAAiB,CAAC,aAAa,GAAG,aAAa,CAAC;IAChD,iBAAiB,CAAC,OAAO,GAAG,OAAO,CAAC;IAEpC,OAAO,iBAAiB,CAAC;AAE3B,CAAC;AAGD;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,UAAU,sBAAsB,CAAE,cAAmB,EAAE,QAAkB,EAAE,SAA2B;IAE1G,IAAI,iBAAiB,GAAuB,wBAAwB,CAAE,EAAE,EAAE,SAAS,CAAE,CAAC;IAEtF;;OAEG;IAEH,IAAK,cAAc,KAAK,IAAI,IAAI,cAAc,KAAK,SAAS,EAAG;QAC7D,iBAAiB,CAAC,OAAO,GAAG,KAAK,CAAC;KAEnC;SAAM;QACH;;WAEG;QAEH,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,CAAE,SAAS,CAAC,EAAE;YAEzC,IAAI,mBAAmB,GAAS,KAAK,CAAC;YACtC,QAAQ,CAAC,GAAG,CAAE,OAAO,CAAC,EAAE;gBACpB,IAAI,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBACtE,IAAI,SAAS,GAAG,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAEzE,IAAK,cAAc,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,CAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAG;oBAAE,mBAAmB,GAAG,IAAI,CAAC;iBAAE;gBACzG,IAAK,cAAc,KAAK,OAAO,IAAI,SAAS,KAAK,SAAS,EAAG;oBAAE,mBAAmB,GAAG,IAAI,CAAC;iBAAE;YAChG,CAAC,CAAC,CAAC;YAEH,IAAK,SAAS,KAAK,SAAS,EAAE;gBAC1B,IAAK,mBAAmB,KAAK,IAAI,EAAG;oBAChC,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAE,SAAS,CAAE,CAAE;iBAAE;qBAAM;oBAAE,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAE,SAAS,CAAC,CAAE;iBAC9G;aACJ;iBAAM;gBACH,IAAK,mBAAmB,KAAK,IAAI,EAAG;oBAChC,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAE,SAAS,CAAE,CAAE;iBAAE;qBAAM;oBAAE,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAE,SAAS,CAAC,CAAE;iBAC9G;aACJ;QACL,CAAC,CAAE,CAAE;KACR;IACD,OAAO,iBAAiB,CAAC;AAE3B,CAAC"}

package/lib/logic/Arrays/createArrayOfNumbers.d.ts

@@ -0,0 +1,5 @@
+export declare const Array0To7: number[];
+export declare const Array0To10: number[];
+export declare const Array0To20: number[];
+export declare function ZeroIndexNumbersTo(max: number): number[];
+//# sourceMappingURL=createArrayOfNumbers.d.ts.map

package/lib/logic/Arrays/createArrayOfNumbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArrayOfNumbers.d.ts","sourceRoot":"","sources":["../../../src/logic/Arrays/createArrayOfNumbers.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS,EAAE,MAAM,EAA4B,CAAC;AAC3D,eAAO,MAAM,UAAU,EAAE,MAAM,EAA6B,CAAC;AAC7D,eAAO,MAAM,UAAU,EAAE,MAAM,EAA6B,CAAC;AAE7D,wBAAgB,kBAAkB,CAAE,GAAG,EAAE,MAAM,GAAK,MAAM,EAAE,CAG3D"}

package/lib/logic/Arrays/createArrayOfNumbers.js

@@ -0,0 +1,8 @@
+export const Array0To7 = ZeroIndexNumbersTo(7);
+export const Array0To10 = ZeroIndexNumbersTo(10);
+export const Array0To20 = ZeroIndexNumbersTo(20);
+export function ZeroIndexNumbersTo(max) {
+    const idexes = Array.from({ length: (max + 1) }, (_, index) => index); //ChatGPT just to create an array of numbers
+    return idexes;
+}
+//# sourceMappingURL=createArrayOfNumbers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createArrayOfNumbers.js","sourceRoot":"","sources":["../../../src/logic/Arrays/createArrayOfNumbers.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,SAAS,GAAa,kBAAkB,CAAE,CAAC,CAAE,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAa,kBAAkB,CAAE,EAAE,CAAE,CAAC;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAa,kBAAkB,CAAE,EAAE,CAAE,CAAC;AAE7D,MAAM,UAAU,kBAAkB,CAAE,GAAW;IAC7C,MAAM,MAAM,GAAa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAE,GAAG,GAAG,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,4CAA4C;IAC/H,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/logic/Arrays/getDeepKeys.d.ts

@@ -0,0 +1,18 @@
+/**
+ * getDeepestSplits will take an array of strings like an array of deep object keys and return the set of keys at particular depth.
+ *  The point of the function is to get the deepest key of something like a deep object property for table heading labels for EasyAnalyticsHook.
+ *
+ * for instance deepKeys = [ 'a.b.c', 'w.x.y.z', '0.1.2.3.4.5' ]  and assuming delim = '.'
+ *
+ *    if idx === 0  : result: [ 'a','w','0' ]
+ *    if idx === 1  : result: [ 'b','x','1' ]
+ *    if idx === 2  : result: [ 'c','y','2' ]
+ *    if idx === 97 : result: [ 'c','z','5' ]
+ *
+ * @param deepKeys
+ * @param delim
+ * @param idx
+ * @returns
+ */
+export declare function getDeepestSplits(deepKeys: string[], delim?: string, idx?: number): string[];
+//# sourceMappingURL=getDeepKeys.d.ts.map

package/lib/logic/Arrays/getDeepKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeepKeys.d.ts","sourceRoot":"","sources":["../../../src/logic/Arrays/getDeepKeys.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAEH,wBAAgB,gBAAgB,CAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAY,EAAE,GAAG,GAAE,MAAW,GAAK,MAAM,EAAE,CAWvG"}

package/lib/logic/Arrays/getDeepKeys.js

@@ -0,0 +1,28 @@
+/**
+ * getDeepestSplits will take an array of strings like an array of deep object keys and return the set of keys at particular depth.
+ *  The point of the function is to get the deepest key of something like a deep object property for table heading labels for EasyAnalyticsHook.
+ *
+ * for instance deepKeys = [ 'a.b.c', 'w.x.y.z', '0.1.2.3.4.5' ]  and assuming delim = '.'
+ *
+ *    if idx === 0  : result: [ 'a','w','0' ]
+ *    if idx === 1  : result: [ 'b','x','1' ]
+ *    if idx === 2  : result: [ 'c','y','2' ]
+ *    if idx === 97 : result: [ 'c','z','5' ]
+ *
+ * @param deepKeys
+ * @param delim
+ * @param idx
+ * @returns
+ */
+export function getDeepestSplits(deepKeys, delim = '.', idx = 97) {
+    const keys = [];
+    // Only map if there is something to map
+    if (deepKeys && deepKeys.length > 0)
+        deepKeys.map((key) => {
+            const kS = key.split(delim);
+            const pos = Math.min(idx, kS.length - 1);
+            keys.push(kS[pos]);
+        });
+    return keys;
+}
+//# sourceMappingURL=getDeepKeys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDeepKeys.js","sourceRoot":"","sources":["../../../src/logic/Arrays/getDeepKeys.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,UAAU,gBAAgB,CAAE,QAAkB,EAAE,QAAgB,GAAG,EAAE,MAAc,EAAE;IAEzF,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,wCAAwC;IACxC,IAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAG,QAAQ,CAAC,GAAG,CAAE,CAAE,GAAW,EAAG,EAAE;YACrE,MAAM,EAAE,GAAa,GAAG,CAAC,KAAK,CAAE,KAAK,CAAE,CAAC;YACxC,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,CAAE,GAAG,EAAE,EAAE,CAAC,MAAM,GAAE,CAAC,CAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAE,EAAE,CAAE,GAAG,CAAE,CAAE,CAAC;QACzB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/logic/Arrays/grouping.d.ts

@@ -0,0 +1,57 @@
+import { ISimpleLink } from '../Links/interfaces/ISimpleLink';
+export interface IRailAnalytics {
+    'Title': string;
+    'PageLink': ISimpleLink;
+    'zzzText1': string;
+    'zzzText2': string;
+    'zzzText3': string;
+    'zzzText4': string;
+    'zzzText5': string;
+    'zzzText6': string;
+    'zzzText7': string;
+    'SiteLink': ISimpleLink;
+    'SiteTitle': string;
+    'TargetSite': ISimpleLink;
+    'Result': string;
+    'TargetList': ISimpleLink;
+    'ListTitle': string;
+    'zzzRichText1': string;
+    'zzzRichText2': string;
+    'zzzRichText3': string;
+    'zzzNumber4': number;
+    'zzzNumber5': number;
+    'getParams': string;
+    'Setting': string;
+    'Id'?: number;
+    'Created'?: any;
+    'Author'?: number;
+    'AuthorId'?: string;
+    'AuthorTitle'?: string;
+    'AuthorName'?: string;
+}
+export interface IArraySummaryGroup {
+    key: string;
+    items: IRailAnalytics[];
+    groupFilter: any;
+    localTime: string;
+}
+export interface IArraySummary {
+    keys: string[];
+    items: IRailAnalytics[];
+    groups: IArraySummaryGroup[];
+    filteredGroups: IArraySummaryGroup[];
+    filteredKeys: string[];
+}
+/**
+ *
+ * @param items
+ * @param keys
+ * @param keyDelim
+ * @param groupFilterKey
+ * @param groupItemOrderKey
+ * @param sort
+ * @param convertNullToEmpty  - Added for potential multi-lingual issues
+ * @param localLanguage
+ */
+export declare function groupArrayItemsByField(items: IRailAnalytics[], keys: string[], keyDelim: string, groupFilterKey: string, groupItemOrderKey: string, sort: 'asc' | 'dec', convertNullToEmpty?: boolean, localLanguage?: string): IArraySummary;
+//# sourceMappingURL=grouping.d.ts.map

package/lib/logic/Arrays/grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.d.ts","sourceRoot":"","sources":["../../../src/logic/Arrays/grouping.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAG9D,MAAM,WAAW,cAAc;IAE7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,WAAW,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,GAAG,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAE,KAAK,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,kBAAkB,GAAE,OAAe,EAAE,aAAa,GAAE,MAAa,GAAI,aAAa,CAqE5P"}

package/lib/logic/Arrays/grouping.js

@@ -0,0 +1,79 @@
+import { sortObjectArrayByStringKey, sortObjectArrayByStringKeyCollator } from './sorting/objects';
+/**
+ *
+ * @param items
+ * @param keys
+ * @param keyDelim
+ * @param groupFilterKey
+ * @param groupItemOrderKey
+ * @param sort
+ * @param convertNullToEmpty  - Added for potential multi-lingual issues
+ * @param localLanguage
+ */
+export function groupArrayItemsByField(items, keys, keyDelim, groupFilterKey, groupItemOrderKey, sort, convertNullToEmpty = false, localLanguage = 'en') {
+    let summary = {
+        keys: [],
+        items: [],
+        groups: [],
+        filteredGroups: [],
+        filteredKeys: [],
+    };
+    items.map(itemX => {
+        let item = itemX; //Added to remove typescript error
+        let thisKey = keys.map(key => { return item[key]; }).join(keyDelim);
+        let thisKey2 = item[keys[0]];
+        thisKey2 += keyDelim + item[keys[1]];
+        let keyIndex = summary.keys.indexOf(thisKey);
+        if (keyIndex < 0) {
+            summary.keys.push(thisKey);
+            keyIndex = summary.keys.length - 1;
+            let thisKeyBasic = thisKey.split('~');
+            let localTime = new Date(thisKeyBasic[0].replace(' ', '').trim());
+            localTime = localTime.toLocaleString();
+            summary.groups.push({ key: thisKey, items: [], groupFilter: null, localTime: localTime });
+            //Set the groupFilter which is intended to be an easy way to filter this group...
+            //For instance, the All items are pre-filtered by the site the item pertains to.
+            //The groupFilter could be the list in that site which the items in the group have in common
+            let filterKeys = groupFilterKey.split('.');
+            if (filterKeys.length === 1) {
+                summary.groups[keyIndex].groupFilter = item[groupFilterKey];
+            }
+            else {
+                summary.groups[keyIndex].groupFilter = item[filterKeys[0]][filterKeys[1]];
+            }
+        }
+        summary.groups[keyIndex].items.push(item);
+    });
+    if (groupItemOrderKey !== null && groupItemOrderKey !== undefined && groupItemOrderKey !== '') {
+        summary.groups.map(group => {
+            let okToSort = true;
+            group.items.map(itemX => {
+                let item = itemX; //Added to remove typescript error
+                if (item[groupItemOrderKey] === null) {
+                    okToSort = false;
+                }
+                else if (item[groupItemOrderKey] === undefined) {
+                    okToSort = false;
+                }
+            });
+            if (okToSort === true) {
+                let newItems = [];
+                if (localLanguage !== '') {
+                    newItems = sortObjectArrayByStringKeyCollator(group.items, sort, groupItemOrderKey, convertNullToEmpty, localLanguage);
+                }
+                else {
+                    newItems = sortObjectArrayByStringKey(group.items, sort, groupItemOrderKey);
+                }
+                group.items = newItems;
+            }
+            else {
+                console.log('Unable to sort this group of items... one of the keyValues was not valid.', group);
+            }
+        });
+    }
+    summary.filteredGroups = summary.groups;
+    summary.filteredKeys = summary.keys;
+    // console.log( 'History summary: ', summary );
+    return summary;
+}
+//# sourceMappingURL=grouping.js.map

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

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

package/lib/logic/Arrays/manipulation.d.ts

@@ -0,0 +1,127 @@
+/***
+ *     .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 declare function convertArrayToLC(arr: string[]): string[];
+export declare function expandArray(count: number): any[];
+/***
+ *    .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 declare function spliceCopyArray(sourceArray: any[], startDel: number, countDelete: number, startAddOrigPos: number, addArray: any[]): any[];
+/***
+ *     .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 declare function addItemToArrayIfItDoesNotExist(arr: string[], item: string, suppressUndefined?: boolean): string[];
+/***
+ *     .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 declare function convertNumberArrayToRelativePercents(arr: number[], percentsAsWholeNumbers?: boolean): number[];
+/***
+ *    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 declare function removeItemFromArrayOnce(arr: any[], value: any): any[];
+/***
+ *    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 declare function removeItemFromArrayAll(arr: any[], value: any): any[];
+/***
+*    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 declare function updateNextOpenIndex(targetArray: any[], start: number, value: any): any[];
+//# sourceMappingURL=manipulation.d.ts.map

package/lib/logic/Arrays/manipulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulation.d.ts","sourceRoot":"","sources":["../../../src/logic/Arrays/manipulation.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;EAaE;AAEF,wBAAgB,gBAAgB,CAAE,GAAG,EAAE,MAAM,EAAE,GAAK,MAAM,EAAE,CAG3D;AAED,wBAAgB,WAAW,CAAG,KAAK,EAAE,MAAM,GAAK,GAAG,EAAE,CAMpD;AAED;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACF,wBAAgB,eAAe,CAAC,WAAW,EAAG,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,SA2BrI;AAGD;;;;;;;;;GASG;AAEH,wBAAgB,8BAA8B,CAAE,GAAG,EAAG,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,GAAE,OAAc,GAAI,MAAM,EAAE,CAW1H;AAGD;;;;;;;;;;;;GAYG;AAEH,wBAAgB,oCAAoC,CAAE,GAAG,EAAE,MAAM,EAAE,EAAG,sBAAsB,GAAG,OAAc,GAAI,MAAM,EAAE,CAiBxH;AAID;;;;;;;;;;;GAWG;AAEH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAG,GAAG,GAAG,GAAG,EAAE,CAUtE;AAED;;;;;;;;;;GAUG;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAG,GAAG,GAAG,GAAG,EAAE,CAcrE;AAEA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AACH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAE,WAAW,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAI,GAAG,EAAE,CAWvF"}