@koine/utils 2.0.0-beta.82 → 2.0.0-beta.83

package/normaliseUrl.esm.js

@@ -1,5 +1,13 @@
 import { removeTrailingSlash } from './removeTrailingSlash.esm.js';
 
-let normaliseUrl=(e="")=>removeTrailingSlash(e.replace(/(:\/\/)|(\/)+/g,"$1$2"));
+/**
+ * Normalise URL, it works both for absolute and relative URLs
+ *
+ * - replaces too many consecutive slashes (except `http{s}://`)
+ * - removes the trailing slash
+ *
+ * @category location
+ * @see https://stackoverflow.com/a/40649435/1938970
+ */let normaliseUrl=(e="")=>removeTrailingSlash(e.replace(/(:\/\/)|(\/)+/g,"$1$2"));
 
 export { normaliseUrl as default, normaliseUrl };

package/normaliseUrlPathname.cjs.js

@@ -4,7 +4,14 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var removeTrailingSlash = require('./removeTrailingSlash.cjs.js');
 
-let normaliseUrlPathname=(r="")=>removeTrailingSlash.removeTrailingSlash(r.replace(/\/+/g,"/"));
+/**
+ * Normalise URL pathname (relative URL)
+ *
+ * - replaces too many consecutive slashes
+ * - removes the trailing slash
+ *
+ * @category location
+ */let normaliseUrlPathname=(r="")=>removeTrailingSlash.removeTrailingSlash(r.replace(/\/+/g,"/"));
 
 exports["default"] = normaliseUrlPathname;
 exports.normaliseUrlPathname = normaliseUrlPathname;

package/normaliseUrlPathname.esm.js

@@ -1,5 +1,12 @@
 import { removeTrailingSlash } from './removeTrailingSlash.esm.js';
 
-let normaliseUrlPathname=(r="")=>removeTrailingSlash(r.replace(/\/+/g,"/"));
+/**
+ * Normalise URL pathname (relative URL)
+ *
+ * - replaces too many consecutive slashes
+ * - removes the trailing slash
+ *
+ * @category location
+ */let normaliseUrlPathname=(r="")=>removeTrailingSlash(r.replace(/\/+/g,"/"));
 
 export { normaliseUrlPathname as default, normaliseUrlPathname };

package/objectFlat.cjs.js

@@ -2,7 +2,14 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let objectFlat=(e,t=".",o="")=>Object.keys(e).reduce((c,l)=>{let b=o?`${o}${t}${l}`:l;return "object"==typeof e[l]?c={...c,...objectFlat(e[l],t,b)}:c[b]=e[l],c},{});
+/**
+ * Flatten an object concatenating its nested keys with the given delimiter
+ *
+ * @category object
+ *
+ * @param obj Input object
+ * @param delimiter `.` dot by default
+ */let objectFlat=(e,t=".",o="")=>Object.keys(e).reduce((c,l)=>{let b=o?`${o}${t}${l}`:l;return "object"==typeof e[l]?c={...c,...objectFlat(e[l],t,b)}:c[b]=e[l],c},{});
 
 exports["default"] = objectFlat;
 exports.objectFlat = objectFlat;

package/objectFlat.esm.js

@@ -1,3 +1,10 @@
-let objectFlat=(e,t=".",o="")=>Object.keys(e).reduce((c,l)=>{let b=o?`${o}${t}${l}`:l;return "object"==typeof e[l]?c={...c,...objectFlat(e[l],t,b)}:c[b]=e[l],c},{});
+/**
+ * Flatten an object concatenating its nested keys with the given delimiter
+ *
+ * @category object
+ *
+ * @param obj Input object
+ * @param delimiter `.` dot by default
+ */let objectFlat=(e,t=".",o="")=>Object.keys(e).reduce((c,l)=>{let b=o?`${o}${t}${l}`:l;return "object"==typeof e[l]?c={...c,...objectFlat(e[l],t,b)}:c[b]=e[l],c},{});
 
 export { objectFlat as default, objectFlat };

package/objectFlip.cjs.js

@@ -2,7 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let objectFlip=(e,t)=>Object.fromEntries(Object.entries(e).map(([e,o])=>[o,t?t(e):e]));
+/**
+ * @category object
+ * @borrows [jacobparis.com](https://www.jacobparis.com/content/reversing-a-record-in-typescript#typescript)
+ */let objectFlip=(e,t)=>Object.fromEntries(Object.entries(e).map(([e,o])=>[o,t?t(e):e]));
 
 exports["default"] = objectFlip;
 exports.objectFlip = objectFlip;

package/objectFlip.esm.js

@@ -1,3 +1,6 @@
-let objectFlip=(e,t)=>Object.fromEntries(Object.entries(e).map(([e,o])=>[o,t?t(e):e]));
+/**
+ * @category object
+ * @borrows [jacobparis.com](https://www.jacobparis.com/content/reversing-a-record-in-typescript#typescript)
+ */let objectFlip=(e,t)=>Object.fromEntries(Object.entries(e).map(([e,o])=>[o,t?t(e):e]));
 
 export { objectFlip as default, objectFlip };

package/objectMergeWithDefaults.cjs.js

@@ -6,7 +6,35 @@ var isObject = require('./isObject.cjs.js');
 require('./isPlainObject.cjs.js');
 require('./getType.cjs.js');
 
-let objectMergeWithDefaults=(t,o)=>o?Object.keys(o).reduce((r,c)=>(isObject.isObject(o[c])?(t[c]||(t[c]={}),r[c]=objectMergeWithDefaults(t[c],o[c])):r[c]=void 0===o[c]?t[c]:o[c],r),{...t}):t;
+// export type ObjectMergeWithDefaults<Defaults, Overrides> = Simplify<
+//   Overrides extends undefined
+//     ? Defaults
+//     : Overrides extends PlainObject
+//       ? {
+//           [K in keyof Overrides]-?: Overrides[K] extends undefined
+//             ? K extends keyof Defaults
+//               ? Defaults[K]
+//               : never
+//             : K extends keyof Defaults
+//               ? ObjectMergeWithDefaults<Defaults[K], Overrides[K]>
+//               : Overrides[K];
+//         } /*  & (Defaults extends PlainObject
+//           ? {
+//               [K in Exclude<keyof Defaults, keyof Overrides>]: Defaults[K];
+//             }
+//           : Defaults) */
+//       : Overrides
+// >;
+/**
+ * Merge object _overrides_ onto object _defaults_, immutably
+ *
+ * Simple object merging utility, by design:
+ * - no `array` support
+ * - `undefined` values do not override default values, a.k.a. it makes it harder
+ * to remove a property defined on the defaults
+ *
+ * @category object
+ */let objectMergeWithDefaults=(t,o)=>o?Object.keys(o).reduce((r,c)=>(isObject.isObject(o[c])?(t[c]||(t[c]={}),r[c]=objectMergeWithDefaults(t[c],o[c])):r[c]=void 0===o[c]?t[c]:o[c],r),{...t}):t;
 
 exports["default"] = objectMergeWithDefaults;
 exports.objectMergeWithDefaults = objectMergeWithDefaults;

package/objectMergeWithDefaults.esm.js

@@ -2,6 +2,34 @@ import { isObject } from './isObject.esm.js';
 import './isPlainObject.esm.js';
 import './getType.esm.js';
 
-let objectMergeWithDefaults=(t,o)=>o?Object.keys(o).reduce((r,c)=>(isObject(o[c])?(t[c]||(t[c]={}),r[c]=objectMergeWithDefaults(t[c],o[c])):r[c]=void 0===o[c]?t[c]:o[c],r),{...t}):t;
+// export type ObjectMergeWithDefaults<Defaults, Overrides> = Simplify<
+//   Overrides extends undefined
+//     ? Defaults
+//     : Overrides extends PlainObject
+//       ? {
+//           [K in keyof Overrides]-?: Overrides[K] extends undefined
+//             ? K extends keyof Defaults
+//               ? Defaults[K]
+//               : never
+//             : K extends keyof Defaults
+//               ? ObjectMergeWithDefaults<Defaults[K], Overrides[K]>
+//               : Overrides[K];
+//         } /*  & (Defaults extends PlainObject
+//           ? {
+//               [K in Exclude<keyof Defaults, keyof Overrides>]: Defaults[K];
+//             }
+//           : Defaults) */
+//       : Overrides
+// >;
+/**
+ * Merge object _overrides_ onto object _defaults_, immutably
+ *
+ * Simple object merging utility, by design:
+ * - no `array` support
+ * - `undefined` values do not override default values, a.k.a. it makes it harder
+ * to remove a property defined on the defaults
+ *
+ * @category object
+ */let objectMergeWithDefaults=(t,o)=>o?Object.keys(o).reduce((r,c)=>(isObject(o[c])?(t[c]||(t[c]={}),r[c]=objectMergeWithDefaults(t[c],o[c])):r[c]=void 0===o[c]?t[c]:o[c],r),{...t}):t;
 
 export { objectMergeWithDefaults as default, objectMergeWithDefaults };

package/objectOmit.cjs.js

@@ -2,7 +2,15 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let objectOmit=(e,t)=>Object.keys(e).reduce((c,o)=>(t.includes(o)||(c[o]=e[o]),c),{});
+/**
+ * Omit object properties by removing the given keys, it returns a
+ * new object.
+ *
+ * NOTE: most of the time using a normal [destructuring assignment](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment) is enough,
+ * use this utility only when it makes sense.
+ *
+ * @category object
+ */let objectOmit=(e,t)=>Object.keys(e).reduce((c,o)=>(t.includes(o)||(c[o]=e[o]),c),{});
 
 exports["default"] = objectOmit;
 exports.objectOmit = objectOmit;

package/objectOmit.esm.js

@@ -1,3 +1,11 @@
-let objectOmit=(e,t)=>Object.keys(e).reduce((c,o)=>(t.includes(o)||(c[o]=e[o]),c),{});
+/**
+ * Omit object properties by removing the given keys, it returns a
+ * new object.
+ *
+ * NOTE: most of the time using a normal [destructuring assignment](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment) is enough,
+ * use this utility only when it makes sense.
+ *
+ * @category object
+ */let objectOmit=(e,t)=>Object.keys(e).reduce((c,o)=>(t.includes(o)||(c[o]=e[o]),c),{});
 
 export { objectOmit as default, objectOmit };

package/objectPick.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let objectPick=(e,t)=>{let o={},r=t.length;for(;r--;)o[t[r]]=e[t[r]];return o};
+/**
+ * Pick object properties by selecting only the given keys, it returns a
+ * new object.
+ *
+ * @category object
+ */let objectPick=(e,t)=>{let o={},r=t.length;for(;r--;)o[t[r]]=e[t[r]];return o};
 
 exports["default"] = objectPick;
 exports.objectPick = objectPick;

package/objectPick.esm.js

@@ -1,3 +1,8 @@
-let objectPick=(e,t)=>{let o={},r=t.length;for(;r--;)o[t[r]]=e[t[r]];return o};
+/**
+ * Pick object properties by selecting only the given keys, it returns a
+ * new object.
+ *
+ * @category object
+ */let objectPick=(e,t)=>{let o={},r=t.length;for(;r--;)o[t[r]]=e[t[r]];return o};
 
 export { objectPick as default, objectPick };

package/objectSort.cjs.js

@@ -2,7 +2,14 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let objectSort=(t,e)=>Object.fromEntries(Object.entries(t).sort(e));
+/**
+ * @category object
+ *
+ * @pure
+ * @param data The object whose properties you want to sort
+ * @param compareFn Function used to determine the order of the elements. It is expected to return a negative value if the first argument is less than the second argument, zero if they're equal, and a positive value otherwise. If omitted, the elements are sorted in ascending, ASCII character order.
+ * @returns a _new_ object
+ */let objectSort=(t,e)=>Object.fromEntries(Object.entries(t).sort(e));
 
 exports["default"] = objectSort;
 exports.objectSort = objectSort;

package/objectSort.esm.js

@@ -1,3 +1,10 @@
-let objectSort=(t,e)=>Object.fromEntries(Object.entries(t).sort(e));
+/**
+ * @category object
+ *
+ * @pure
+ * @param data The object whose properties you want to sort
+ * @param compareFn Function used to determine the order of the elements. It is expected to return a negative value if the first argument is less than the second argument, zero if they're equal, and a positive value otherwise. If omitted, the elements are sorted in ascending, ASCII character order.
+ * @returns a _new_ object
+ */let objectSort=(t,e)=>Object.fromEntries(Object.entries(t).sort(e));
 
 export { objectSort as default, objectSort };

package/objectSortByKeysMatching.cjs.js

@@ -4,7 +4,15 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var objectSort = require('./objectSort.cjs.js');
 
-let objectSortByKeysMatching=(o,e)=>objectSort.objectSort(o,([t],[o])=>t===e?-1:t.localeCompare(o));
+/**
+ * @category object
+ *
+ * @pure
+ * @param data The object whose properties you want to sort
+ * @param keyMatch The value to compare to each `data` object keys, the ones
+ * matching it is sorted first, the rest are sorted by `localeCompare` on keys
+ * @returns a _new_ object
+ */let objectSortByKeysMatching=(o,e)=>objectSort.objectSort(o,([t],[o])=>t===e?-1:t.localeCompare(o));// Object.fromEntries(
 
 exports["default"] = objectSortByKeysMatching;
 exports.objectSortByKeysMatching = objectSortByKeysMatching;

package/objectSortByKeysMatching.esm.js

@@ -1,5 +1,13 @@
 import { objectSort } from './objectSort.esm.js';
 
-let objectSortByKeysMatching=(o,e)=>objectSort(o,([t],[o])=>t===e?-1:t.localeCompare(o));
+/**
+ * @category object
+ *
+ * @pure
+ * @param data The object whose properties you want to sort
+ * @param keyMatch The value to compare to each `data` object keys, the ones
+ * matching it is sorted first, the rest are sorted by `localeCompare` on keys
+ * @returns a _new_ object
+ */let objectSortByKeysMatching=(o,e)=>objectSort(o,([t],[o])=>t===e?-1:t.localeCompare(o));// Object.fromEntries(
 
 export { objectSortByKeysMatching as default, objectSortByKeysMatching };

package/objectToArray.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let objectToArray=(e,t)=>Object.keys(e).map(t);
+/**
+ * Quick typed replacement of `Object.keys(object).map(key => ...)`
+ *
+ * @category array
+ * @category object
+ */let objectToArray=(e,t)=>Object.keys(e).map(t);
 
 exports["default"] = objectToArray;
 exports.objectToArray = objectToArray;

package/objectToArray.esm.js

@@ -1,3 +1,8 @@
-let objectToArray=(e,t)=>Object.keys(e).map(t);
+/**
+ * Quick typed replacement of `Object.keys(object).map(key => ...)`
+ *
+ * @category array
+ * @category object
+ */let objectToArray=(e,t)=>Object.keys(e).map(t);
 
 export { objectToArray as default, objectToArray };

package/package.json

@@ -849,5 +849,5 @@
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
-  "version": "2.0.0-beta.82"
+  "version": "2.0.0-beta.83"
 }

package/parseCookie.cjs.js

@@ -2,7 +2,19 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let t=(t,e)=>{try{return e(t)}catch(e){return t}};let parseCookie=(e,r={})=>{if("string"!=typeof e)throw TypeError("argument str must be a string");let i={},n=e.split(";"),{decode:o=decodeURIComponent}=r;for(let e=0;e<n.length;e++){let r=n[e],l=r.indexOf("=");if(l<0)continue;let s=r.substring(0,l).trim();if(void 0==i[s]){let e=r.substring(l+1,r.length).trim();'"'===e[0]&&(e=e.slice(1,-1)),i[s]=t(e,o);}}return i};
+/**
+ * Try decoding a string using a decoding function.
+ */let t=(t,e)=>{try{return e(t)}catch(e){return t}};/**
+ * Parse a cookie header.
+ *
+ * Parse the given cookie header string into an object
+ * The object has the various cookies as keys(names) => values
+ *
+ * @category cookie
+ */let parseCookie=(e,r={})=>{if("string"!=typeof e)throw TypeError("argument str must be a string");let i={},n=e.split(";"),{decode:o=decodeURIComponent}=r;for(let e=0;e<n.length;e++){let r=n[e],l=r.indexOf("=");// skip things that don't look like key=value
+if(l<0)continue;let s=r.substring(0,l).trim();// only assign once
+if(void 0==i[s]){let e=r.substring(l+1,r.length).trim();'"'===// quoted values
+e[0]&&(e=e.slice(1,-1)),i[s]=t(e,o);}}return i};
 
 exports["default"] = parseCookie;
 exports.parseCookie = parseCookie;

package/parseCookie.esm.js

@@ -1,3 +1,15 @@
-let t=(t,e)=>{try{return e(t)}catch(e){return t}};let parseCookie=(e,r={})=>{if("string"!=typeof e)throw TypeError("argument str must be a string");let i={},n=e.split(";"),{decode:o=decodeURIComponent}=r;for(let e=0;e<n.length;e++){let r=n[e],l=r.indexOf("=");if(l<0)continue;let s=r.substring(0,l).trim();if(void 0==i[s]){let e=r.substring(l+1,r.length).trim();'"'===e[0]&&(e=e.slice(1,-1)),i[s]=t(e,o);}}return i};
+/**
+ * Try decoding a string using a decoding function.
+ */let t=(t,e)=>{try{return e(t)}catch(e){return t}};/**
+ * Parse a cookie header.
+ *
+ * Parse the given cookie header string into an object
+ * The object has the various cookies as keys(names) => values
+ *
+ * @category cookie
+ */let parseCookie=(e,r={})=>{if("string"!=typeof e)throw TypeError("argument str must be a string");let i={},n=e.split(";"),{decode:o=decodeURIComponent}=r;for(let e=0;e<n.length;e++){let r=n[e],l=r.indexOf("=");// skip things that don't look like key=value
+if(l<0)continue;let s=r.substring(0,l).trim();// only assign once
+if(void 0==i[s]){let e=r.substring(l+1,r.length).trim();'"'===// quoted values
+e[0]&&(e=e.slice(1,-1)),i[s]=t(e,o);}}return i};
 
 export { parseCookie as default, parseCookie };

package/parseURL.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let parseURL=t=>{let e=t.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);return e&&{href:t,protocol:e[1],host:e[2],hostname:e[3],port:e[4],pathname:e[5],search:e[6],hash:e[7]}};
+/**
+ * Solution without DOM or specific env native methods
+ *
+ * @category location
+ * @see https://stackoverflow.com/a/21553982/1938970
+ */let parseURL=t=>{let e=t.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);return e&&{href:t,protocol:e[1],host:e[2],hostname:e[3],port:e[4],pathname:e[5],search:e[6],hash:e[7]}};
 
 exports["default"] = parseURL;
 exports.parseURL = parseURL;

package/parseURL.esm.js

@@ -1,3 +1,8 @@
-let parseURL=t=>{let e=t.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);return e&&{href:t,protocol:e[1],host:e[2],hostname:e[3],port:e[4],pathname:e[5],search:e[6],hash:e[7]}};
+/**
+ * Solution without DOM or specific env native methods
+ *
+ * @category location
+ * @see https://stackoverflow.com/a/21553982/1938970
+ */let parseURL=t=>{let e=t.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);return e&&{href:t,protocol:e[1],host:e[2],hostname:e[3],port:e[4],pathname:e[5],search:e[6],hash:e[7]}};
 
 export { parseURL as default, parseURL };

package/quaranteneProps.cjs.js

@@ -2,7 +2,23 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let quaranteneProps=(e,t)=>{let r={_:{}};for(let n in e){let l=e[n];t.includes(n)?r._[n]=l:r[n]=l;}return r};
+/**
+ * @category impl
+ * @example
+ *
+ * ```ts
+ * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
+ *   "onPointerLeave",
+ *   "onPointerMove",
+ *   "onClick",
+ *   "onPointerDown",
+ *   "onPointerUp",
+ *   "onKeyDown",
+ * ]);
+ * ```
+ */let quaranteneProps=(e,t)=>{// approach 1)
+let r={_:{}};for(let n in e){let l=e[n];t.includes(n)?r._[n]=l:// @ts-expect-error nevermind
+r[n]=l;}return r};// for these types see https://stackoverflow.com/a/65673414/1938970
 
 exports["default"] = quaranteneProps;
 exports.quaranteneProps = quaranteneProps;

package/quaranteneProps.esm.js

@@ -1,3 +1,19 @@
-let quaranteneProps=(e,t)=>{let r={_:{}};for(let n in e){let l=e[n];t.includes(n)?r._[n]=l:r[n]=l;}return r};
+/**
+ * @category impl
+ * @example
+ *
+ * ```ts
+ * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
+ *   "onPointerLeave",
+ *   "onPointerMove",
+ *   "onClick",
+ *   "onPointerDown",
+ *   "onPointerUp",
+ *   "onKeyDown",
+ * ]);
+ * ```
+ */let quaranteneProps=(e,t)=>{// approach 1)
+let r={_:{}};for(let n in e){let l=e[n];t.includes(n)?r._[n]=l:// @ts-expect-error nevermind
+r[n]=l;}return r};// for these types see https://stackoverflow.com/a/65673414/1938970
 
 export { quaranteneProps as default, quaranteneProps };

package/randomInt.cjs.js

@@ -2,7 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let randomInt=(t,o)=>Math.floor(Math.random()*(o-t+1)+t);
+/**
+ * Get random int (min and max included)
+ *
+ * @category math
+ */let randomInt=(t,o)=>Math.floor(Math.random()*(o-t+1)+t);
 
 exports["default"] = randomInt;
 exports.randomInt = randomInt;

package/randomInt.esm.js

@@ -1,3 +1,7 @@
-let randomInt=(t,o)=>Math.floor(Math.random()*(o-t+1)+t);
+/**
+ * Get random int (min and max included)
+ *
+ * @category math
+ */let randomInt=(t,o)=>Math.floor(Math.random()*(o-t+1)+t);
 
 export { randomInt as default, randomInt };

package/randomKey.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let randomKey=e=>{let t=Object.keys(e);return t[t.length*Math.random()<<0]};
+/**
+ * Get random key from given object
+ *
+ * @category misc
+ * @see https://stackoverflow.com/a/15106541/1938970
+ */let randomKey=e=>{let t=Object.keys(e);return t[t.length*Math.random()<<0]};
 
 exports["default"] = randomKey;
 exports.randomKey = randomKey;

package/randomKey.esm.js

@@ -1,3 +1,8 @@
-let randomKey=e=>{let t=Object.keys(e);return t[t.length*Math.random()<<0]};
+/**
+ * Get random key from given object
+ *
+ * @category misc
+ * @see https://stackoverflow.com/a/15106541/1938970
+ */let randomKey=e=>{let t=Object.keys(e);return t[t.length*Math.random()<<0]};
 
 export { randomKey as default, randomKey };

package/readCookie.cjs.js

@@ -2,7 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let e=e=>('"'===e[0]&&(e=e.slice(1,-1)),e.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent));function readCookie(o){if("undefined"==typeof document)return "development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] document is undefined"),o?"":{};let n=document.cookie?document.cookie.split("; "):[],t={};for(let d=0;d<n.length;d++){let i=n[d].split("="),c=i.slice(1).join("=");try{let n=decodeURIComponent(i[0]);if(t[n]=e(c),o===n)break}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] failed to decode",c);}}return o?t[o]:t}
+let e=e=>('"'===e[0]&&(e=e.slice(1,-1)),e.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent));/**
+ * Read cookie
+ *
+ * @category cookie
+ */function readCookie(o){if("undefined"==typeof document)return "development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] document is undefined"),o?"":{};let n=document.cookie?document.cookie.split("; "):[],t={};for(let d=0;d<n.length;d++){let i=n[d].split("="),c=i.slice(1).join("=");try{let n=decodeURIComponent(i[0]);if(t[n]=e(c),o===n)break}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] failed to decode",c);}}return o?t[o]:t}
 
 exports["default"] = readCookie;
 exports.readCookie = readCookie;

package/readCookie.esm.js

@@ -1,3 +1,7 @@
-let e=e=>('"'===e[0]&&(e=e.slice(1,-1)),e.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent));function readCookie(o){if("undefined"==typeof document)return "development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] document is undefined"),o?"":{};let n=document.cookie?document.cookie.split("; "):[],t={};for(let d=0;d<n.length;d++){let i=n[d].split("="),c=i.slice(1).join("=");try{let n=decodeURIComponent(i[0]);if(t[n]=e(c),o===n)break}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] failed to decode",c);}}return o?t[o]:t}
+let e=e=>('"'===e[0]&&(e=e.slice(1,-1)),e.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent));/**
+ * Read cookie
+ *
+ * @category cookie
+ */function readCookie(o){if("undefined"==typeof document)return "development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] document is undefined"),o?"":{};let n=document.cookie?document.cookie.split("; "):[],t={};for(let d=0;d<n.length;d++){let i=n[d].split("="),c=i.slice(1).join("=");try{let n=decodeURIComponent(i[0]);if(t[n]=e(c),o===n)break}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:readCookie] failed to decode",c);}}return o?t[o]:t}
 
 export { readCookie as default, readCookie };

package/removeAccents.cjs.js

@@ -4,7 +4,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var accentsSets = require('./accentsSets.cjs.js');
 
-let removeAccents=(t="",r=accentsSets.accentsSets)=>{let c=r.length;for(;c--;){let[e,o]=r[c];t=t.replace(RegExp(`[${o}]`,"gi"),e);}return t};
+/**
+ * @category text
+ */let removeAccents=(t="",r=accentsSets.accentsSets)=>{let c=r.length;for(;c--;){let[e,o]=r[c];t=t.replace(RegExp(`[${o}]`,"gi"),e);}return t};
 
 exports["default"] = removeAccents;
 exports.removeAccents = removeAccents;

package/removeAccents.esm.js

@@ -1,5 +1,7 @@
 import { accentsSets } from './accentsSets.esm.js';
 
-let removeAccents=(t="",r=accentsSets)=>{let c=r.length;for(;c--;){let[e,o]=r[c];t=t.replace(RegExp(`[${o}]`,"gi"),e);}return t};
+/**
+ * @category text
+ */let removeAccents=(t="",r=accentsSets)=>{let c=r.length;for(;c--;){let[e,o]=r[c];t=t.replace(RegExp(`[${o}]`,"gi"),e);}return t};
 
 export { removeAccents as default, removeAccents };

package/removeCookie.cjs.js

@@ -8,7 +8,9 @@ require('./isNumber.cjs.js');
 require('./getType.cjs.js');
 require('./isUndefined.cjs.js');
 
-let removeCookie=(r,i={})=>{setCookie.setCookie(r,"",{...cookie.defaultAttributesClient,...i,expires:-1});};
+/**
+ * @category cookie
+ */let removeCookie=(r,i={})=>{setCookie.setCookie(r,"",{...cookie.defaultAttributesClient,...i,expires:-1});};
 
 exports["default"] = removeCookie;
 exports.removeCookie = removeCookie;

package/removeCookie.esm.js

@@ -4,6 +4,8 @@ import './isNumber.esm.js';
 import './getType.esm.js';
 import './isUndefined.esm.js';
 
-let removeCookie=(r,i={})=>{setCookie(r,"",{...defaultAttributesClient,...i,expires:-1});};
+/**
+ * @category cookie
+ */let removeCookie=(r,i={})=>{setCookie(r,"",{...defaultAttributesClient,...i,expires:-1});};
 
 export { removeCookie as default, removeCookie };

package/removeDuplicates.cjs.js

@@ -2,7 +2,14 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let removeDuplicates=e=>[...new Set(e)];
+/**
+ * FIXME: Type 'Set<any>' can only be iterated through when using the
+ * '--downlevelIteration' flag or with a '--target' of 'es2015' or higher.
+ * I am not sure I want to use those ts options here. Let's keep it commented
+ * for now
+ *
+ * @category array
+ */let removeDuplicates=e=>[...new Set(e)];
 
 exports["default"] = removeDuplicates;
 exports.removeDuplicates = removeDuplicates;

package/removeDuplicates.esm.js

@@ -1,3 +1,10 @@
-let removeDuplicates=e=>[...new Set(e)];
+/**
+ * FIXME: Type 'Set<any>' can only be iterated through when using the
+ * '--downlevelIteration' flag or with a '--target' of 'es2015' or higher.
+ * I am not sure I want to use those ts options here. Let's keep it commented
+ * for now
+ *
+ * @category array
+ */let removeDuplicates=e=>[...new Set(e)];
 
 export { removeDuplicates as default, removeDuplicates };

package/removeDuplicatesByKey.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let removeDuplicatesByKey=(e=[],t)=>{let l={},r=[];for(let o=0;o<e.length;o++){let p=e[o];l[p[t]]||(r.push(p),l[p[t]]=!0);}return r};
+/**
+ * Remove duplicated array objects, equality is determined by a strict (`===`)
+ * comparison of each object's given key
+ *
+ * @category array
+ */let removeDuplicatesByKey=(e=[],t)=>{let l={},r=[];for(let o=0;o<e.length;o++){let p=e[o];l[p[t]]||(r.push(p),l[p[t]]=!0);}return r};
 
 exports["default"] = removeDuplicatesByKey;
 exports.removeDuplicatesByKey = removeDuplicatesByKey;

package/removeDuplicatesByKey.esm.js

@@ -1,3 +1,8 @@
-let removeDuplicatesByKey=(e=[],t)=>{let l={},r=[];for(let o=0;o<e.length;o++){let p=e[o];l[p[t]]||(r.push(p),l[p[t]]=!0);}return r};
+/**
+ * Remove duplicated array objects, equality is determined by a strict (`===`)
+ * comparison of each object's given key
+ *
+ * @category array
+ */let removeDuplicatesByKey=(e=[],t)=>{let l={},r=[];for(let o=0;o<e.length;o++){let p=e[o];l[p[t]]||(r.push(p),l[p[t]]=!0);}return r};
 
 export { removeDuplicatesByKey as default, removeDuplicatesByKey };

package/removeDuplicatesComparing.cjs.js

@@ -5,7 +5,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var findDuplicatedIndexes = require('./findDuplicatedIndexes.cjs.js');
 var removeIndexesFromArray = require('./removeIndexesFromArray.cjs.js');
 
-let removeDuplicatesComparing=(o,m)=>removeIndexesFromArray.removeIndexesFromArray(m,findDuplicatedIndexes.findDuplicatedIndexes(o));
+/**
+ * @category array
+ */let removeDuplicatesComparing=(o,m)=>removeIndexesFromArray.removeIndexesFromArray(m,findDuplicatedIndexes.findDuplicatedIndexes(o));
 
 exports["default"] = removeDuplicatesComparing;
 exports.removeDuplicatesComparing = removeDuplicatesComparing;