@blackbyte/sugar 1.0.0-beta.28 → 1.0.0-beta.29

package/dist/shared/array/moveItem/moveItem.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @name                moveItem
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function allows you to move an item to another place in the array
+ *
+ * @param    {Array}          array       The array to process
+ * @param    {any|integer}    from        Either the element itself that you want to move, or the index of the element you want to move
+ * @param    {any|integer}    to          Either the element itself where you want to move the first one, or the index of the element you want to move your element to
+ * @return   {Array}                      The processed array
+ *
+ * @snippet         moveItem($1, $2, $3)
+ *
+ * @example    js
+ * import { moveItem } from '@blackbyte/sugar/array';
+ * const myArray = ['hello','world','something'];
+ * moveItem(myArray, 0, 1); // ['world','hello','something']
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function moveItem(arr: any[], from: any | number, to: any | number): any[];

package/dist/shared/array/moveItem/moveItem.js

@@ -0,0 +1,39 @@
+/**
+ * @name                moveItem
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function allows you to move an item to another place in the array
+ *
+ * @param    {Array}          array       The array to process
+ * @param    {any|integer}    from        Either the element itself that you want to move, or the index of the element you want to move
+ * @param    {any|integer}    to          Either the element itself where you want to move the first one, or the index of the element you want to move your element to
+ * @return   {Array}                      The processed array
+ *
+ * @snippet         moveItem($1, $2, $3)
+ *
+ * @example    js
+ * import { moveItem } from '@blackbyte/sugar/array';
+ * const myArray = ['hello','world','something'];
+ * moveItem(myArray, 0, 1); // ['world','hello','something']
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function moveItem(arr, from, to) {
+    if (typeof from !== 'number') {
+        from = arr.indexOf(from);
+    }
+    if (typeof to !== 'number') {
+        to = arr.indexOf(to);
+    }
+    if (from > to && to < arr.length) {
+        to++;
+    }
+    let item = arr.splice(from, 1)[0];
+    arr.splice(to, 0, item);
+    return arr;
+}
+//# sourceMappingURL=moveItem.js.map

package/dist/shared/array/moveItem/moveItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveItem.js","sourceRoot":"","sources":["../../../../src/shared/array/moveItem/moveItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,GAAU,EACV,IAAkB,EAClB,EAAgB;IAEhB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACjC,EAAE,EAAE,CAAC;IACP,CAAC;IAED,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shared/array/pickRandom/pickRandom.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name                pickRandom
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Pick a random item in the passed array
+ *
+ * @param       {Array}         array       The array from which to pick a random item
+ * @return      {Any}                       A random array item
+ *
+ * @snippet         pickRandom($1)
+ *
+ * @example         js
+ * import { pickRandom } from '@blackbyte/sugar/array';
+ * const array = ['hello','world'];
+ * pickRandom(array); // => 'world'
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function pickRandom(array: any[], count?: number): any;

package/dist/shared/array/pickRandom/pickRandom.js

@@ -0,0 +1,47 @@
+import unique from '../unique/unique.js';
+/**
+ * @name                pickRandom
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Pick a random item in the passed array
+ *
+ * @param       {Array}         array       The array from which to pick a random item
+ * @return      {Any}                       A random array item
+ *
+ * @snippet         pickRandom($1)
+ *
+ * @example         js
+ * import { pickRandom } from '@blackbyte/sugar/array';
+ * const array = ['hello','world'];
+ * pickRandom(array); // => 'world'
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function pickRandom(array, count = 1) {
+    // make the array unique
+    array = unique(array);
+    const items = [];
+    if (count > 1) {
+        if (count >= array.length) {
+            return array;
+        }
+        for (let i = 0; i < count; i++) {
+            let item = pickRandom(array, 1);
+            while (items.includes(item)) {
+                item = pickRandom(array, 1);
+            }
+            items.push(item);
+        }
+        return items;
+    }
+    else if (count === 1) {
+        return array[Math.round(Math.random() * (array.length - 1))];
+    }
+    return array;
+}
+//# sourceMappingURL=pickRandom.js.map

package/dist/shared/array/pickRandom/pickRandom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickRandom.js","sourceRoot":"","sources":["../../../../src/shared/array/pickRandom/pickRandom.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,qBAAqB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAY,EAAE,QAAgB,CAAC;IAChE,wBAAwB;IACxB,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtB,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9B,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;SAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/array/pickSome/pickSome.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @name            pickSome
+ * @namespace       shared.array
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * This returns you one or more random item of the passed array
+ *
+ * @param       {Any[]}        array            The array in which you want to pick a random item
+ * @param       {Number}       [$min=1]         The minimum number of items to pick
+ * @param       {Number}       [$max=null]      The maximum number of items to pick
+ * @return      {Any}                           The random array item(s)
+ *
+ * @snippet         pickSome($1,$2,$3);
+ *
+ * @example         ts
+ * import { pickSome } from '@blackbyte/sugar/array':
+ * pickSome(['hello','world','test'], 1, 2);
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function pickSome(array: any[], min?: number, max?: number): any[];

package/dist/shared/array/pickSome/pickSome.js

@@ -0,0 +1,50 @@
+/**
+ * @name            pickSome
+ * @namespace       shared.array
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * This returns you one or more random item of the passed array
+ *
+ * @param       {Any[]}        array            The array in which you want to pick a random item
+ * @param       {Number}       [$min=1]         The minimum number of items to pick
+ * @param       {Number}       [$max=null]      The maximum number of items to pick
+ * @return      {Any}                           The random array item(s)
+ *
+ * @snippet         pickSome($1,$2,$3);
+ *
+ * @example         ts
+ * import { pickSome } from '@blackbyte/sugar/array':
+ * pickSome(['hello','world','test'], 1, 2);
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function pickSome(array, min = 1, max) {
+    if (!max) {
+        max = array.length;
+    }
+    const availableIdx = [];
+    for (let i = 0; i < array.length; i++) {
+        availableIdx.push(i);
+    }
+    const picked = [];
+    while (true) {
+        if (picked.length >= max) {
+            break;
+        }
+        if (picked.length >= min && Math.round(Math.random())) {
+            break;
+        }
+        const idx = Math.floor(Math.random() * availableIdx.length);
+        picked.push(array[availableIdx[idx]]);
+        availableIdx.splice(idx, 1);
+        if (availableIdx.length === 0) {
+            break;
+        }
+    }
+    return picked;
+}
+//# sourceMappingURL=pickSome.js.map

package/dist/shared/array/pickSome/pickSome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickSome.js","sourceRoot":"","sources":["../../../../src/shared/array/pickSome/pickSome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAY,EAAE,MAAc,CAAC,EAAE,GAAY;IAC1E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACzB,MAAM;QACR,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM;QACR,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/array/proxyArray/proxyArray.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @name                proxyArray
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              beta
+ * @private
+ *
+ * This function override the passed array prototype to intercept changes made through
+ *
+ * @param         {Array}           array           The array to proxy
+ * @return        {Array}                           The same array with his prototype proxied
+ *
+ * @todo        tests
+ *
+ * @example       js
+ * import { proxyArray } from '@blackbyte/sugar/array';
+ * const myArray = proxyArray([1,2,3]);
+ * myArray.watch(['push','pop'], (watchObj) => {
+ *    // check the watchObj action
+ *    switch (watchObj.action) {
+ *      case 'push':
+ *        // do something...
+ *      break;
+ *    }
+ * });
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function proxyArray(array: any): any;

package/dist/shared/array/proxyArray/proxyArray.js

@@ -0,0 +1,144 @@
+// @ts-nocheck
+/**
+ * @name                proxyArray
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              beta
+ * @private
+ *
+ * This function override the passed array prototype to intercept changes made through
+ *
+ * @param         {Array}           array           The array to proxy
+ * @return        {Array}                           The same array with his prototype proxied
+ *
+ * @todo        tests
+ *
+ * @example       js
+ * import { proxyArray } from '@blackbyte/sugar/array';
+ * const myArray = proxyArray([1,2,3]);
+ * myArray.watch(['push','pop'], (watchObj) => {
+ *    // check the watchObj action
+ *    switch (watchObj.action) {
+ *      case 'push':
+ *        // do something...
+ *      break;
+ *    }
+ * });
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function proxyArray(array) {
+    if (array.__$proxied)
+        return array;
+    const watchStack = {};
+    // mark that this array has already been proxied
+    Object.defineProperty(array, '__$proxied', {
+        value: true,
+        enumerable: false,
+        writable: false,
+    });
+    function _proxyMethod(name, ...args) {
+        const handlersStack = [];
+        Object.keys(watchStack).forEach((watchId) => {
+            const watch = watchStack[watchId];
+            if (watch.methods.indexOf(name) === -1)
+                return;
+            handlersStack.push({
+                handlerFn: watch.handlerFn,
+                watchObj: {
+                    oldValue: [...array],
+                    action: `${name}`,
+                    fullAction: `Array.${name}`,
+                    args,
+                },
+            });
+        });
+        const returnValue = Array.prototype[name].call(array, ...args);
+        handlersStack.forEach((handlerObj) => {
+            handlerObj.watchObj = Object.assign(Object.assign({}, handlerObj.watchObj), { value: array, returnedValue: returnValue });
+            handlerObj.handlerFn(handlerObj.watchObj);
+        });
+        return returnValue;
+    }
+    Object.getOwnPropertyNames(Array.prototype).forEach((methodName) => {
+        const unProxyMethods = ['length', 'constructor'];
+        if (unProxyMethods.indexOf(methodName) !== -1)
+            return;
+        Object.defineProperty(array, methodName, {
+            writable: false,
+            configurable: false,
+            enumerable: false,
+            value: (...args) => {
+                return _proxyMethod(methodName, ...args);
+            },
+        });
+    });
+    /**
+     * @name                    watch
+     * @type                    Function
+     *
+     * This method allows you to specify which Array methods you want to watch by passing an array of methods names like ['push','pop'].
+     * You can also specify the handler function that will be called on each array updates, etc...
+     *
+     * @param         {Array|String}          methods               The methods you want to watch
+     * @param         {Function}              handler               The function that will be called on each updates. This function will be called with an object as parameters. Here's the list of properties available:
+     * - method (null) {String}: The method name that causes the watch emit
+     * - args ([]) {Array}: An array of all the arguments passed to the method call
+     * - oldValue (null) {Array}: The array just before the method call
+     * - value (null) {Array}: The array after the method call
+     * - returnedValue (null) {Mixed}: This is the value that the method call has returned
+     * @return        {String}                                    Return a uniq watchid that you can use to unwatch this process
+     *
+     * @example         js
+     * const watchId = myProxiedArray.watch(['push', 'pop'], (watchObj) => {
+     *    // do something...
+     * });
+     *
+     * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+     */
+    Object.defineProperty(array, 'watch', {
+        writable: false,
+        configurable: false,
+        enumerable: false,
+        value: (methods, handlerFn) => {
+            // create a watch id that we send back to the caller
+            const watchId = `s-${Date.now()}-${Math.round(Math.random() * 9999999999999)}`;
+            // append this watch process
+            watchStack[watchId] = {
+                methods,
+                handlerFn,
+            };
+            // return the watchId to be able to unwatcn this watch process
+            return watchId;
+        },
+    });
+    /**
+     * @name                  unwatch
+     * @type                  Function
+     *
+     * This methods allows you to unwatch a process started with the "watch" method.
+     * You have to pass as parameter the watchId that the "watch" method has returned you.
+     *
+     * @param       {String}          watchId         The watchId returned by the "watch" method
+     *
+     * @example       js
+     * const watchId = myArray.watch('push', (obj) => //...);
+     * myArray.unwatch(watchId);
+     *
+     * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+     */
+    Object.defineProperty(array, 'unwatch', {
+        writable: false,
+        configurable: false,
+        enumerable: false,
+        value: (watchId) => {
+            // delete the watch process
+            delete watchStack[watchId];
+        },
+    });
+    // return the processed array
+    return array;
+}
+//# sourceMappingURL=proxyArray.js.map

package/dist/shared/array/proxyArray/proxyArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxyArray.js","sourceRoot":"","sources":["../../../../src/shared/array/proxyArray/proxyArray.ts"],"names":[],"mappings":"AAAA,cAAc;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAK;IACtC,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,UAAU,GAAG,EAAE,CAAC;IAEtB,gDAAgD;IAChD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE;QACzC,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,SAAS,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI;QACjC,MAAM,aAAa,GAAG,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO;YAC/C,aAAa,CAAC,IAAI,CAAC;gBACjB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,QAAQ,EAAE;oBACR,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC;oBACpB,MAAM,EAAE,GAAG,IAAI,EAAE;oBACjB,UAAU,EAAE,SAAS,IAAI,EAAE;oBAC3B,IAAI;iBACL;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QAE/D,aAAa,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YACnC,UAAU,CAAC,QAAQ,mCACd,UAAU,CAAC,QAAQ,KACtB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,WAAW,GAC3B,CAAC;YACF,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACjE,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjD,IAAI,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO;QACtD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE;YACvC,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;gBACjB,OAAO,YAAY,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;QACpC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE;YAC5B,oDAAoD;YACpD,MAAM,OAAO,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAC3C,IAAI,CAAC,MAAM,EAAE,GAAG,aAAa,CAC9B,EAAE,CAAC;YACJ,4BAA4B;YAC5B,UAAU,CAAC,OAAO,CAAC,GAAG;gBACpB,OAAO;gBACP,SAAS;aACV,CAAC;YACF,8DAA8D;YAC9D,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IAEH;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE;QACtC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,2BAA2B;YAC3B,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC,CAAC;IAEH,6BAA6B;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/array/sameItems/sameItems.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            sameItems
+ * @namespace       shared.array
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status           beta
+ *
+ * This function take two arrays and return all the items that are the same.
+ * You can specify if you want only comparing by reference for object, etc... or if
+ * you want to transform items in hashes and compare that instead.
+ *
+ * @param       {Array}         ...arrays               The arrays you want to compare
+ * @param       {Object}        [settings={}]           Some settings to refine your comparaison process
+ * @return      {Array}                                 An array containing all the items that are present in all the passed arrays
+ *
+ * @setting         {Boolean}          [references=true]        Specify if you want to use the references comparaison or not
+ * @setting         {Boolean}           [hash=true]             Specify if you want to allows transforming object etc in to hashes and compare this instead
+ *
+ * @snippet         sameItems($1, $2)
+ *
+ * @example         js
+ * import { sameItems } from '@blackbyte/sugar/array';
+ * sameItems([1,2,3,4], [1,3,5]); // => [1,3]
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function sameItems(...args: any[]): any[];

package/dist/shared/array/sameItems/sameItems.js

@@ -0,0 +1,69 @@
+import { base64 } from '@blackbyte/sugar/crypto';
+import { isPlainObject } from '@blackbyte/sugar/is';
+import unique from '../unique/unique.js';
+/**
+ * @name            sameItems
+ * @namespace       shared.array
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status           beta
+ *
+ * This function take two arrays and return all the items that are the same.
+ * You can specify if you want only comparing by reference for object, etc... or if
+ * you want to transform items in hashes and compare that instead.
+ *
+ * @param       {Array}         ...arrays               The arrays you want to compare
+ * @param       {Object}        [settings={}]           Some settings to refine your comparaison process
+ * @return      {Array}                                 An array containing all the items that are present in all the passed arrays
+ *
+ * @setting         {Boolean}          [references=true]        Specify if you want to use the references comparaison or not
+ * @setting         {Boolean}           [hash=true]             Specify if you want to allows transforming object etc in to hashes and compare this instead
+ *
+ * @snippet         sameItems($1, $2)
+ *
+ * @example         js
+ * import { sameItems } from '@blackbyte/sugar/array';
+ * sameItems([1,2,3,4], [1,3,5]); // => [1,3]
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function sameItems(...args) {
+    var _a, _b, _c;
+    const arrays = args.filter((arg) => Array.isArray(arg));
+    const settings = Object.assign({ references: true, hash: true }, ((_a = args.filter((arg) => isPlainObject(arg))[0]) !== null && _a !== void 0 ? _a : {}));
+    if (arrays.length > 2) {
+        let newArray = arrays[0];
+        arrays.forEach((currentArray) => {
+            newArray = sameItems(newArray, currentArray, settings);
+        });
+        return unique(newArray);
+    }
+    else {
+        const array1 = (_b = arrays[0]) !== null && _b !== void 0 ? _b : [], array2 = (_c = arrays[1]) !== null && _c !== void 0 ? _c : [];
+        const sameArray = [];
+        array1.forEach((array1Item) => {
+            let array1ItemHash = array1Item;
+            if (typeof array1Item !== 'string' && settings.hash) {
+                array1ItemHash = base64.encrypt(array1Item);
+            }
+            array2.forEach((array2Item) => {
+                let array2ItemHash = array2Item;
+                if (typeof array2Item !== 'string' && settings.hash) {
+                    array2ItemHash = base64.encrypt(array2Item);
+                    if (array1ItemHash === array2ItemHash) {
+                        sameArray.push(array1Item);
+                        return;
+                    }
+                }
+                else if (array1Item === array2Item) {
+                    sameArray.push(array1Item);
+                    return;
+                }
+            });
+        });
+        return unique(sameArray);
+    }
+}
+//# sourceMappingURL=sameItems.js.map

package/dist/shared/array/sameItems/sameItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sameItems.js","sourceRoot":"","sources":["../../../../src/shared/array/sameItems/sameItems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,MAAM,MAAM,qBAAqB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,GAAG,IAAI;;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,mBACZ,UAAU,EAAE,IAAI,EAChB,IAAI,EAAE,IAAI,IACP,CAAC,MAAA,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC,CACvD,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAEzB,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YAC9B,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,mCAAI,EAAE,EAC5B,MAAM,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC;QAE3B,MAAM,SAAS,GAAU,EAAE,CAAC;QAE5B,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC5B,IAAI,cAAc,GAAG,UAAU,CAAC;YAChC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC5B,IAAI,cAAc,GAAG,UAAU,CAAC;gBAChC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACpD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAC5C,IAAI,cAAc,KAAK,cAAc,EAAE,CAAC;wBACtC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;wBAC3B,OAAO;oBACT,CAAC;gBACH,CAAC;qBAAM,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;oBACrC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC3B,OAAO;gBACT,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/shared/array/splitEvery/splitEvery.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name                splitEvery
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Split an array every N items
+ *
+ * @param           {Array}           array               The array to split
+ * @param           {Number}          every               Every how many items to split the array
+ * @return          {Array}                               An array of arrays splited
+ *
+ * @snippet         splitEvery($1, $2)
+ *
+ * @example           js
+ * import { splitEvery } from '@blackbyte/sugar/array';
+ * splitEvery([1,2,3,4,5,6,7,8,9], 3);
+ * // [[1,2,3],[4,5,6],[7,8,9]]
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function splitEvery(array: any[], every: number): any[];

package/dist/shared/array/splitEvery/splitEvery.js

@@ -0,0 +1,32 @@
+/**
+ * @name                splitEvery
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Split an array every N items
+ *
+ * @param           {Array}           array               The array to split
+ * @param           {Number}          every               Every how many items to split the array
+ * @return          {Array}                               An array of arrays splited
+ *
+ * @snippet         splitEvery($1, $2)
+ *
+ * @example           js
+ * import { splitEvery } from '@blackbyte/sugar/array';
+ * splitEvery([1,2,3,4,5,6,7,8,9], 3);
+ * // [[1,2,3],[4,5,6],[7,8,9]]
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function splitEvery(array, every) {
+    let i, j;
+    const finalArray = [];
+    for (i = 0, j = array.length; i < j; i += every) {
+        finalArray.push(array.slice(i, i + every));
+    }
+    return finalArray;
+}
+//# sourceMappingURL=splitEvery.js.map

package/dist/shared/array/splitEvery/splitEvery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitEvery.js","sourceRoot":"","sources":["../../../../src/shared/array/splitEvery/splitEvery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAY,EAAE,KAAa;IAC5D,IAAI,CAAS,EAAE,CAAS,CAAC;IACzB,MAAM,UAAU,GAAU,EAAE,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/shared/array/unique/unique.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @name                unique
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function simply take an array as parameter and return a new one
+ * with all the duplicates values removed.
+ *
+ * @param         {Array}         array               The array to deduplicates
+ * @return        {Array}                             The deduplicated array
+ *
+ * @snippet        unique($1)
+ *
+ * @example        js
+ * import { unique } from '@blackbyte/sugar/array';
+ * unique(['hello','world','hello','world']); // => ['hello','world']
+ *
+ * @changelog     1.0.0-beta.2
+ * Add the "stringify" option to compare objects in string format
+ *
+ * @since         1.0.0
+ * @author        Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TUniqueSettings = {
+    stringify: boolean;
+};
+export default function unique(array: any[], settings?: Partial<TUniqueSettings>): any[];

package/dist/shared/array/unique/unique.js

@@ -0,0 +1,24 @@
+import { isPlainObject } from '@blackbyte/sugar/is';
+export default function unique(array, settings) {
+    const finalSettings = Object.assign({ stringify: false }, (settings !== null && settings !== void 0 ? settings : {}));
+    const a = array.concat();
+    for (let i = 0; i < a.length; ++i) {
+        for (let j = i + 1; j < a.length; ++j) {
+            let valueA = a[i], valueB = a[j];
+            // handle "stringify" option
+            if (finalSettings.stringify) {
+                if (isPlainObject(valueA)) {
+                    valueA = JSON.stringify(valueA);
+                }
+                if (isPlainObject(valueB)) {
+                    valueB = JSON.stringify(valueB);
+                }
+            }
+            if (valueA === valueB) {
+                a.splice(j--, 1);
+            }
+        }
+    }
+    return a;
+}
+//# sourceMappingURL=unique.js.map

package/dist/shared/array/unique/unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.js","sourceRoot":"","sources":["../../../../src/shared/array/unique/unique.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgCpD,MAAM,CAAC,OAAO,UAAU,MAAM,CAC5B,KAAY,EACZ,QAAmC;IAEnC,MAAM,aAAa,mBACjB,SAAS,EAAE,KAAK,IACb,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EACf,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAEhB,4BAA4B;YAC5B,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;gBAC5B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClC,CAAC;gBACD,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/shared/class/_exports.d.ts

@@ -1,7 +1,7 @@
-import cloneClass from './cloneClass.js';
-import getExtendsStack from './getExtendsStack.js';
-import getMethods from './getMethods.js';
-import methodExists from './methodExists.js';
-import multipleExtends from './multipleExtends.js';
-import toPlainObject from './toPlainObject.js';
+import cloneClass from './cloneClass/cloneClass.js';
+import getExtendsStack from './getExtendsStack/getExtendsStack.js';
+import getMethods from './getMethods/getMethods.js';
+import methodExists from './methodExists/methodExists.js';
+import multipleExtends from './multipleExtends/multipleExtends.js';
+import toPlainObject from './toPlainObject/toPlainObject.js';
 export { cloneClass as __cloneClass, getExtendsStack as __getExtendsStack, getMethods as __getMethods, methodExists as __methodExists, multipleExtends as __multipleExtends, toPlainObject as __toPlainObject, cloneClass, getExtendsStack, getMethods, methodExists, multipleExtends, toPlainObject, };