@blackbyte/sugar 1.0.0-beta.3 → 1.0.0-beta.30

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.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.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.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.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.3",
+  "version": "1.0.0-beta.30",
   "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 beta"
+    "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,21 +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": "^1.3.1",
+    "@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": "^1.3.1"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "@faker-js/faker": "^8.4.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",
@@ -216,42 +224,41 @@
     "currency-symbol-map": "^5.1.0",
     "escape-html": "^1.0.3",
     "fast-folder-size": "^2.2.0",
-    "fast-xml-parser": "^4.3.5",
+    "fast-xml-parser": "^5.3.9",
     "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": "^9.0.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"
 }

package/dist/js/clipboard/copyFile.d.ts

@@ -1,26 +0,0 @@
-/**
- * @name                copyFile
- * @namespace           js.clipboard
- * @type                Function
- * @platform            js
- * @async
- * @status              stable
- *
- * This function allows you to copy to the clipboard the passed file path/url
- *
- * @param       {String}            url            The file url copy to the clipboard
- * @return      {Promise}                          A promise fullfilled when the copy has been made correctly
- *
- * @todo     tests
- *
- * @snippet         __copyFile($1)
- *
- * @example         js
- * import { copyFile } from '@blackbyte/sugar/clipboard';
- * copyFile('https://www.google.com/favicon.ico');
- *
- * @see             https://sentry.io/answers/how-do-i-copy-to-the-clipboard-in-javascript/#:~:text=To%20write%20text%20to%20the,in%20the%20active%20browser%20tab.
- * @since           1.0.0
- * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function copyFile(url: string): Promise<void>;

package/dist/js/clipboard/copyFile.js

@@ -1,46 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-/**
- * @name                copyFile
- * @namespace           js.clipboard
- * @type                Function
- * @platform            js
- * @async
- * @status              stable
- *
- * This function allows you to copy to the clipboard the passed file path/url
- *
- * @param       {String}            url            The file url copy to the clipboard
- * @return      {Promise}                          A promise fullfilled when the copy has been made correctly
- *
- * @todo     tests
- *
- * @snippet         __copyFile($1)
- *
- * @example         js
- * import { copyFile } from '@blackbyte/sugar/clipboard';
- * copyFile('https://www.google.com/favicon.ico');
- *
- * @see             https://sentry.io/answers/how-do-i-copy-to-the-clipboard-in-javascript/#:~:text=To%20write%20text%20to%20the,in%20the%20active%20browser%20tab.
- * @since           1.0.0
- * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function copyFile(url) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const data = yield fetch(url);
-        const blob = yield data.blob();
-        return navigator.clipboard.write([
-            new ClipboardItem({
-                [blob.type]: blob,
-            }),
-        ]);
-    });
-}
-//# sourceMappingURL=copyFile.js.map

package/dist/js/clipboard/copyFile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"copyFile.js","sourceRoot":"","sources":["../../../src/js/clipboard/copyFile.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAgB,QAAQ,CAAC,GAAW;;QAChD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;YAC/B,IAAI,aAAa,CAAC;gBAChB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;aAClB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CAAA"}

package/dist/js/clipboard/copyText.d.ts

@@ -1,26 +0,0 @@
-/**
- * @name                copyText
- * @namespace           js.clipboard
- * @type                Function
- * @platform            js
- * @async
- * @status              stable
- *
- * This function allows you to copy to the clipboard the passed text
- *
- * @param       {String}            text            The text to copy
- * @return      {Promise}                          A promise fullfilled when the copy has been made correctly
- *
- * @todo     tests
- *
- * @snippet         __copy($1)
- *
- * @example         js
- * import { copyText } from '@blackbyte/sugar/clipboard';
- * copyText('Hello world');
- *
- * @see             https://sentry.io/answers/how-do-i-copy-to-the-clipboard-in-javascript/#:~:text=To%20write%20text%20to%20the,in%20the%20active%20browser%20tab.
- * @since           1.0.0
- * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function copyText(text: string): Promise<void>;

package/dist/js/clipboard/copyText.js

@@ -1,33 +0,0 @@
-/**
- * @name                copyText
- * @namespace           js.clipboard
- * @type                Function
- * @platform            js
- * @async
- * @status              stable
- *
- * This function allows you to copy to the clipboard the passed text
- *
- * @param       {String}            text            The text to copy
- * @return      {Promise}                          A promise fullfilled when the copy has been made correctly
- *
- * @todo     tests
- *
- * @snippet         __copy($1)
- *
- * @example         js
- * import { copyText } from '@blackbyte/sugar/clipboard';
- * copyText('Hello world');
- *
- * @see             https://sentry.io/answers/how-do-i-copy-to-the-clipboard-in-javascript/#:~:text=To%20write%20text%20to%20the,in%20the%20active%20browser%20tab.
- * @since           1.0.0
- * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function copyText(text) {
-    var _a;
-    if ((_a = navigator === null || navigator === void 0 ? void 0 : navigator.clipboard) === null || _a === void 0 ? void 0 : _a.writeText) {
-        return navigator.clipboard.writeText(text);
-    }
-    return Promise.reject('The Clipboard API is not available.');
-}
-//# sourceMappingURL=copyText.js.map

package/dist/js/clipboard/copyText.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"copyText.js","sourceRoot":"","sources":["../../../src/js/clipboard/copyText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,IAAY;;IAC3C,IAAI,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,0CAAE,SAAS,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/js/clipboard/readFile.d.ts

@@ -1,24 +0,0 @@
-/**
- * @name                readFile
- * @namespace           js.clipboard
- * @type                Function
- * @platform            js
- * @async
- * @status              stable
- *
- * This function allows you to read the file copied to clipboard
- *
- * @return      {Promise}                          A promise fullfilled when the content has been read correctly
- *
- * @todo     tests
- *
- * @snippet         __readFile($1)
- *
- * @example         js
- * import { readFile } from '@blackbyte/sugar/clipboard';
- * await readFile();
- *
- * @since           1.0.0
- * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function readText(): Promise<any>;

package/dist/js/clipboard/readFile.js

@@ -1,42 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-/**
- * @name                readFile
- * @namespace           js.clipboard
- * @type                Function
- * @platform            js
- * @async
- * @status              stable
- *
- * This function allows you to read the file copied to clipboard
- *
- * @return      {Promise}                          A promise fullfilled when the content has been read correctly
- *
- * @todo     tests
- *
- * @snippet         __readFile($1)
- *
- * @example         js
- * import { readFile } from '@blackbyte/sugar/clipboard';
- * await readFile();
- *
- * @since           1.0.0
- * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function readText() {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        if ((_a = navigator === null || navigator === void 0 ? void 0 : navigator.clipboard) === null || _a === void 0 ? void 0 : _a.read) {
-            return navigator.clipboard.read();
-        }
-        return Promise.reject('The Clipboard API is not available.');
-    });
-}
-//# sourceMappingURL=readFile.js.map

package/dist/js/clipboard/readFile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"readFile.js","sourceRoot":"","sources":["../../../src/js/clipboard/readFile.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAgB,QAAQ;;;QACpC,IAAI,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,0CAAE,IAAI,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;IAC/D,CAAC;CAAA"}

package/dist/js/clipboard/readText.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"readText.js","sourceRoot":"","sources":["../../../src/js/clipboard/readText.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAgB,QAAQ;;;QACpC,IAAI,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,0CAAE,QAAQ,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;IAC/D,CAAC;CAAA"}

package/dist/js/console/parseHtml.d.ts

@@ -1,18 +0,0 @@
-/**
- * @name                      parseHtml
- * @namespace                 js.console
- * @type                      Function
- * @platform                  js
- * @status                    beta
- *
- * Parse the simple html tags to format the console message
- *
- * @param           {String|Array}                  message           The message to format of an array of messages to format
- * @return          {String}                                          The formated message
- *
- * @snippet         parseHtml($1)
- *
- * @since       2.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function parseHtml(message: any): any;