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

package/dist/shared/extension/commonVideoFileExtensions/commonVideoFileExtensions.js

@@ -0,0 +1,113 @@
+/**
+ * @name            commonVideoFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: mp4, avi, mkv, mov, wmv, flv, webm, m4v, mpg, mpeg, 3gp, 3g2, vob, ts, mts, m2ts, ogv, divx, xvid, asf
+ * Extended formats includes: h264, h265, rm, rmvb, swf, f4v, f4p, f4a, f4b, mod, tod, mxf, r3d, braw, prores, dnxhd, avchd, mks, mk3d, dav, dat, 'dvrms, evo, ifo, ivf, m1v, m2v, m4p, mp2v, mpe, mpv, mpv2, mqv, nsv, nuv, ogg, qt, ram, rec, rv, smk, thp, vc1, vfw, vid, vivo, vp6, vp7, vp8, vp9, wm, wmp, wvx, yuv
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonVideoFileExtensions()
+ *
+ * @example         js
+ * import { commonVideoFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonVideoFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonVideoFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'mp4',
+        'avi',
+        'mkv',
+        'mov',
+        'wmv',
+        'flv',
+        'webm',
+        'm4v',
+        'mpg',
+        'mpeg',
+        '3gp',
+        '3g2',
+        'vob',
+        'ts',
+        'mts',
+        'm2ts',
+        'ogv',
+        'divx',
+        'xvid',
+        'asf',
+    ];
+    const extended = [
+        'h264',
+        'h265',
+        'rm',
+        'rmvb',
+        'swf',
+        'f4v',
+        'f4p',
+        'f4a',
+        'f4b',
+        'mod',
+        'tod',
+        'mxf',
+        'r3d',
+        'braw',
+        'prores',
+        'dnxhd',
+        'avchd',
+        'mks',
+        'mk3d',
+        'dav',
+        'dat',
+        'dvr-ms',
+        'evo',
+        'ifo',
+        'ivf',
+        'm1v',
+        'm2v',
+        'm4p',
+        'mp2v',
+        'mpe',
+        'mpv',
+        'mpv2',
+        'mqv',
+        'nsv',
+        'nuv',
+        'ogg',
+        'qt',
+        'ram',
+        'rec',
+        'rv',
+        'smk',
+        'thp',
+        'vc1',
+        'vfw',
+        'vid',
+        'vivo',
+        'vp6',
+        'vp7',
+        'vp8',
+        'vp9',
+        'wm',
+        'wmp',
+        'wvx',
+        'yuv',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonVideoFileExtensions.js.map

package/dist/shared/extension/commonVideoFileExtensions/commonVideoFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonVideoFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonVideoFileExtensions/commonVideoFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,MAAM;QACN,MAAM;QACN,IAAI;QACJ,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,QAAQ;QACR,OAAO;QACP,OAAO;QACP,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,QAAQ;QACR,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/shared/extension/commonWebFileExtensions/commonWebFileExtensions.d.ts

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from '../commonFileExtensions/commonFileExtensions.js';
+/**
+ * @name            commonWebFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: html, htm, css, js, php, asp, jsp, py, rb, pl, cgi, cfm, xml, json, rss, xhtml, ts, jsx, tsx, scss, sass, less, vue, svelte
+ * Extended formats includes: aspx, ashx, asmx, axd, do, action, faces, xhtml, jspx, tag, tld, erb, rhtml, haml, slim, ejs, hbs, handlebars, mustache, twig, blade, smarty, ftl, vm, vsl, tpl, tmpl, phtml, php3, php4, php5, phps, pht, phar, shtml, shtm, stm, ihtml, mhtml, mht, wml, wap, csp, cer, part, webmanifest, appcache, webapp, map, coffee, dart, elm, cljs, elm
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonWebFileExtensions()
+ *
+ * @example         js
+ * import { commonWebFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonWebFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonWebFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonWebFileExtensions/commonWebFileExtensions.js

@@ -0,0 +1,117 @@
+/**
+ * @name            commonWebFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: html, htm, css, js, php, asp, jsp, py, rb, pl, cgi, cfm, xml, json, rss, xhtml, ts, jsx, tsx, scss, sass, less, vue, svelte
+ * Extended formats includes: aspx, ashx, asmx, axd, do, action, faces, xhtml, jspx, tag, tld, erb, rhtml, haml, slim, ejs, hbs, handlebars, mustache, twig, blade, smarty, ftl, vm, vsl, tpl, tmpl, phtml, php3, php4, php5, phps, pht, phar, shtml, shtm, stm, ihtml, mhtml, mht, wml, wap, csp, cer, part, webmanifest, appcache, webapp, map, coffee, dart, elm, cljs, elm
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonWebFileExtensions()
+ *
+ * @example         js
+ * import { commonWebFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonWebFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonWebFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'html',
+        'htm',
+        'css',
+        'js',
+        'php',
+        'asp',
+        'jsp',
+        'py',
+        'rb',
+        'pl',
+        'cgi',
+        'cfm',
+        'xml',
+        'json',
+        'rss',
+        'xhtml',
+        'ts',
+        'jsx',
+        'tsx',
+        'scss',
+        'sass',
+        'less',
+        'vue',
+        'svelte',
+    ];
+    const extended = [
+        'aspx',
+        'ashx',
+        'asmx',
+        'axd',
+        'do',
+        'action',
+        'faces',
+        'xhtml',
+        'jspx',
+        'tag',
+        'tld',
+        'erb',
+        'rhtml',
+        'haml',
+        'slim',
+        'ejs',
+        'hbs',
+        'handlebars',
+        'mustache',
+        'twig',
+        'blade',
+        'smarty',
+        'ftl',
+        'vm',
+        'vsl',
+        'tpl',
+        'tmpl',
+        'phtml',
+        'php3',
+        'php4',
+        'php5',
+        'phps',
+        'pht',
+        'phar',
+        'shtml',
+        'shtm',
+        'stm',
+        'ihtml',
+        'mhtml',
+        'mht',
+        'wml',
+        'wap',
+        'csp',
+        'cer',
+        'part',
+        'webmanifest',
+        'appcache',
+        'webapp',
+        'map',
+        'coffee',
+        'dart',
+        'elm',
+        'cljs',
+        'elm',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonWebFileExtensions.js.map

package/dist/shared/extension/commonWebFileExtensions/commonWebFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonWebFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonWebFileExtensions/commonWebFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,MAAM;QACN,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,OAAO;QACP,IAAI;QACJ,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,QAAQ;KACT,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,OAAO;QACP,OAAO;QACP,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,MAAM;QACN,MAAM;QACN,KAAK;QACL,KAAK;QACL,YAAY;QACZ,UAAU;QACV,MAAM;QACN,OAAO;QACP,QAAQ;QACR,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,KAAK;QACL,OAAO;QACP,OAAO;QACP,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,aAAa;QACb,UAAU;QACV,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { TRichTextSettings } from './richText.js';
-import richText from './richText.js';
+import type { TRichTextSettings } from './richText/richText.js';
+import richText from './richText/richText.js';
 export { richText as __richText, richText };
 export type { TRichTextSettings };

package/dist/shared/faker/_exports.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/faker/_exports.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/faker/_exports.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAE9C,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,QAAQ,EAAE,CAAC"}

package/dist/shared/faker/richText/richText.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @name            richText
+ * @namespace       shared.faker
+ * @type            Function
+ * @platform        node
+ * @platform        ts
+ * @status          wip
+ *
+ * This function simply returns you a rich text content that you can use in your tests for example.
+ *
+ * @return      {DOMElement}                    The new element
+ *
+ * @snippet         \Sugar\dom\changeTagName(1,2);
+ *
+ * @example         php
+ * print \Sugar\dom\changeTagName(element, 'a');
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TRichTextSettings = {
+    p?: boolean;
+    ul?: boolean;
+    ol?: boolean;
+    dl?: boolean;
+    strong?: boolean;
+    em?: boolean;
+    sup?: boolean;
+    sub?: boolean;
+    small?: boolean;
+    code?: boolean;
+    a?: boolean;
+    blockquote?: boolean;
+    h1?: boolean;
+    h2?: boolean;
+    h3?: boolean;
+    h4?: boolean;
+    h5?: boolean;
+    h6?: boolean;
+};
+export default function richText(settings?: TRichTextSettings): string;

package/dist/shared/faker/richText/richText.js

@@ -0,0 +1,126 @@
+import { faker } from '@faker-js/faker';
+export default function richText(settings) {
+    const str = [];
+    const finalSettings = Object.assign({ p: faker.datatype.boolean(), ul: faker.datatype.boolean(), ol: faker.datatype.boolean(), dl: faker.datatype.boolean(), strong: faker.datatype.boolean(), em: faker.datatype.boolean(), sup: faker.datatype.boolean(), sub: faker.datatype.boolean(), small: faker.datatype.boolean(), code: faker.datatype.boolean(), a: faker.datatype.boolean(), blockquote: faker.datatype.boolean(), h1: faker.datatype.boolean(), h2: faker.datatype.boolean(), h3: faker.datatype.boolean(), h4: faker.datatype.boolean(), h5: faker.datatype.boolean(), h6: faker.datatype.boolean() }, (settings !== null && settings !== void 0 ? settings : {}));
+    if (finalSettings.h1) {
+        str.push('<h1>I am an H1 heading</h1>');
+    }
+    if (finalSettings.h2) {
+        str.push('<h2>I am an H2 heading</h2>');
+    }
+    if (finalSettings.h3) {
+        str.push('<h3>I am an H3 heading</h3>');
+    }
+    if (finalSettings.h4) {
+        str.push('<h4>I am an H4 heading</h4>');
+    }
+    if (finalSettings.h5) {
+        str.push('<h5>I am an H5 heading</h5>');
+    }
+    if (finalSettings.h6) {
+        str.push('<h6>I am an H6 heading</h6>');
+    }
+    if (finalSettings.p) {
+        for (let i = 0; i < Math.round(Math.random() * 5); i++) {
+            str.push(`<p>${faker.lorem.paragraph({
+                min: 1,
+                max: 3,
+            })}</p>`);
+        }
+    }
+    if (finalSettings.ul) {
+        function _ul(level = 0) {
+            const ul = [];
+            ul.push('<ul>');
+            for (let i = 0; i < Math.round(Math.random() * 5); i++) {
+                ul.push('<li>');
+                ul.push(faker.lorem.sentence({
+                    min: 1,
+                    max: 3,
+                }));
+                if (faker.datatype.boolean() && level === 0) {
+                    ul.push(_ul(level + 1));
+                }
+                ul.push('</li>');
+            }
+            ul.push('</ul>');
+            return ul.join('\n');
+        }
+        str.push(_ul());
+    }
+    if (finalSettings.ol) {
+        function _ol(level = 0) {
+            const ol = [];
+            ol.push('<ol>');
+            for (let i = 0; i < Math.round(Math.random() * 5); i++) {
+                ol.push('<li>');
+                ol.push(faker.lorem.sentence({
+                    min: 1,
+                    max: 3,
+                }));
+                if (faker.datatype.boolean() && level === 0) {
+                    ol.push(_ol(level + 1));
+                }
+                ol.push('</li>');
+            }
+            ol.push('</ol>');
+            return ol.join('\n');
+        }
+        str.push(_ol());
+    }
+    if (finalSettings.dl) {
+        function _dl(level = 0) {
+            const dl = [];
+            dl.push('<dl>');
+            for (let i = 0; i < Math.round(Math.random() * 5); i++) {
+                dl.push('<dt>');
+                dl.push(faker.lorem.sentence({
+                    min: 1,
+                    max: 3,
+                }));
+                dl.push('</dt>');
+                dl.push('<dd>');
+                dl.push(faker.lorem.sentence({
+                    min: 1,
+                    max: 3,
+                }));
+                if (faker.datatype.boolean() && level === 0) {
+                    dl.push(_dl(level + 1));
+                }
+                dl.push('</dd>');
+            }
+            dl.push('</dl>');
+            return dl.join('\n');
+        }
+        str.push(_dl());
+    }
+    if (finalSettings.strong) {
+        str.push('<p>I am a <strong>strong</strong> example</p>');
+    }
+    if (finalSettings.em) {
+        str.push('<p>I am an <em>emphasized</em> example</p>');
+    }
+    if (finalSettings.sup) {
+        str.push('<p>I am a <sup>superscript</sup> example</p>');
+    }
+    if (finalSettings.sub) {
+        str.push('<p>I am a <sub>subscript</sub> example</p>');
+    }
+    if (finalSettings.small) {
+        str.push('<p>I am a <small>small</small> example</p>');
+    }
+    if (finalSettings.code) {
+        str.push('<p>I am a <code>code</code> example</p>');
+    }
+    if (finalSettings.a) {
+        str.push(`<p>I am a <a href="${faker.lorem.slug}">link</a> example</p>`);
+    }
+    if (finalSettings.blockquote) {
+        str.push(`<blockquote>${faker.lorem.sentence({
+            min: 1,
+            max: 3,
+        })}</blockquote>`);
+    }
+    return str.join('\n');
+}
+//# sourceMappingURL=richText.js.map

package/dist/shared/faker/richText/richText.js.map

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

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

@@ -1,3 +1,3 @@
-import formatFileSize from './formatFileSize.js';
-import formatDuration from './formatDuration.js';
+import formatFileSize from './formatFileSize/formatFileSize.js';
+import formatDuration from './formatDuration/formatDuration.js';
 export { formatFileSize as __formatFileSize, formatFileSize, formatDuration as __formatDuration, formatDuration, };

package/dist/shared/format/_exports.js

@@ -1,4 +1,4 @@
-import formatFileSize from './formatFileSize.js';
-import formatDuration from './formatDuration.js';
+import formatFileSize from './formatFileSize/formatFileSize.js';
+import formatDuration from './formatDuration/formatDuration.js';
 export { formatFileSize as __formatFileSize, formatFileSize, formatDuration as __formatDuration, formatDuration, };
 //# sourceMappingURL=_exports.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/format/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACL,cAAc,IAAI,gBAAgB,EAClC,cAAc,EACd,cAAc,IAAI,gBAAgB,EAClC,cAAc,GACf,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/format/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAChE,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EACL,cAAc,IAAI,gBAAgB,EAClC,cAAc,EACd,cAAc,IAAI,gBAAgB,EAClC,cAAc,GACf,CAAC"}

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

@@ -0,0 +1,26 @@
+import { formatDuration } from '@blackbyte/sugar/datetime';
+/**
+ * @name                formatDuration
+ * @namespace           shared.format
+ * @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/format';
+ * formatDuration(2000); // => 2s
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default formatDuration;

package/dist/shared/format/formatDuration/formatDuration.js

@@ -0,0 +1,27 @@
+import { formatDuration } from '@blackbyte/sugar/datetime';
+/**
+ * @name                formatDuration
+ * @namespace           shared.format
+ * @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/format';
+ * formatDuration(2000); // => 2s
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default formatDuration;
+//# sourceMappingURL=formatDuration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatDuration.js","sourceRoot":"","sources":["../../../../src/shared/format/formatDuration/formatDuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAe,cAAc,CAAC"}

package/dist/shared/format/formatFileSize/formatFileSize.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @name                formatFileSize
+ * @namespace           shared.format
+ * @type                Function
+ * @platform            node
+ * @platform            js
+ * @status              stable
+ *
+ * Transform into human readable string a file size from a number (float or integer) or string.
+ * This function use the wonderfull "filesize" npm package under the houd.
+ *
+ * @param               {Number|String}             size              The size to transform in bytes
+ * @param               {Object}                    [settings={}]     The "filesize" settings to customize the output. See [filesize](https://www.npmjs.com/package/filesize) settings
+ * @return              {String}                                      The human readable version of the passed size
+ *
+ * @setting             {Number}                [base=10]              (number) Number base, default is 10
+ * @setting             {Boolean}               [bits=false]           (boolean) Enables `bit` sizes, default is false
+ * @setting             {Number}                [exponent=0]           (number) Specifies the SI suffix via exponent, e.g. 2 is MB for bytes, default is 0
+ * @setting             {Boolean}               [fullform=false]       (boolean) Enables full form of unit of measure, default is false
+ * @setting             {Array}                 [fullforms]            (array) Array of full form overrides, default is []
+ * @setting             {Boolean|String}        [locale=false]         (boolean|string) Localize the output, default is false
+ * @setting             {Boolean}               [pad=false]             (boolean) Should the output be padded to the left, default is false
+ * @setting             {Number}                [precision=2]          (number) The precision to use when outputting decimal values, default is 2
+ * @setting             {Number}                [round=2]              (number) The rounding function, default is 2
+ * @setting             {String}                [separator='.']         (string) Separator of thousands, default is '.'
+ * @setting             {String}                [spacer=' ']            (string) Spacer of the output, default is ' '
+ *
+ * @snippet         formatFileSize($1)
+ *
+ * @todo     tests
+ *
+ * @example             js
+ * import { formatFilesize } from '@blackbyte/sugar/format';
+ * formatFilesize(163931); // => 326.86 KB
+ *
+ * @see             https://www.npmjs.com/package/filesize
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TFormatFileSizeSettings = {
+    base?: number;
+    bits?: boolean;
+    exponent?: number;
+    fullform?: boolean;
+    fullforms?: any[];
+    locale?: boolean | string;
+    pad?: boolean;
+    precision?: number;
+    round?: number;
+    separator?: string;
+    spacer?: string;
+};
+export default function formatFileSize(size: number, settings?: TFormatFileSizeSettings): string | number | import("filesize").FileSizeReturnArray | import("filesize").FileSizeReturnObject;

package/dist/shared/format/formatFileSize/formatFileSize.js

@@ -0,0 +1,6 @@
+import { filesize as __filesize } from 'filesize';
+export default function formatFileSize(size, settings = {}) {
+    // @ts-ignore
+    return __filesize(size, settings);
+}
+//# sourceMappingURL=formatFileSize.js.map

package/dist/shared/format/formatFileSize/formatFileSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatFileSize.js","sourceRoot":"","sources":["../../../../src/shared/format/formatFileSize/formatFileSize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AAwDlD,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,IAAY,EACZ,WAAoC,EAAE;IAEtC,aAAa;IACb,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}

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

@@ -1,7 +1,7 @@
-import debounce from './debounce.js';
-import easeInterval from './easeInterval.js';
-import getArgsNames from './getArgsNames.js';
-import memoize from './memoize.js';
-import sleep from './sleep.js';
-import throttle from './throttle.js';
+import debounce from './debounce/debounce.js';
+import easeInterval from './easeInterval/easeInterval.js';
+import getArgsNames from './getArgsNames/getArgsNames.js';
+import memoize from './memoize/memoize.js';
+import sleep from './sleep/sleep.js';
+import throttle from './throttle/throttle.js';
 export { debounce as __debounce, easeInterval as __easeInterval, getArgsNames as __getArgsNames, memoize as __memoize, sleep as __sleep, throttle as __throttle, debounce, easeInterval, getArgsNames, memoize, sleep, throttle, };

package/dist/shared/function/_exports.js

@@ -1,8 +1,8 @@
-import debounce from './debounce.js';
-import easeInterval from './easeInterval.js';
-import getArgsNames from './getArgsNames.js';
-import memoize from './memoize.js';
-import sleep from './sleep.js';
-import throttle from './throttle.js';
+import debounce from './debounce/debounce.js';
+import easeInterval from './easeInterval/easeInterval.js';
+import getArgsNames from './getArgsNames/getArgsNames.js';
+import memoize from './memoize/memoize.js';
+import sleep from './sleep/sleep.js';
+import throttle from './throttle/throttle.js';
 export { debounce as __debounce, easeInterval as __easeInterval, getArgsNames as __getArgsNames, memoize as __memoize, sleep as __sleep, throttle as __throttle, debounce, easeInterval, getArgsNames, memoize, sleep, throttle, };
 //# sourceMappingURL=_exports.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/function/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EACL,QAAQ,IAAI,UAAU,EACtB,YAAY,IAAI,cAAc,EAC9B,YAAY,IAAI,cAAc,EAC9B,OAAO,IAAI,SAAS,EACpB,KAAK,IAAI,OAAO,EAChB,QAAQ,IAAI,UAAU,EACtB,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,KAAK,EACL,QAAQ,GACT,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/function/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAC9C,OAAO,YAAY,MAAM,gCAAgC,CAAC;AAC1D,OAAO,YAAY,MAAM,gCAAgC,CAAC;AAC1D,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAC3C,OAAO,KAAK,MAAM,kBAAkB,CAAC;AACrC,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAE9C,OAAO,EACL,QAAQ,IAAI,UAAU,EACtB,YAAY,IAAI,cAAc,EAC9B,YAAY,IAAI,cAAc,EAC9B,OAAO,IAAI,SAAS,EACpB,KAAK,IAAI,OAAO,EAChB,QAAQ,IAAI,UAAU,EACtB,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,KAAK,EACL,QAAQ,GACT,CAAC"}