@blackbyte/sugar 1.0.0-beta.1

package/dist/shared/class/methodExists.js

@@ -0,0 +1,39 @@
+/**
+ * @name                methodExists
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Check if one or more methods exists on a class instance
+ *
+ * @param           {Object}                instance              The instance to check the methods on
+ * @param           {String[]}              methods               The methods to check
+ * @return          {Boolean|Array}                               Return true if all is ok, and an array of missing methods if not
+ *
+ * @todo      tests
+ *
+ * @snippet         methodExists($1)
+ *
+ * @example           js
+ * class Coco {
+ *    hello() {}
+ * }
+ * import { methodExists } from '@blackbyte/sugar/class';
+ * const myInstance = new Coco();
+ * methodExists(myInstance, 'hello', 'world'); // => ['world'];
+ * methodExists(myInstance, 'hello'); // => true
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function methodExists(instance, methods) {
+    const missingMethodsArray = [];
+    methods.forEach((method) => {
+        if (typeof instance[method] !== 'function')
+            missingMethodsArray.push(method);
+    });
+    return !missingMethodsArray.length ? true : missingMethodsArray;
+}
+//# sourceMappingURL=methodExists.js.map

package/dist/shared/class/methodExists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodExists.js","sourceRoot":"","sources":["../../../src/shared/class/methodExists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,QAAa,EACb,OAAiB;IAEjB,MAAM,mBAAmB,GAAa,EAAE,CAAC;IACzC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,UAAU;YACxC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAClE,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * @name                multipleExtends
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              alpha
+ *
+ * This function allows you to extends your class with multiple other ones.
+ *
+ * @param     {Class}           ...classes          All the classed you want to extend the first one with
+ *
+ * @todo      tests
+ *
+ * @snippet         multipleExtends($1, $2)
+ *
+ * @example         js
+ * import { multipleExtends } from '@blackbyte/sugar/class';
+ * class MyCoolClass extends multipleExtends(Another, AnotherOne) {
+ * }
+ *
+ * @see       https://www.npmjs.com/package/aggregation
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function (...classes: any[]): any;

package/dist/shared/class/multipleExtends.js

@@ -0,0 +1,30 @@
+import __aggregation from 'aggregation/es5.js';
+/**
+ * @name                multipleExtends
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              alpha
+ *
+ * This function allows you to extends your class with multiple other ones.
+ *
+ * @param     {Class}           ...classes          All the classed you want to extend the first one with
+ *
+ * @todo      tests
+ *
+ * @snippet         multipleExtends($1, $2)
+ *
+ * @example         js
+ * import { multipleExtends } from '@blackbyte/sugar/class';
+ * class MyCoolClass extends multipleExtends(Another, AnotherOne) {
+ * }
+ *
+ * @see       https://www.npmjs.com/package/aggregation
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function (...classes) {
+    return __aggregation(...classes);
+}
+//# sourceMappingURL=multipleExtends.js.map

package/dist/shared/class/multipleExtends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipleExtends.js","sourceRoot":"","sources":["../../../src/shared/class/multipleExtends.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,WAAW,GAAG,OAAO;IACjC,OAAO,aAAa,CAAC,GAAG,OAAO,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * @name                toPlainObject
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function take a instance as parameter and return a plain object of it
+ *
+ * @param               {Mixed}               instance                Any class instance to transform into a plain object
+ * @return              {Object}                                      A plain object version of the the class instance
+ *
+ * @todo      tests
+ *
+ * @snippet         toPlainObject($1)
+ *
+ * @example             js
+ * import { toPlainObject } from '@blackbyte/sugar/class';
+ * class Coco {
+ *    constructor() {
+ *      this.hello = 'world';
+ *    }
+ * }
+ * toPlainObject(new Coco()); // => { hello: 'world' }
+ *
+ * @since       1.0.0
+ * @author 		Olivier Bossel<olivier.bossel@gmail.com>
+ */
+export default function toPlainObject(theClass: any): any;

package/dist/shared/class/toPlainObject.js

@@ -0,0 +1,38 @@
+/**
+ * @name                toPlainObject
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function take a instance as parameter and return a plain object of it
+ *
+ * @param               {Mixed}               instance                Any class instance to transform into a plain object
+ * @return              {Object}                                      A plain object version of the the class instance
+ *
+ * @todo      tests
+ *
+ * @snippet         toPlainObject($1)
+ *
+ * @example             js
+ * import { toPlainObject } from '@blackbyte/sugar/class';
+ * class Coco {
+ *    constructor() {
+ *      this.hello = 'world';
+ *    }
+ * }
+ * toPlainObject(new Coco()); // => { hello: 'world' }
+ *
+ * @since       1.0.0
+ * @author 		Olivier Bossel<olivier.bossel@gmail.com>
+ */
+export default function toPlainObject(theClass) {
+    const originalClass = theClass || {};
+    const keys = Object.getOwnPropertyNames(originalClass);
+    return keys.reduce((classAsObj, key) => {
+        classAsObj[key] = originalClass[key];
+        return classAsObj;
+    }, {});
+}
+//# sourceMappingURL=toPlainObject.js.map

package/dist/shared/class/toPlainObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toPlainObject.js","sourceRoot":"","sources":["../../../src/shared/class/toPlainObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,QAAa;IACjD,MAAM,aAAa,GAAG,QAAQ,IAAI,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE;QACrC,UAAU,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

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

@@ -0,0 +1,14 @@
+import alphaToHex from './alphaToHex.js';
+import convertColor from './convertColor.js';
+import hexToRgba from './hexToRgba.js';
+import hslaToHex from './hslaToHex.js';
+import hslaToHexa from './hslaToHexa.js';
+import hslaToRgba from './hslaToRgba.js';
+import parseColor from './parseColor.js';
+import parseHsla from './parseHsla.js';
+import parseRgba from './parseRgba.js';
+import rgbaToHex from './rgbaToHex.js';
+import rgbaToHsla from './rgbaToHsla.js';
+export { alphaToHex as __alphaToHex, // alias for backward compatibility
+convertColor as __convert, convertColor as __convertColor, // alias for backward compatibility
+hexToRgba as __hexToRgba, hslaToHex as __hslaToHex, hslaToHexa as __hslaToHexa, hslaToRgba as __hslaToRgba, parseColor as __parseColor, parseHsla as __parseHsla, parseRgba as __parseRgba, rgbaToHex as __rgbaToHex, rgbaToHsla as __rgbaToHsla, alphaToHex, convertColor as convert, convertColor, hexToRgba, hslaToHex, hslaToHexa, hslaToRgba, parseColor, parseHsla, parseRgba, rgbaToHex, rgbaToHsla, };

package/dist/shared/color/_exports.js

@@ -0,0 +1,15 @@
+import alphaToHex from './alphaToHex.js';
+import convertColor from './convertColor.js';
+import hexToRgba from './hexToRgba.js';
+import hslaToHex from './hslaToHex.js';
+import hslaToHexa from './hslaToHexa.js';
+import hslaToRgba from './hslaToRgba.js';
+import parseColor from './parseColor.js';
+import parseHsla from './parseHsla.js';
+import parseRgba from './parseRgba.js';
+import rgbaToHex from './rgbaToHex.js';
+import rgbaToHsla from './rgbaToHsla.js';
+export { alphaToHex as __alphaToHex, // alias for backward compatibility
+convertColor as __convert, convertColor as __convertColor, // alias for backward compatibility
+hexToRgba as __hexToRgba, hslaToHex as __hslaToHex, hslaToHexa as __hslaToHexa, hslaToRgba as __hslaToRgba, parseColor as __parseColor, parseHsla as __parseHsla, parseRgba as __parseRgba, rgbaToHex as __rgbaToHex, rgbaToHsla as __rgbaToHsla, alphaToHex, convertColor as convert, convertColor, hexToRgba, hslaToHex, hslaToHexa, hslaToRgba, parseColor, parseHsla, parseRgba, rgbaToHex, rgbaToHsla, };
+//# sourceMappingURL=_exports.js.map

package/dist/shared/color/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/color/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EACL,UAAU,IAAI,YAAY,EAAE,mCAAmC;AAC/D,YAAY,IAAI,SAAS,EACzB,YAAY,IAAI,cAAc,EAAE,mCAAmC;AACnE,SAAS,IAAI,WAAW,EACxB,SAAS,IAAI,WAAW,EACxB,UAAU,IAAI,YAAY,EAC1B,UAAU,IAAI,YAAY,EAC1B,UAAU,IAAI,YAAY,EAC1B,SAAS,IAAI,WAAW,EACxB,SAAS,IAAI,WAAW,EACxB,SAAS,IAAI,WAAW,EACxB,UAAU,IAAI,YAAY,EAC1B,UAAU,EACV,YAAY,IAAI,OAAO,EACvB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,GACX,CAAC"}

package/dist/shared/color/alphaToHex.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @name                alphaToHex
+ * @namespace           shared.color
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Take alpha (0-1) and convert it to hex like "FF", "80", etc...
+ *
+ * @param       {Number}            alpha           The alpha to convert to hex (0-1)
+ * @return          {String}                        The hex string
+ *
+ * @todo      tests
+ *
+ * @snippet         alphaToHex($1)
+ *
+ * @example         js
+ * import { alphaToHex } from '@blackbyte/sugar/color';
+ * alphaToHex(1); // FF
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function alphaToHex(alpha: number): string;

package/dist/shared/color/alphaToHex.js

@@ -0,0 +1,29 @@
+/**
+ * @name                alphaToHex
+ * @namespace           shared.color
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Take alpha (0-1) and convert it to hex like "FF", "80", etc...
+ *
+ * @param       {Number}            alpha           The alpha to convert to hex (0-1)
+ * @return          {String}                        The hex string
+ *
+ * @todo      tests
+ *
+ * @snippet         alphaToHex($1)
+ *
+ * @example         js
+ * import { alphaToHex } from '@blackbyte/sugar/color';
+ * alphaToHex(1); // FF
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function alphaToHex(alpha) {
+    const _opacity = Math.round(Math.min(Math.max(alpha || 1, 0), 1) * 255);
+    return _opacity.toString(16);
+}
+//# sourceMappingURL=alphaToHex.js.map

package/dist/shared/color/alphaToHex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphaToHex.js","sourceRoot":"","sources":["../../../src/shared/color/alphaToHex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAa;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC"}

package/dist/shared/color/convert.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @name                    convert
+ * @namespace               shared.color
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * This function take as input any color format like rgba Object, hsl Object, hsv Object, hex String, rgba String, hsl String or hsv String
+ * and convert it into the wanted format like "rgba", "hsl", "hsv", "hex", "rgbaString", "hslString" or "hsvString"
+ *
+ * @param           {Mixed}               input           The input color to convert
+ * @param           {String}              [format="rgba"]     The format wanted
+ * @return          {Mixed}                               The converted color
+ *
+ * @todo      tests
+ *
+ * @snippet         convert($1, $2)
+ *
+ * @example         js
+ * import { convert } from '@blackbyte/sugar/color';
+ * convert('rgba(10,20,30,100)', 'rgba'); // => { r: 10, g: 20, b: 30, a: 100 }
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function convert(input: any, format?: string): string | object;

package/dist/shared/color/convert.js

@@ -0,0 +1,82 @@
+import hslaToRgba from './hslaToRgba.js';
+import parseColor from './parseColor.js';
+import rgbaToHex from './rgbaToHex.js';
+import rgbaToHsla from './rgbaToHsla.js';
+/**
+ * @name                    convert
+ * @namespace               shared.color
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * This function take as input any color format like rgba Object, hsl Object, hsv Object, hex String, rgba String, hsl String or hsv String
+ * and convert it into the wanted format like "rgba", "hsl", "hsv", "hex", "rgbaString", "hslString" or "hsvString"
+ *
+ * @param           {Mixed}               input           The input color to convert
+ * @param           {String}              [format="rgba"]     The format wanted
+ * @return          {Mixed}                               The converted color
+ *
+ * @todo      tests
+ *
+ * @snippet         convert($1, $2)
+ *
+ * @example         js
+ * import { convert } from '@blackbyte/sugar/color';
+ * convert('rgba(10,20,30,100)', 'rgba'); // => { r: 10, g: 20, b: 30, a: 100 }
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function convert(input, format = 'rgba') {
+    // transforming the input into rgba object
+    let rgbaObj = {};
+    if (typeof input === 'string') {
+        // @ts-ignore
+        rgbaObj = parseColor(input, 'rgba');
+    }
+    else if (typeof input === 'object') {
+        if (input.r !== undefined &&
+            input.g !== undefined &&
+            input.b !== undefined) {
+            rgbaObj = input;
+        }
+        else if (input.h !== undefined &&
+            input.s !== undefined &&
+            input.l !== undefined) {
+            rgbaObj = hslaToRgba(input.h, input.s, input.l);
+        }
+    }
+    const hslaObj = rgbaToHsla(rgbaObj.r, rgbaObj.g, rgbaObj.b, rgbaObj.a);
+    switch (format) {
+        case 'rgb':
+            return {
+                r: rgbaObj.r,
+                g: rgbaObj.g,
+                b: rgbaObj.b,
+            };
+        case 'rgbString':
+            return `rgb(${rgbaObj.r},${rgbaObj.g},${rgbaObj.b})`;
+        case 'rgba':
+            return rgbaObj;
+        case 'rgbaString':
+            return `rgba(${rgbaObj.r},${rgbaObj.g},${rgbaObj.b},${rgbaObj.a})`;
+        case 'hsl':
+            return {
+                h: hslaObj.h,
+                s: hslaObj.s,
+                l: hslaObj.l,
+            };
+        case 'hslString':
+            return `hsl(${hslaObj.h},${hslaObj.s},${hslaObj.l})`;
+        case 'hsla':
+            return hslaObj;
+        case 'hslaString':
+            return `hsla(${hslaObj.h},${hslaObj.s},${hslaObj.l},${hslaObj.a})`;
+        case 'hex':
+        case 'hexString':
+            return rgbaToHex(rgbaObj.r, rgbaObj.g, rgbaObj.b, rgbaObj.a);
+    }
+    throw new Error(`The requested "${format}" color format is not supported for now...`);
+}
+//# sourceMappingURL=convert.js.map

package/dist/shared/color/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/shared/color/convert.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAC7B,KAAU,EACV,SAAiB,MAAM;IAEvB,0CAA0C;IAC1C,IAAI,OAAO,GAAQ,EAAE,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,aAAa;QACb,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IACE,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS,EACrB,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,IACL,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS,EACrB,CAAC;YACD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEvE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO;gBACL,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;aACb,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,OAAO,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC;QACvD,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,QAAQ,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC;QACrE,KAAK,KAAK;YACR,OAAO;gBACL,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;aACb,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,OAAO,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC;QACvD,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,QAAQ,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC;QACrE,KAAK,KAAK,CAAC;QACX,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,4CAA4C,CACrE,CAAC;AACJ,CAAC"}

package/dist/shared/color/convertColor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @name                    convertColor
+ * @namespace               shared.color
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * This function take as input any color format like rgba Object, hsl Object, hsv Object, hex String, rgba String, hsl String or hsv String
+ * and convert it into the wanted format like "rgba", "hsl", "hsv", "hex", "rgbaString", "hslString" or "hsvString"
+ *
+ * @param           {Mixed}               input           The input color to convert
+ * @param           {String}              [format="rgba"]     The format wanted
+ * @return          {Mixed}                               The converted color
+ *
+ * @todo      tests
+ *
+ * @snippet         convertColor($1, $2)
+ *
+ * @example         js
+ * import { convertColor } from '@blackbyte/sugar/color';
+ * convertColor('rgba(10,20,30,100)', 'rgba'); // => { r: 10, g: 20, b: 30, a: 100 }
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function convertColor(input: any, format?: 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'hex'): string | object;

package/dist/shared/color/convertColor.js

@@ -0,0 +1,75 @@
+import hslaToRgba from './hslaToRgba.js';
+import parseColor from './parseColor.js';
+import rgbaToHex from './rgbaToHex.js';
+import rgbaToHsla from './rgbaToHsla.js';
+/**
+ * @name                    convertColor
+ * @namespace               shared.color
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * This function take as input any color format like rgba Object, hsl Object, hsv Object, hex String, rgba String, hsl String or hsv String
+ * and convert it into the wanted format like "rgba", "hsl", "hsv", "hex", "rgbaString", "hslString" or "hsvString"
+ *
+ * @param           {Mixed}               input           The input color to convert
+ * @param           {String}              [format="rgba"]     The format wanted
+ * @return          {Mixed}                               The converted color
+ *
+ * @todo      tests
+ *
+ * @snippet         convertColor($1, $2)
+ *
+ * @example         js
+ * import { convertColor } from '@blackbyte/sugar/color';
+ * convertColor('rgba(10,20,30,100)', 'rgba'); // => { r: 10, g: 20, b: 30, a: 100 }
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function convertColor(input, format = 'rgba') {
+    // transforming the input into rgba object
+    let rgbaObj = {};
+    if (typeof input === 'string') {
+        // @ts-ignore
+        rgbaObj = parseColor(input, 'rgba');
+    }
+    else if (typeof input === 'object') {
+        if (input.r !== undefined &&
+            input.g !== undefined &&
+            input.b !== undefined) {
+            rgbaObj = input;
+        }
+        else if (input.h !== undefined &&
+            input.s !== undefined &&
+            input.l !== undefined) {
+            rgbaObj = hslaToRgba(input.h, input.s, input.l);
+        }
+    }
+    const hslaObj = rgbaToHsla(rgbaObj.r, rgbaObj.g, rgbaObj.b, rgbaObj.a);
+    switch (format) {
+        case 'rgb':
+            return {
+                r: rgbaObj.r,
+                g: rgbaObj.g,
+                b: rgbaObj.b,
+                toString: () => `rgb(${rgbaObj.r}, ${rgbaObj.g}, ${rgbaObj.b})`,
+            };
+        case 'rgba':
+            return rgbaObj;
+        case 'hsl':
+            return {
+                h: hslaObj.h,
+                s: hslaObj.s,
+                l: hslaObj.l,
+                toString: () => `hsl(${hslaObj.h}, ${hslaObj.s}%, ${hslaObj.l}%)`,
+            };
+        case 'hsla':
+            return hslaObj;
+        case 'hex':
+            return rgbaToHex(rgbaObj.r, rgbaObj.g, rgbaObj.b, rgbaObj.a);
+    }
+    throw new Error(`The requested "${format}" color format is not supported for now...`);
+}
+//# sourceMappingURL=convertColor.js.map

package/dist/shared/color/convertColor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertColor.js","sourceRoot":"","sources":["../../../src/shared/color/convertColor.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,KAAU,EACV,SAAkD,MAAM;IAExD,0CAA0C;IAC1C,IAAI,OAAO,GAAQ,EAAE,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,aAAa;QACb,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IACE,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS,EACrB,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,IACL,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS;YACrB,KAAK,CAAC,CAAC,KAAK,SAAS,EACrB,CAAC;YACD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEvE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO;gBACL,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG;aAChE,CAAC;QACJ,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,KAAK;YACR,OAAO;gBACL,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,CAAC;gBACZ,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,IAAI;aAClE,CAAC;QACJ,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,4CAA4C,CACrE,CAAC;AACJ,CAAC"}

package/dist/shared/color/hexToRgba.d.ts

@@ -0,0 +1,9 @@
+interface IHexToToRbaResult {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+    toString: () => string;
+}
+export default function hexToRgba(hex: string): IHexToToRbaResult;
+export {};

package/dist/shared/color/hexToRgba.js

@@ -0,0 +1,47 @@
+// @ts-nocheck
+/**
+ * @name                    hexToRgba
+ * @namespace               shared.color
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * Hex to RGBA
+ *
+ * @param	              {string}       	hex         		The hex string to convert
+ * @return            	{object} 			                  The rgba object representation with a "toString" method
+ *
+ * @todo      tests
+ *
+ * @snippet         hexToRgba($1)
+ *
+ * @example         js
+ * import { hexToRgba } from '@blackbyte/sugar/color';
+ * hexToRgba('#ff00ff');
+ *
+ * @see         https://www.npmjs.com/package/colors-convert
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+function hexToRGBA(h) {
+    let r = 0, g = 0, b = 0;
+    // 3 digits
+    if (h.length == 4) {
+        r = '0x' + h[1] + h[1];
+        g = '0x' + h[2] + h[2];
+        b = '0x' + h[3] + h[3];
+        // 6 digits
+    }
+    else if (h.length == 7) {
+        r = '0x' + h[1] + h[2];
+        g = '0x' + h[3] + h[4];
+        b = '0x' + h[5] + h[6];
+    }
+    return { r, g, b, a: 1, toString: () => `rgba(${r}, ${g}, ${b}, 1)` };
+}
+export default function hexToRgba(hex) {
+    // return hexToRgba(hex, 1);
+    return hexToRGBA(hex);
+}
+//# sourceMappingURL=hexToRgba.js.map

package/dist/shared/color/hexToRgba.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hexToRgba.js","sourceRoot":"","sources":["../../../src/shared/color/hexToRgba.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAS,SAAS,CAAC,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,EACP,CAAC,GAAG,CAAC,EACL,CAAC,GAAG,CAAC,CAAC;IAER,WAAW;IACX,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAClB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvB,WAAW;IACb,CAAC;SAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AACxE,CAAC;AAUD,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,GAAW;IAC3C,4BAA4B;IAC5B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/shared/color/hslaToHex.d.ts

@@ -0,0 +1 @@
+export default function hslaToHex(h: number | string | any, s: number, l: number, a?: number): string;