@blackbyte/sugar 1.0.0-beta.1

package/dist/shared/css/parse/parseTransformRule.js

@@ -0,0 +1,45 @@
+import parse from '../../../shared/string/parse.js';
+export default function parseTransformRule(transformStr) {
+    const transforms = transformStr.trim().split(/\) |\)/);
+    const result = {
+        scale: 1,
+        scaleX: 1,
+        scaleY: 1,
+        scaleZ: 1,
+        translateX: 0,
+        translateY: 0,
+        translateZ: 0,
+        rotate: 0,
+        rotateX: 0,
+        rotateY: 0,
+        rotateZ: 0,
+        skew: 0,
+        skewX: 0,
+        skewY: 0,
+    };
+    transforms.forEach((transStr) => {
+        if (!transStr || !transStr.trim()) {
+            return;
+        }
+        const parts = transStr.split('('), prop = parts[0].trim(), value = parts[1].trim();
+        if (prop.match(/(X|Y|Z)$/)) {
+            result[prop] = parse(value);
+        }
+        else {
+            const vals = value.split(',').map((v) => parse(v.trim()));
+            if (vals.length === 1 && prop === 'scale') {
+                result.scale = parseFloat(value);
+            }
+            else {
+                ['X', 'Y', 'Z'].forEach((axis, i) => {
+                    if (!vals[i]) {
+                        return;
+                    }
+                    result[`${prop}${axis}`] = vals[i];
+                });
+            }
+        }
+    });
+    return result;
+}
+//# sourceMappingURL=parseTransformRule.js.map

package/dist/shared/css/parse/parseTransformRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseTransformRule.js","sourceRoot":"","sources":["../../../../src/shared/css/parse/parseTransformRule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,iCAAiC,CAAC;AA4CpD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,YAAoB;IAEpB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvD,MAAM,MAAM,GAA8B;QACxC,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC9B,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAC/B,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EACtB,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE1B,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAE1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1C,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;oBAClC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;wBACb,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/css/rule/_exports.d.ts

@@ -0,0 +1,2 @@
+import removeVendorPrefix from './removeVendorPrefix.js';
+export { removeVendorPrefix as __removeVendorPrefix, removeVendorPrefix };

package/dist/shared/css/rule/_exports.js

@@ -0,0 +1,3 @@
+import removeVendorPrefix from './removeVendorPrefix.js';
+export { removeVendorPrefix as __removeVendorPrefix, removeVendorPrefix };
+//# sourceMappingURL=_exports.js.map

package/dist/shared/css/rule/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/shared/css/rule/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/shared/css/rule/removeVendorPrefix.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name            removeVendorPrefix
+ * @namespace       js.css.rule
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * Remove vendor prefixes from CSSPropertyNames
+ *
+ * @param           {string}            propertyName             prefixed property name
+ * @return          {string}              unprefixed property name
+ *
+ * @todo      tests
+ *
+ * @snippet         removeVendorPrefix($1)
+ *
+ * @example  	js
+ * import { removeVendorPrefix } from '@blackbyte/sugar/css';
+ * removeVendorPrefix('moz-something'); // 'something'
+ *
+ * @see            https://github.com/marionebl/jogwheel/blob/main/source/library/remove-vendor-prefix.js
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function removeVendorPrefix(propertyName?: string): string;

package/dist/shared/css/rule/removeVendorPrefix.js

@@ -0,0 +1,34 @@
+/**
+ * @name            removeVendorPrefix
+ * @namespace       js.css.rule
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * Remove vendor prefixes from CSSPropertyNames
+ *
+ * @param           {string}            propertyName             prefixed property name
+ * @return          {string}              unprefixed property name
+ *
+ * @todo      tests
+ *
+ * @snippet         removeVendorPrefix($1)
+ *
+ * @example  	js
+ * import { removeVendorPrefix } from '@blackbyte/sugar/css';
+ * removeVendorPrefix('moz-something'); // 'something'
+ *
+ * @see            https://github.com/marionebl/jogwheel/blob/main/source/library/remove-vendor-prefix.js
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+const prefixes = ['ms', 'webkit', 'moz', 'o'];
+export default function removeVendorPrefix(propertyName = '') {
+    const fragments = propertyName.split('-');
+    if (prefixes.indexOf(fragments[1]) > -1) {
+        return fragments.slice(2).join('-');
+    }
+    return propertyName;
+}
+//# sourceMappingURL=removeVendorPrefix.js.map

package/dist/shared/css/rule/removeVendorPrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeVendorPrefix.js","sourceRoot":"","sources":["../../../../src/shared/css/rule/removeVendorPrefix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,YAAY,GAAG,EAAE;IAC1D,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/shared/css/stripCssComments.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @name                stripCssComments
+ * @namespace           shared.css
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function simply remove all the css comments like:
+ * - Multiline blocks css comments begining with /* *, ending with * /
+ * - Single line comments begining with //
+ *
+ * @param       {String}        css         The css code to process
+ * @param       {Object}      [settings={}]   An object of settings
+ * @return      {String}                    The processed css code
+ *
+ * @setting     {Boolean}     [block=true]       Remove the blocks comments
+ * @setting     {Boolean}     [line=true]       Remove the line comments
+ *
+ * @todo        tests
+ *
+ * @snippet         stripCssComments($1)
+ *
+ * @example       js
+ * import { stripCssComments } from '@blackbyte/sugar/css';
+ * stripCssComments(`
+ * // something cool
+ * body { background-color: red; }
+ * `);
+ * // body { background-color: red }
+ *
+ * @see         https://www.npmjs.com/package/strip-css-comments
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TStripCssCommentsSettings = {
+    block: boolean;
+    line: boolean;
+};
+export default function stripCssComments(css: any, settings?: TStripCssCommentsSettings): string;

package/dist/shared/css/stripCssComments.js

@@ -0,0 +1,15 @@
+import __stripCssComments from 'strip-css-comments';
+export default function stripCssComments(css, settings) {
+    const finalSettings = Object.assign({ block: true, line: true }, (settings !== null && settings !== void 0 ? settings : {}));
+    if (finalSettings.block) {
+        // css = css.replace(/\/\*{2}([\s\S]+?)\*\//g, '');
+        css = __stripCssComments(css, {
+            preserve: false,
+        });
+    }
+    if (finalSettings.line) {
+        css = css.replace(/^[\s]{0,99999999}\/\/.*$/gm, '');
+    }
+    return css;
+}
+//# sourceMappingURL=stripCssComments.js.map

package/dist/shared/css/stripCssComments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripCssComments.js","sourceRoot":"","sources":["../../../src/shared/css/stripCssComments.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,oBAAoB,CAAC;AA2CpD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,GAAG,EACH,QAAoC;IAEpC,MAAM,aAAa,mBACjB,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,IAAI,IACP,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IACF,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;QACxB,mDAAmD;QACnD,GAAG,GAAG,kBAAkB,CAAC,GAAG,EAAE;YAC5B,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;QACvB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shared/css/transform/_exports.d.ts

@@ -0,0 +1,3 @@
+import styleObjectToString from './styleObjectToString.js';
+import styleStringToObject from './styleStringToObject.js';
+export { styleObjectToString as __styleObjectToString, styleStringToObject as __styleStringToObject, styleObjectToString, styleStringToObject, };

package/dist/shared/css/transform/_exports.js

@@ -0,0 +1,4 @@
+import styleObjectToString from './styleObjectToString.js';
+import styleStringToObject from './styleStringToObject.js';
+export { styleObjectToString as __styleObjectToString, styleStringToObject as __styleStringToObject, styleObjectToString, styleStringToObject, };
+//# sourceMappingURL=_exports.js.map

package/dist/shared/css/transform/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../../src/shared/css/transform/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EACL,mBAAmB,IAAI,qBAAqB,EAC5C,mBAAmB,IAAI,qBAAqB,EAC5C,mBAAmB,EACnB,mBAAmB,GACpB,CAAC"}

package/dist/shared/css/transform/styleObjectToString.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            styleObject2String
+ * @namespace       js.css.transform
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * Transform a style object to inline string separated by ;
+ *
+ * @param 		{Object} 				styleObj 		An object of style to apply
+ * @return 		(String) 								The string style representation
+ *
+ * @todo      tests
+ *
+ * @snippet         styleObjectToString($1)
+ *
+ * @example 	js
+ * import { styleObjectToString } from '@blackbyte/sugar/css'
+ * const styleString =  styleObjectToString({
+ * 		paddingLeft : '20px',
+ * 		display : 'block'
+ * });
+ * // output => padding-left:20px; display:block;
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function styleObjectToString(styleObj: any): string;

package/dist/shared/css/transform/styleObjectToString.js

@@ -0,0 +1,47 @@
+import uncamelize from '../../../shared/string/uncamelize.js';
+/**
+ * @name            styleObject2String
+ * @namespace       js.css.transform
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * Transform a style object to inline string separated by ;
+ *
+ * @param 		{Object} 				styleObj 		An object of style to apply
+ * @return 		(String) 								The string style representation
+ *
+ * @todo      tests
+ *
+ * @snippet         styleObjectToString($1)
+ *
+ * @example 	js
+ * import { styleObjectToString } from '@blackbyte/sugar/css'
+ * const styleString =  styleObjectToString({
+ * 		paddingLeft : '20px',
+ * 		display : 'block'
+ * });
+ * // output => padding-left:20px; display:block;
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function styleObjectToString(styleObj) {
+    // process the style object
+    const propertiesArray = [];
+    for (const key in styleObj) {
+        const value = styleObj[key];
+        // if the value is ''
+        // mean that we need to get rid of
+        if (value === undefined || value === '') {
+            delete styleObj[key];
+        }
+        else {
+            propertiesArray.push(`${uncamelize(key)}:${value};`);
+        }
+    }
+    // return the css text
+    return propertiesArray.join(' ');
+}
+//# sourceMappingURL=styleObjectToString.js.map

package/dist/shared/css/transform/styleObjectToString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleObjectToString.js","sourceRoot":"","sources":["../../../../src/shared/css/transform/styleObjectToString.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,sCAAsC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,QAAa;IACvD,2BAA2B;IAC3B,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5B,qBAAqB;QACrB,kCAAkC;QAClC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/shared/css/transform/styleStringToObject.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            styleString2Object
+ * @namespace       js.css.transform
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * Transform a style string to an object representation
+ *
+ * @param 		{String} 				style 			The style string
+ * @return 		(Object) 								The string object representation
+ *
+ * @todo      tests
+ *
+ * @snippet         styleStringToObject($1)
+ *
+ * @example 	js
+ * import { styleStringToObject } from '@blackbyte/sugar/css'
+ * const styleString =  styleStringToObject('padding-left:20px; display:block;');
+ * // output => {
+ * //		paddingLeft : '20px',
+ * // 		display : 'block'
+ * // }
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function styleStringToObject(style: string): any;

package/dist/shared/css/transform/styleStringToObject.js

@@ -0,0 +1,45 @@
+import camelize from '../../string/camelize.js';
+import parse from '../../string/parse.js';
+/**
+ * @name            styleString2Object
+ * @namespace       js.css.transform
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * Transform a style string to an object representation
+ *
+ * @param 		{String} 				style 			The style string
+ * @return 		(Object) 								The string object representation
+ *
+ * @todo      tests
+ *
+ * @snippet         styleStringToObject($1)
+ *
+ * @example 	js
+ * import { styleStringToObject } from '@blackbyte/sugar/css'
+ * const styleString =  styleStringToObject('padding-left:20px; display:block;');
+ * // output => {
+ * //		paddingLeft : '20px',
+ * // 		display : 'block'
+ * // }
+ *
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function styleStringToObject(style) {
+    if (!style || style === '')
+        return {};
+    const obj = {};
+    const split = style.replace(/\s/g, '').split(';');
+    split.forEach((statement) => {
+        // split statement by key value pairs
+        const spl = statement.split(':'), key = camelize(spl[0]), value = spl[1];
+        // add element into object
+        obj[key] = parse(value);
+    });
+    // return the style object
+    return obj;
+}
+//# sourceMappingURL=styleStringToObject.js.map

package/dist/shared/css/transform/styleStringToObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleStringToObject.js","sourceRoot":"","sources":["../../../../src/shared/css/transform/styleStringToObject.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,0BAA0B,CAAC;AAChD,OAAO,KAAK,MAAM,uBAAuB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,KAAa;IACvD,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC1B,qCAAqC;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAC9B,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EACtB,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,0BAA0B;QAC1B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,0BAA0B;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,7 @@
+import formatDuration from './formatDuration.js';
+import sleep from './sleep.js';
+import timeAgo from './timeAgo.js';
+import utcTime from './utcTime.js';
+import wait from './wait.js';
+export * from './convertTime.js';
+export { formatDuration as __formatDuration, sleep as __sleep, timeAgo as __timeAgo, utcTime as __utcTime, wait as __wait, formatDuration, sleep, timeAgo, utcTime, wait, };

package/dist/shared/datetime/_exports.js

@@ -0,0 +1,8 @@
+import formatDuration from './formatDuration.js';
+import sleep from './sleep.js';
+import timeAgo from './timeAgo.js';
+import utcTime from './utcTime.js';
+import wait from './wait.js';
+export * from './convertTime.js';
+export { formatDuration as __formatDuration, sleep as __sleep, timeAgo as __timeAgo, utcTime as __utcTime, wait as __wait, formatDuration, sleep, timeAgo, utcTime, wait, };
+//# sourceMappingURL=_exports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/datetime/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,IAAI,gBAAgB,EAClC,KAAK,IAAI,OAAO,EAChB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,cAAc,EACd,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,GACL,CAAC"}

package/dist/shared/datetime/convertTime.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @name                                convertTime
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to convert time like seconds, ms, hours, minutes, etc... from one format to another
+ *
+ * @param           {String|Number}             from                  The value to start from like "10s", "20ms", "2h", etc... Supports 'ms', 'millisecond', 'milliseconds', 's', 'second', 'seconds', 'm', 'minute', 'minutes', 'h', 'hour', 'hours', 'd', 'day', 'days', 'w', 'week', 'weeks', 'month', 'months', 'y', 'year', 'years'
+ * @param           {String}                    [to='ms']             The format you want to get back. Can be 'ms' | 'millisecond' | 'milliseconds' | 's' | 'second' | 'seconds' | 'm' | 'minute' | 'minutes' | 'h' | 'hour' | 'hours' | 'd' | 'day' | 'days' | 'w' | 'week' | 'weeks' | 'month' | 'months' | 'y' | 'year' | 'years'
+ * @return          {Number}                                          The converted value
+ *
+ * @todo      tests
+ *
+ * @snippet         convertTime($1, $2)
+ *
+ * @example           js
+ * import { convertTime } from '@blackbyte/sugar/datetime';
+ * convertTime('10s', 'ms'); // => 10000
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+declare function convertTime(from: string | number, to?: 'ms' | 'millisecond' | 'milliseconds' | 's' | 'second' | 'seconds' | 'm' | 'minute' | 'minutes' | 'h' | 'hour' | 'hours' | 'd' | 'day' | 'days' | 'w' | 'week' | 'weeks' | 'month' | 'months' | 'y' | 'year' | 'years'): number;
+declare namespace convertTime {
+    var MILLISECOND: string;
+    var SECOND: string;
+    var MINUTE: string;
+    var HOUR: string;
+    var DAY: string;
+    var WEEK: string;
+    var MONTH: string;
+    var YEAR: string;
+}
+export default convertTime;

package/dist/shared/datetime/convertTime.js

@@ -0,0 +1,127 @@
+/**
+ * @name                                convertTime
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to convert time like seconds, ms, hours, minutes, etc... from one format to another
+ *
+ * @param           {String|Number}             from                  The value to start from like "10s", "20ms", "2h", etc... Supports 'ms', 'millisecond', 'milliseconds', 's', 'second', 'seconds', 'm', 'minute', 'minutes', 'h', 'hour', 'hours', 'd', 'day', 'days', 'w', 'week', 'weeks', 'month', 'months', 'y', 'year', 'years'
+ * @param           {String}                    [to='ms']             The format you want to get back. Can be 'ms' | 'millisecond' | 'milliseconds' | 's' | 'second' | 'seconds' | 'm' | 'minute' | 'minutes' | 'h' | 'hour' | 'hours' | 'd' | 'day' | 'days' | 'w' | 'week' | 'weeks' | 'month' | 'months' | 'y' | 'year' | 'years'
+ * @return          {Number}                                          The converted value
+ *
+ * @todo      tests
+ *
+ * @snippet         convertTime($1, $2)
+ *
+ * @example           js
+ * import { convertTime } from '@blackbyte/sugar/datetime';
+ * convertTime('10s', 'ms'); // => 10000
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function convertTime(from, to = 'ms') {
+    // @ts-ignore
+    let fromMs = from;
+    // check if the time is a string to convert it to ms
+    if (typeof from === 'string') {
+        const fromNumber = parseFloat(from);
+        const fromLength = fromNumber.toString().length;
+        const fromString = from.slice(fromLength);
+        if (fromString === 'ms' ||
+            fromString === 'millisecond' ||
+            fromString === 'milliseconds') {
+            fromMs = fromNumber;
+        }
+        else if (fromString === 's' ||
+            fromString === 'second' ||
+            fromString === 'seconds') {
+            fromMs = fromNumber * 1000;
+        }
+        else if (fromString === 'm' ||
+            fromString === 'minute' ||
+            fromString === 'minutes') {
+            fromMs = fromNumber * 60 * 1000;
+        }
+        else if (fromString === 'h' ||
+            fromString === 'hour' ||
+            fromString === 'hours') {
+            fromMs = fromNumber * 60 * 60 * 1000;
+        }
+        else if (fromString === 'd' ||
+            fromString === 'day' ||
+            fromString === 'days') {
+            fromMs = fromNumber * 24 * 60 * 60 * 1000;
+        }
+        else if (fromString === 'w' ||
+            fromString === 'week' ||
+            fromString === 'weeks') {
+            fromMs = fromNumber * 7 * 24 * 60 * 60 * 1000;
+        }
+        else if (fromString === 'month' || fromString === 'months') {
+            fromMs = fromNumber * 31 * 24 * 60 * 60 * 1000;
+        }
+        else if (fromString === 'y' ||
+            fromString === 'year' ||
+            fromString === 'years') {
+            fromMs = fromNumber * 365 * 24 * 60 * 60 * 1000;
+        }
+    }
+    // convert not the fromMs value to the requested format
+    switch (to) {
+        case 'ms':
+        case 'millisecond':
+        case 'milliseconds':
+            return fromMs;
+            break;
+        case 's':
+        case 'second':
+        case 'seconds':
+            return fromMs / 1000;
+            break;
+        case 'm':
+        case 'minute':
+        case 'minutes':
+            return fromMs / 1000 / 60;
+            break;
+        case 'h':
+        case 'hour':
+        case 'hours':
+            return fromMs / 1000 / 60 / 60;
+            break;
+        case 'd':
+        case 'day':
+        case 'days':
+            return fromMs / 1000 / 60 / 60 / 24;
+            break;
+        case 'w':
+        case 'week':
+        case 'weeks':
+            return fromMs / 1000 / 60 / 60 / 24 / 7;
+            break;
+        case 'month':
+        case 'months':
+            return fromMs / 1000 / 60 / 60 / 24 / 31;
+            break;
+        case 'y':
+        case 'year':
+        case 'years':
+            return fromMs / 1000 / 60 / 60 / 24 / 365;
+            break;
+        default:
+            throw new Error(`You try to convert "${from}" to "${to}" but this format does not exist... The valids formats are "ms,s,m,h,d,w,month,y"...`);
+            break;
+    }
+}
+convertTime.MILLISECOND = 'ms';
+convertTime.SECOND = 's';
+convertTime.MINUTE = 'm';
+convertTime.HOUR = 'h';
+convertTime.DAY = 'd';
+convertTime.WEEK = 'w';
+convertTime.MONTH = 'month';
+convertTime.YEAR = 'y';
+//# sourceMappingURL=convertTime.js.map

package/dist/shared/datetime/convertTime.js.map

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

package/dist/shared/datetime/formatDuration.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @name                formatDuration
+ * @namespace           shared.datetime
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function let you pass a duration in ms and get back a formatted estimation like "2.4m", "30s", etc...
+ *
+ * @param         {Number}        duration          The duration in ms to format
+ * @return        {String}                          The formatted estimation duration
+ *
+ * @todo      tests
+ *
+ * @snippet         formatDuration($1)
+ *
+ * @example       js
+ * import { formatDuration } from '@blackbyte/sugar/datetime';
+ * formatDuration(2000); // => 2s
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function formatDuration(duration: number): string;

package/dist/shared/datetime/formatDuration.js

@@ -0,0 +1,45 @@
+/**
+ * @name                formatDuration
+ * @namespace           shared.datetime
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function let you pass a duration in ms and get back a formatted estimation like "2.4m", "30s", etc...
+ *
+ * @param         {Number}        duration          The duration in ms to format
+ * @return        {String}                          The formatted estimation duration
+ *
+ * @todo      tests
+ *
+ * @snippet         formatDuration($1)
+ *
+ * @example       js
+ * import { formatDuration } from '@blackbyte/sugar/datetime';
+ * formatDuration(2000); // => 2s
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function formatDuration(duration) {
+    if (duration === Infinity) {
+        return '...';
+    }
+    if (duration < 1000) {
+        return `${duration}ms`;
+    }
+    if (duration < 1000 * 60) {
+        const s = duration / 1000;
+        return `${s.toFixed(2)}s`;
+    }
+    if (duration < 1000 * 60 * 60) {
+        const m = Math.floor(duration / 1000 / 60);
+        const s = Math.round((duration - m * 1000 * 60) / 1000);
+        return `${m}m${s > 0 ? `${s}s` : ''}`;
+    }
+    const h = Math.floor(duration / 1000 / 60 / 60);
+    const m = Math.floor((duration - h * 1000 * 60 * 60) / 1000 / 60);
+    return `${h}h${m > 0 ? `${m}m` : ''}`;
+}
+//# sourceMappingURL=formatDuration.js.map

package/dist/shared/datetime/formatDuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDuration.js","sourceRoot":"","sources":["../../../src/shared/datetime/formatDuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,QAAgB;IACrD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;QACpB,OAAO,GAAG,QAAQ,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,GAAG,EAAE,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5B,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACxD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxC,CAAC"}