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

package/dist/shared/url/gravatarUrl/gravatarUrl.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name                gravatarUrl
+ * @namespace           shared.url
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Return a gravatar url depending on the passed user email and size
+ *
+ * @param           {String}            email             The user email
+ * @param           {Number}            [size=200]        The wanted image size. From 1 to 2048
+ * @return          {String}                              The generated gravatar url
+ *
+ * @todo      tests
+ *
+ * @snippet         gravatarUrl($1)
+ *
+ * @example       js
+ * import { gravatarUrl } from '@blackbyte/sugar/url';
+ * gravatarUrl('olivier.bossel@gmail.com'); // https://www.gravatar.com/avatar/b5df60055b6287bb7c90c0078ce20a5f
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function gravatarUrl(email: string, size?: number): string;

package/dist/shared/url/gravatarUrl/gravatarUrl.js

@@ -0,0 +1,30 @@
+import md5 from '../../crypto/md5/md5.js';
+/**
+ * @name                gravatarUrl
+ * @namespace           shared.url
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Return a gravatar url depending on the passed user email and size
+ *
+ * @param           {String}            email             The user email
+ * @param           {Number}            [size=200]        The wanted image size. From 1 to 2048
+ * @return          {String}                              The generated gravatar url
+ *
+ * @todo      tests
+ *
+ * @snippet         gravatarUrl($1)
+ *
+ * @example       js
+ * import { gravatarUrl } from '@blackbyte/sugar/url';
+ * gravatarUrl('olivier.bossel@gmail.com'); // https://www.gravatar.com/avatar/b5df60055b6287bb7c90c0078ce20a5f
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function gravatarUrl(email, size = 200) {
+    return `https://www.gravatar.com/avatar/${md5.encrypt(email)}?s=${size}`;
+}
+//# sourceMappingURL=gravatarUrl.js.map

package/dist/shared/url/gravatarUrl/gravatarUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gravatarUrl.js","sourceRoot":"","sources":["../../../../src/shared/url/gravatarUrl/gravatarUrl.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,yBAAyB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe,GAAG;IACnE,OAAO,mCAAmC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;AAC3E,CAAC"}

package/dist/shared/url/parseSchema/parseSchema.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @name                            parseSchema
+ * @namespace                       shared.url
+ * @type                            Function
+ * @platform                        js
+ * @platform                        node
+ * @status                          beta
+ * @private
+ *
+ * This function take two arguments. The first one is the url to parse and the second is a schema to scan the url with.
+ * The schema describe the pathname of an url and tell's how to analyze it.
+ * Here's a little description with some example of schemas:
+ * - "{param1}/{param2}/{param3}": This schema describe that your Url must have 3 "values" named param1, param2 and param3
+ *    - If my Url is "something.com/hello/world/plop", my schema is respected and I can have access to the values through the "schema.params.param1", "schema.params.param2", etc...
+ * - "{hello:string}/{world:number}/{?idx:number}": This schema describe that the Url can have 3 "values" but the last one is optional
+ *    - If my Url is "something.com/plop/3/1", my schema is respected
+ *    - If my Url is "something.com/plop/2", my schema is respected
+ *    - If my Url is "something.com/plop/hello/2", my schema is not respected due to the fact that the param named "world" has to be a number
+ *
+ * @param         {String}              url                 The url to parse
+ * @param         {String}              schema              The schema with the one we will analyze the url
+ * @return        {Object}                                  An object that describe our parsing process result. Here's the structure of the returned object:
+ * - errors (null) {Object}: An object with all the params in error with the description of the error for each
+ * - params (null) {Object}: An object containing every params grabed from the url with their values for each
+ * - match (true) {Object}: A boolean that tells you if the parsed url match the passed schema or not
+ *
+ * @todo      tests
+ *
+ * @example       js
+ * import { parseSchema } from '@blackbyte/sugar/url';
+ * parseSchema('https://github.com/myApp/main/3', '{project:string}/{?branch:string}/{?idx:number}');
+ * // {
+ * //   url: 'https://github.com/myApp/main/3',
+ * //   schema: '{project:string}/{?branch:string}/{?idx:number}',
+ * //   match: true,
+ * //   errors: null,
+ * //   params: {
+ * //     project: {
+ * //       optional: false,
+ * //       raw: '{project:string}',
+ * //       type: 'string',
+ * //       value: 'myApp'
+ * //     },
+ * //     branch: {
+ * //       optional: true,
+ * //       raw: '{?branch:string},
+ * //       type: 'string',
+ * //       value: 'master'
+ * //     },
+ * //     idx: {
+ * //       optional: true,
+ * //       raw: '{?idx:number}',
+ * //       type: 'number',
+ * //       value: 3
+ * //     }
+ * //   }
+ * // }
+ *
+ * @since       1.0.0
+ * @author 		Olivier Bossel<olivier.bossel@gmail.com>
+ */
+export default function parseSchema(url: string, schema: string): any;

package/dist/shared/url/parseSchema/parseSchema.js

@@ -0,0 +1,183 @@
+// @ts-nocheck
+import parseString from '../../string/parse/parse.js';
+/**
+ * @name                            parseSchema
+ * @namespace                       shared.url
+ * @type                            Function
+ * @platform                        js
+ * @platform                        node
+ * @status                          beta
+ * @private
+ *
+ * This function take two arguments. The first one is the url to parse and the second is a schema to scan the url with.
+ * The schema describe the pathname of an url and tell's how to analyze it.
+ * Here's a little description with some example of schemas:
+ * - "{param1}/{param2}/{param3}": This schema describe that your Url must have 3 "values" named param1, param2 and param3
+ *    - If my Url is "something.com/hello/world/plop", my schema is respected and I can have access to the values through the "schema.params.param1", "schema.params.param2", etc...
+ * - "{hello:string}/{world:number}/{?idx:number}": This schema describe that the Url can have 3 "values" but the last one is optional
+ *    - If my Url is "something.com/plop/3/1", my schema is respected
+ *    - If my Url is "something.com/plop/2", my schema is respected
+ *    - If my Url is "something.com/plop/hello/2", my schema is not respected due to the fact that the param named "world" has to be a number
+ *
+ * @param         {String}              url                 The url to parse
+ * @param         {String}              schema              The schema with the one we will analyze the url
+ * @return        {Object}                                  An object that describe our parsing process result. Here's the structure of the returned object:
+ * - errors (null) {Object}: An object with all the params in error with the description of the error for each
+ * - params (null) {Object}: An object containing every params grabed from the url with their values for each
+ * - match (true) {Object}: A boolean that tells you if the parsed url match the passed schema or not
+ *
+ * @todo      tests
+ *
+ * @example       js
+ * import { parseSchema } from '@blackbyte/sugar/url';
+ * parseSchema('https://github.com/myApp/main/3', '{project:string}/{?branch:string}/{?idx:number}');
+ * // {
+ * //   url: 'https://github.com/myApp/main/3',
+ * //   schema: '{project:string}/{?branch:string}/{?idx:number}',
+ * //   match: true,
+ * //   errors: null,
+ * //   params: {
+ * //     project: {
+ * //       optional: false,
+ * //       raw: '{project:string}',
+ * //       type: 'string',
+ * //       value: 'myApp'
+ * //     },
+ * //     branch: {
+ * //       optional: true,
+ * //       raw: '{?branch:string},
+ * //       type: 'string',
+ * //       value: 'master'
+ * //     },
+ * //     idx: {
+ * //       optional: true,
+ * //       raw: '{?idx:number}',
+ * //       type: 'number',
+ * //       value: 3
+ * //     }
+ * //   }
+ * // }
+ *
+ * @since       1.0.0
+ * @author 		Olivier Bossel<olivier.bossel@gmail.com>
+ */
+export default function parseSchema(url, schema) {
+    const rawSchemaString = schema;
+    const rawUrlString = url;
+    // remove query string
+    url = url.split('?')[0];
+    // get the pathname of the url
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch (e) {
+        pathname = url;
+    }
+    if (pathname.slice(0, 1) === '/')
+        pathname = pathname.slice(1);
+    // init the params object
+    const params = {};
+    const errors = {};
+    let match = true;
+    // split the schema
+    let schemaParts = schema.split('/');
+    // analyze all the schema parts
+    schemaParts = schemaParts
+        .map((part) => {
+        // check if is a param
+        if (part.slice(0, 1) === '{' && part.slice(-1) === '}') {
+            const isOptional = part.slice(0, 2) === '{?' || part.slice(-2) === '?}';
+            const isType = part.indexOf(':') !== -1;
+            let type = null;
+            let name = null;
+            if (isType) {
+                name = part.split(':')[0].slice(1);
+                type = part.split(':')[1].slice(0, -1);
+                if (name.slice(0, 1) === '?')
+                    name = name.slice(1);
+                if (type.slice(-1) === '?')
+                    type = type.slice(0, -1);
+            }
+            else {
+                name = part.slice(1, -1);
+                if (name.slice(-1) === '?')
+                    name = name.slice(0, -1);
+                if (name.slice(0, 1) === '?')
+                    name = name.slice(1);
+            }
+            return {
+                name,
+                type,
+                raw: part,
+                optional: isOptional,
+            };
+        }
+        // this is not a parameter so return as is
+        return part;
+    })
+        .filter((l) => l !== '');
+    schemaParts.forEach((part) => {
+        if (!part.name)
+            return;
+        params[part.name] = Object.assign({}, part);
+        delete params[part.name].name;
+    });
+    // loop on the schema to get the params values
+    // const pathname = url.pathname.slice(1);
+    const splitedPathname = pathname.split('/');
+    for (let i = 0; i < schemaParts.length; i++) {
+        // get the schema for this part
+        const schema = schemaParts[i];
+        // get the part to check
+        const part = splitedPathname[i];
+        // if it's not an object, mean that it's a simple string part
+        if (typeof schema !== 'object') {
+            if (part !== schema)
+                match = false;
+            continue;
+        }
+        if (!part && !schema.optional) {
+            const errorObj = {
+                type: 'optional',
+                description: `This param "${schema.name}" cannot be null...`,
+            };
+            errors[schema.name] = errorObj;
+            params[schema.name].error = errorObj;
+            match = false;
+            continue;
+        }
+        else if (!part && schema.optional) {
+            params[schema.name].value = null;
+            continue;
+        }
+        // check that all correspond to the schema
+        if (schema.type) {
+            const type = schema.type;
+            if (type !== typeof parseString(part)) {
+                match = false;
+                const errorObj = {
+                    type: 'type',
+                    requested: type,
+                    passed: typeof parseString(part),
+                    description: `This param "${schema.name}" has to be a "${type}" but he's a "${typeof parseString(part)}"...`,
+                };
+                errors[schema.name] = errorObj;
+                params[schema.name].error = errorObj;
+                params[schema.name].value = parseString(part);
+                continue;
+            }
+        }
+        // this part match the schema so we add it to the params
+        params[schema.name].value = parseString(part);
+    }
+    // return the schema result
+    return {
+        errors: !Object.keys(errors).length ? null : errors,
+        params: !Object.keys(params).length ? null : params,
+        match,
+        schema: rawSchemaString,
+        url: rawUrlString,
+    };
+}
+//# sourceMappingURL=parseSchema.js.map

package/dist/shared/url/parseSchema/parseSchema.js.map

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

package/dist/shared/url/queryStringToObject/queryStringToObject.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name                queryStringToObject
+ * @namespace           shared.url
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Transform a query string into his object (key => pairs) representation
+ *
+ * @param 	{String}  	queryString  	The query string to process
+ * @return 	{Object} 					The object representation of the query string
+ *
+ * @todo      tests
+ *
+ * @snippet         queryStringToObject($1)
+ *
+ * @example    js
+ * import { queryStringToObject } from '@blackbyte/sugar/url'
+ * queryStringToObject('?var1=value1&var2=value2') // { var1: 'value1', var2: 'value2' }
+ *
+ * @see  	http://stackoverflow.com/questions/8648892/convert-url-parameters-to-a-javascript-object
+ * @since     1.0.0
+ * @author 	Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function queryStringToObject(str: string): any;

package/dist/shared/url/queryStringToObject/queryStringToObject.js

@@ -0,0 +1,47 @@
+import ltrim from '../../string/ltrim/ltrim.js';
+/**
+ * @name                queryStringToObject
+ * @namespace           shared.url
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Transform a query string into his object (key => pairs) representation
+ *
+ * @param 	{String}  	queryString  	The query string to process
+ * @return 	{Object} 					The object representation of the query string
+ *
+ * @todo      tests
+ *
+ * @snippet         queryStringToObject($1)
+ *
+ * @example    js
+ * import { queryStringToObject } from '@blackbyte/sugar/url'
+ * queryStringToObject('?var1=value1&var2=value2') // { var1: 'value1', var2: 'value2' }
+ *
+ * @see  	http://stackoverflow.com/questions/8648892/convert-url-parameters-to-a-javascript-object
+ * @since     1.0.0
+ * @author 	Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function queryStringToObject(str) {
+    str = ltrim(str, '?');
+    str = str.replace(/%20/gm, ' ');
+    str = decodeURIComponent(str);
+    let chunks = str.split('&');
+    const obj = {};
+    chunks = chunks.filter((ch) => {
+        return ch !== '';
+    });
+    for (let c = 0; c < chunks.length; c++) {
+        const split = chunks[c].split('=', 2);
+        if (split[1] !== undefined) {
+            obj[split[0]] = split[1];
+        }
+        else {
+            obj[split[0]] = true;
+        }
+    }
+    return obj;
+}
+//# sourceMappingURL=queryStringToObject.js.map

package/dist/shared/url/queryStringToObject/queryStringToObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryStringToObject.js","sourceRoot":"","sources":["../../../../src/shared/url/queryStringToObject/queryStringToObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,6BAA6B,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAW;IACrD,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAChC,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QAC5B,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shared/url/urlFromString/urlFromString.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name            urlFromString
+ * @namespace       shared.url
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @platform         ts
+ * @status          stable
+ *
+ * Simple function that take a string as parameter and returns you a valid
+ * url ready one
+ *
+ * @todo            tests
+ *
+ * @snippet         urlFromString($1)
+ *
+ * @example             js
+ * import { urlFromString } from '@blackbyte/sugar/url';
+ * urlFromString('Sir James Paul McCartney MBE is an English singer-songwriter');
+ * // sir-james-paul-mc-cartney-mbe-is-an-english-singer-songwriter
+ *
+ * @see             https://www.npmjs.com/package/url-slug
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function urlFromString(string: string): string;

package/dist/shared/url/urlFromString/urlFromString.js

@@ -0,0 +1,36 @@
+import urlSlug from 'url';
+/**
+ * @name            urlFromString
+ * @namespace       shared.url
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @platform         ts
+ * @status          stable
+ *
+ * Simple function that take a string as parameter and returns you a valid
+ * url ready one
+ *
+ * @todo            tests
+ *
+ * @snippet         urlFromString($1)
+ *
+ * @example             js
+ * import { urlFromString } from '@blackbyte/sugar/url';
+ * urlFromString('Sir James Paul McCartney MBE is an English singer-songwriter');
+ * // sir-james-paul-mc-cartney-mbe-is-an-english-singer-songwriter
+ *
+ * @see             https://www.npmjs.com/package/url-slug
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function urlFromString(string) {
+    return string
+        .split('/')
+        .map((l) => {
+        // @ts-ignore
+        return urlSlug(l.trim());
+    })
+        .join('/');
+}
+//# sourceMappingURL=urlFromString.js.map

package/dist/shared/url/urlFromString/urlFromString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlFromString.js","sourceRoot":"","sources":["../../../../src/shared/url/urlFromString/urlFromString.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,KAAK,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAc;IAClD,OAAO,MAAM;SACV,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,aAAa;QACb,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

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

@@ -1,2 +1,2 @@
-import assert from './assert.js';
+import assert from './assert/assert.js';
 export { assert as __assert, assert };

package/dist/shared/utils/_exports.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/utils/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/utils/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC"}

package/dist/shared/utils/assert/assert.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @name           assert
+ * @namespace      shared.utils
+ * @type           Function
+ * @platform       js
+ * @platform       node
+ * @status         stable
+ *
+ * Checks a condition and throws an error if the condition is not met
+ *
+ * @param       {boolean}           condition            The condition to check
+ * @param       {string}            message              The error message to display if the condition fails
+ *
+ * @throws {Error} - Throws an error if the condition is not met
+ *
+ * @since       1.0.0
+ * @author 		Olivier Bossel<olivier.bossel@gmail.com>
+ */
+export default function assert(condition: any, message: string): void;

package/dist/shared/utils/assert/assert.js

@@ -0,0 +1,25 @@
+/**
+ * @name           assert
+ * @namespace      shared.utils
+ * @type           Function
+ * @platform       js
+ * @platform       node
+ * @status         stable
+ *
+ * Checks a condition and throws an error if the condition is not met
+ *
+ * @param       {boolean}           condition            The condition to check
+ * @param       {string}            message              The error message to display if the condition fails
+ *
+ * @throws {Error} - Throws an error if the condition is not met
+ *
+ * @since       1.0.0
+ * @author 		Olivier Bossel<olivier.bossel@gmail.com>
+ */
+export default function assert(condition, message) {
+    if (!condition) {
+        console.error(message);
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/shared/utils/assert/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../../src/shared/utils/assert/assert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,SAAc,EAAE,OAAe;IAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackbyte/sugar",
   "description": "The toolkit that you missed... like a sugar in your coffee!",
-  "version": "1.0.0-beta.28",
+  "version": "1.0.0-beta.29",
   "keywords": [
     "javascript",
     "typescript",
@@ -21,8 +21,16 @@
     "clean": "rm -rf src/**/*.js src/**/*.d.ts src/**/*.map",
     "build": "tsc",
     "doc.build": "blackbyte docmap.build --mdx --outPath ../website-sugar/docmap.json --outDir ../website-sugar/src/content/sugar",
-    "test": "vitest",
-    "publish": "npm publish --access public --tag latest"
+    "test": "vitest --project=unit",
+    "test:browser": "vitest --project=browser",
+    "test:browser:chrome": "vitest --project=browser --browser=chromium",
+    "test:browser:firefox": "vitest --project=browser --browser=firefox",
+    "test:browser:safari": "vitest --project=browser --browser=webkit",
+    "test:browser:headed": "vitest --project=browser --browser.headless=false",
+    "test:js": "vitest src/js --project=unit",
+    "test:js:browser": "vitest src/js --project=browser",
+    "test:all": "vitest",
+    "publish": "vitest run --project=unit && vitest run --project=browser && npm publish --access public --tag latest"
   },
   "author": "Blackbyte <hello@blackbyte.space> (https://blackbyte.space)",
   "contributors": [
@@ -192,22 +200,21 @@
     }
   },
   "devDependencies": {
-    "@types/blueimp-md5": "^2.18.2",
     "@types/copy-paste": "^1",
     "@types/is-glob": "^4",
     "@types/is-valid-path": "^0",
+    "@types/luxon": "^3.7.1",
     "@types/node": "^20.11.30",
     "@vitest/browser": "^4.0.18",
+    "@vitest/browser-playwright": "^4.0.18",
+    "happy-dom": "^20.8.3",
+    "playwright": "^1.58.2",
     "typescript": "^5.4.2",
     "vitest": "^4.0.18"
   },
   "dependencies": {
     "@faker-js/faker": "^8.4.1",
-    "@types/luxon": "^3.7.1",
     "aggregation": "^1.2.7",
-    "atob": "^2.1.2",
-    "blueimp-md5": "^2.19.0",
-    "btoa": "^1.2.1",
     "chalk": "^5.3.0",
     "change-case": "^5.4.3",
     "clipboardy": "^4.0.0",
@@ -221,39 +228,36 @@
     "fecha": "^4.2.3",
     "filesize": "^10.1.0",
     "find-package-json": "^1.2.0",
-    "flat": "^6.0.1",
     "flattenjs": "^2.1.3",
     "fs-extra": "^11.2.0",
-    "glob": "^10.3.10",
+    "glob": "^13.0.6",
     "has-ansi": "^6.0.0",
     "hash-sum": "^2.0.0",
     "hasha": "^6.0.0",
-    "html-entities": "^2.5.2",
+    "html-entities": "^2.6.0",
     "is-class": "^0.0.9",
     "is-equal": "^1.7.0",
     "is-glob": "^4.0.3",
     "is-valid-path": "^0.1.1",
-    "isbot": "^5.1.30",
-    "js-ago": "^2.1.1",
-    "js-md5": "^0.8.3",
+    "isbot": "^5.1.35",
+    "js-ago": "^3.0.1",
     "json-cyclic": "^1.0.2",
     "lodash.clone": "^4.5.0",
     "lodash.clonedeep": "^4.5.0",
     "luxon": "^3.7.2",
     "mark.js": "^8.11.1",
-    "memoizee": "^0.4.15",
-    "micromatch": "^4.0.5",
-    "minimatch": "^10.2.3",
-    "param-case": "^4.0.0",
+    "memoizee": "^0.4.17",
+    "micromatch": "^4.0.8",
+    "minimatch": "^10.2.4",
     "rematrix": "^0.7.2",
-    "semver": "^7.6.2",
+    "semver": "^7.7.4",
     "sprintf-js": "^1.1.3",
-    "strip-ansi": "^7.1.0",
+    "strip-ansi": "^7.1.2",
     "strip-css-comments": "^5.0.0",
     "striptags": "^3.2.0",
     "temp-dir": "^3.0.0",
     "unescape": "^1.0.1",
-    "uuid": "^9.0.1",
+    "uuid": "^13.0.0",
     "vite": "7.3.1"
   },
   "gitHead": "3a760e37ec10e3f90acac5df9e74cdb09750ff5f"