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

package/Defer.cjs.js

@@ -2,7 +2,26 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function Defer(){let e=this||{},t=e.promise=new Promise((t,r)=>{e.resolve=t,e.reject=r;});return e.then=t.then.bind(t),e.catch=t.catch.bind(t),e}
+/**
+ * @category async
+ */// then: Promise<T>["then"];
+// catch: Promise<T>["catch"]
+// finally: Promise<T>["finally"]
+/**
+ * @category async
+ * @see https://stackoverflow.com/a/37673534/1938970
+ * @example
+ *
+ * ```ts
+ * const deferred = Defer();
+ * deferred.resolve();
+ * deferred.then(handleSuccess, handleError);
+ * ```
+ */function Defer()/* : PromiseConstructor */{// @ts-expect-error nevermind
+let e=this||{},t=e.promise=new Promise((t,r)=>{e.resolve=t,e.reject=r;});// if (p.finally) {
+//   self.finally = p.finally.bind(p);
+// }
+return e.then=t.then.bind(t),e.catch=t.catch.bind(t),e}
 
 exports.Defer = Defer;
 exports["default"] = Defer;

package/Defer.esm.js

@@ -1,3 +1,22 @@
-function Defer(){let e=this||{},t=e.promise=new Promise((t,r)=>{e.resolve=t,e.reject=r;});return e.then=t.then.bind(t),e.catch=t.catch.bind(t),e}
+/**
+ * @category async
+ */// then: Promise<T>["then"];
+// catch: Promise<T>["catch"]
+// finally: Promise<T>["finally"]
+/**
+ * @category async
+ * @see https://stackoverflow.com/a/37673534/1938970
+ * @example
+ *
+ * ```ts
+ * const deferred = Defer();
+ * deferred.resolve();
+ * deferred.then(handleSuccess, handleError);
+ * ```
+ */function Defer()/* : PromiseConstructor */{// @ts-expect-error nevermind
+let e=this||{},t=e.promise=new Promise((t,r)=>{e.resolve=t,e.reject=r;});// if (p.finally) {
+//   self.finally = p.finally.bind(p);
+// }
+return e.then=t.then.bind(t),e.catch=t.catch.bind(t),e}
 
 export { Defer, Defer as default };

package/Emitter.cjs.js

@@ -2,7 +2,24 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let Emitter=t=>{let e=new Map;return {on(r,i){let n=e.get(`${t}.${String(r)}`);n&&n.push(i)||e.set(`${t}.${String(r)}`,[i]);},emit(r,i){(e.get(`${t}.${String(r)}`)||[]).slice().map(t=>{t(i);});}}};
+/**
+ * Emitter super simple class
+ *
+ * Events will be prefixed with the given `namespace` plus a `.` so:
+ * `{namespace}.myevent`
+ *
+ * Adapted from https://github.com/developit/mitt
+ *
+ * Regarding typescript support see:
+ * - https://stackoverflow.com/q/53299743/1938970
+ * - https://github.com/Microsoft/TypeScript/pull/26349
+ *
+ * @category impl
+ */let Emitter=t=>{let e=new Map;return {/**
+     * Register an event handler for the given type.
+     */on(r,i){let n=e.get(`${t}.${String(r)}`);n&&n.push(i)||e.set(`${t}.${String(r)}`,[i]);},/**
+     * Invoke all handlers for the given type.
+     */emit(r,i){(e.get(`${t}.${String(r)}`)||[]).slice().map(t=>{t(i);});}}};
 
 exports.Emitter = Emitter;
 exports["default"] = Emitter;

package/Emitter.esm.js

@@ -1,3 +1,20 @@
-let Emitter=t=>{let e=new Map;return {on(r,i){let n=e.get(`${t}.${String(r)}`);n&&n.push(i)||e.set(`${t}.${String(r)}`,[i]);},emit(r,i){(e.get(`${t}.${String(r)}`)||[]).slice().map(t=>{t(i);});}}};
+/**
+ * Emitter super simple class
+ *
+ * Events will be prefixed with the given `namespace` plus a `.` so:
+ * `{namespace}.myevent`
+ *
+ * Adapted from https://github.com/developit/mitt
+ *
+ * Regarding typescript support see:
+ * - https://stackoverflow.com/q/53299743/1938970
+ * - https://github.com/Microsoft/TypeScript/pull/26349
+ *
+ * @category impl
+ */let Emitter=t=>{let e=new Map;return {/**
+     * Register an event handler for the given type.
+     */on(r,i){let n=e.get(`${t}.${String(r)}`);n&&n.push(i)||e.set(`${t}.${String(r)}`,[i]);},/**
+     * Invoke all handlers for the given type.
+     */emit(r,i){(e.get(`${t}.${String(r)}`)||[]).slice().map(t=>{t(i);});}}};
 
 export { Emitter, Emitter as default };

package/accentsSets.cjs.js

@@ -2,7 +2,19 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let accentsSets=[["a","ÀÁÂÃÅÆĀĂĄẠẢẤẦẨẪẬẮẰẲẴẶ"],["ae","Ä"],["c","ÇĆĈČ"],["d","ÐĎĐÞ"],["e","ÈÉÊËĒĔĖĘĚẸẺẼẾỀỂỄỆ"],["g","ĜĞĢǴ"],["h","ĤḦ"],["i","ÌÍÎÏĨĪĮİỈỊ"],["j","Ĵ"],["ij","IJ"],["k","Ķ"],["l","ĹĻĽŁ"],["m","Ḿ"],["n","ÑŃŅŇ"],["o","ÒÓÔÕØŌŎŐỌỎỐỒỔỖỘỚỜỞỠỢǪǬƠ"],["oe","ŒÖ"],["p","ṕ"],["r","ŔŖŘ"],["s","ŚŜŞŠ"],["ss","ß"],["t","ŢŤ"],["u","ÙÚÛŨŪŬŮŰŲỤỦỨỪỬỮỰƯ"],["ue","Ü"],["w","ẂŴẀẄ"],["x","ẍ"],["y","ÝŶŸỲỴỶỸ"],["z","ŹŻŽ"]];
+/**
+ * First value is the `to`, second is `from`, from *which* chars do we translates *to*
+ *
+ * @category text
+ *//**
+ * Accent sets
+ *
+ * @category text
+ * @resources
+ * - https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
+ * - https://gist.github.com/eek/9c4887e80b3ede05c0e39fee4dce3747 for usage
+ * of [normalize](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize)
+ */let accentsSets=[["a","ÀÁÂÃÅÆĀĂĄẠẢẤẦẨẪẬẮẰẲẴẶ"],["ae","Ä"],["c","ÇĆĈČ"],["d","ÐĎĐÞ"],["e","ÈÉÊËĒĔĖĘĚẸẺẼẾỀỂỄỆ"],["g","ĜĞĢǴ"],["h","ĤḦ"],["i","ÌÍÎÏĨĪĮİỈỊ"],["j","Ĵ"],["ij","IJ"],["k","Ķ"],["l","ĹĻĽŁ"],["m","Ḿ"],["n","ÑŃŅŇ"],["o","ÒÓÔÕØŌŎŐỌỎỐỒỔỖỘỚỜỞỠỢǪǬƠ"],["oe","ŒÖ"],["p","ṕ"],["r","ŔŖŘ"],["s","ŚŜŞŠ"],["ss","ß"],["t","ŢŤ"],["u","ÙÚÛŨŪŬŮŰŲỤỦỨỪỬỮỰƯ"],["ue","Ü"],["w","ẂŴẀẄ"],["x","ẍ"],["y","ÝŶŸỲỴỶỸ"],["z","ŹŻŽ"]];
 
 exports.accentsSets = accentsSets;
 exports["default"] = accentsSets;

package/accentsSets.esm.js

@@ -1,3 +1,15 @@
-let accentsSets=[["a","ÀÁÂÃÅÆĀĂĄẠẢẤẦẨẪẬẮẰẲẴẶ"],["ae","Ä"],["c","ÇĆĈČ"],["d","ÐĎĐÞ"],["e","ÈÉÊËĒĔĖĘĚẸẺẼẾỀỂỄỆ"],["g","ĜĞĢǴ"],["h","ĤḦ"],["i","ÌÍÎÏĨĪĮİỈỊ"],["j","Ĵ"],["ij","IJ"],["k","Ķ"],["l","ĹĻĽŁ"],["m","Ḿ"],["n","ÑŃŅŇ"],["o","ÒÓÔÕØŌŎŐỌỎỐỒỔỖỘỚỜỞỠỢǪǬƠ"],["oe","ŒÖ"],["p","ṕ"],["r","ŔŖŘ"],["s","ŚŜŞŠ"],["ss","ß"],["t","ŢŤ"],["u","ÙÚÛŨŪŬŮŰŲỤỦỨỪỬỮỰƯ"],["ue","Ü"],["w","ẂŴẀẄ"],["x","ẍ"],["y","ÝŶŸỲỴỶỸ"],["z","ŹŻŽ"]];
+/**
+ * First value is the `to`, second is `from`, from *which* chars do we translates *to*
+ *
+ * @category text
+ *//**
+ * Accent sets
+ *
+ * @category text
+ * @resources
+ * - https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
+ * - https://gist.github.com/eek/9c4887e80b3ede05c0e39fee4dce3747 for usage
+ * of [normalize](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize)
+ */let accentsSets=[["a","ÀÁÂÃÅÆĀĂĄẠẢẤẦẨẪẬẮẰẲẴẶ"],["ae","Ä"],["c","ÇĆĈČ"],["d","ÐĎĐÞ"],["e","ÈÉÊËĒĔĖĘĚẸẺẼẾỀỂỄỆ"],["g","ĜĞĢǴ"],["h","ĤḦ"],["i","ÌÍÎÏĨĪĮİỈỊ"],["j","Ĵ"],["ij","IJ"],["k","Ķ"],["l","ĹĻĽŁ"],["m","Ḿ"],["n","ÑŃŅŇ"],["o","ÒÓÔÕØŌŎŐỌỎỐỒỔỖỘỚỜỞỠỢǪǬƠ"],["oe","ŒÖ"],["p","ṕ"],["r","ŔŖŘ"],["s","ŚŜŞŠ"],["ss","ß"],["t","ŢŤ"],["u","ÙÚÛŨŪŬŮŰŲỤỦỨỪỬỮỰƯ"],["ue","Ü"],["w","ẂŴẀẄ"],["x","ẍ"],["y","ÝŶŸỲỴỶỸ"],["z","ŹŻŽ"]];
 
 export { accentsSets, accentsSets as default };

package/addOrReplaceAtIdx.cjs.js

@@ -2,7 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let addOrReplaceAtIdx=(e,d,t)=>0===e.length?[d]:void 0===t||e.length-1<t?[...e,d]:e.map((e,a)=>a===t?d:e);
+/**
+ * Add or replace an item in the given array, it returns a new array (immutable).
+ * Typescript wise this is meant to keep the same type on the newly returned
+ * array, therefore the `newItem` must match the type of the `list` items.
+ *
+ * @category array
+ */let addOrReplaceAtIdx=(e,d,t)=>0===e.length?[d]:void 0===t||e.length-1<t?[...e,d]:e.map((e,a)=>a===t?d:e);
 
 exports.addOrReplaceAtIdx = addOrReplaceAtIdx;
 exports["default"] = addOrReplaceAtIdx;

package/addOrReplaceAtIdx.esm.js

@@ -1,3 +1,9 @@
-let addOrReplaceAtIdx=(e,d,t)=>0===e.length?[d]:void 0===t||e.length-1<t?[...e,d]:e.map((e,a)=>a===t?d:e);
+/**
+ * Add or replace an item in the given array, it returns a new array (immutable).
+ * Typescript wise this is meant to keep the same type on the newly returned
+ * array, therefore the `newItem` must match the type of the `list` items.
+ *
+ * @category array
+ */let addOrReplaceAtIdx=(e,d,t)=>0===e.length?[d]:void 0===t||e.length-1<t?[...e,d]:e.map((e,a)=>a===t?d:e);
 
 export { addOrReplaceAtIdx, addOrReplaceAtIdx as default };

package/areEqual.cjs.js

@@ -7,7 +7,34 @@ var isObject = require('./isObject.cjs.js');
 require('./getType.cjs.js');
 require('./isPlainObject.cjs.js');
 
-let t=(r,e)=>{if(!e||r.length!==e.length)return !1;for(let t=0;t<r.length;t++)if(!areEqual(r[t],e[t]))return !1;return !0},u=(r,e)=>{if(!e)return !1;for(let t of Object.keys(r))if(!areEqual(r[t],e[t]))return !1;return !0};let areEqual=(l,f)=>{if(!l&&!f)return !0;if(!f&&l!==f)return !1;let n=isObject.isObject(l)&&isObject.isObject(f);if(n&&!u(l,f))return !1;let i=isArray.isArray(l)&&isArray.isArray(f);return !!(!i||t(l,f))&&(!!n||!!i||l===f)};
+/**
+ */let t=(r,e)=>{if(!e||r.length!==e.length)return !1;for(let t=0;t<r.length;t++)if(!areEqual(r[t],e[t]))return !1;return !0},/**
+ * NOTE: Since we do not care about `undefined` values we do not check for equal
+ * `Object.keys().length` equality
+ */u=(r,e)=>{if(!e)return !1;// const bKeys = Object.keys(b);
+// if (aKeys.length !== bKeys.length) {
+//   return false;
+// }
+for(let t of Object.keys(r))if(!areEqual(r[t],e[t]))return !1;return !0};/**
+ * A simple and quick deep equal objects utility. This is meant to be used
+ * solely to deduplicate requests payload and perform comparison on JSON ready
+ * objects made of primitives `string`, `number` and `boolean`s.
+ *
+ * It support nested `object`s and `array`s only.
+ *
+ * NB: `undefined` and `null` values do not count in the comparison as they are
+ * usually meant to be ignored in JSON requestBody payloads.
+ *
+ * According to very rudimentary tests this function takes on average between
+ * 0.15 ms and 2ms to compare two averaged sizes requet body payloads.
+ *
+ * @category object
+ */let areEqual=(l,f)=>{if(!l&&!f)// console.log(`areEqual took ${performance.now() - t0} ms`);
+return !0;// const t0 = performance.now();
+if(!f&&l!==f)// console.log(`areEqual took ${performance.now() - t0} ms`);
+return !1;let n=isObject.isObject(l)&&isObject.isObject(f);if(n&&!u(l,f))// console.log(`areEqual took ${performance.now() - t0} ms`);
+return !1;let i=isArray.isArray(l)&&isArray.isArray(f);return !!(!i||t(l,f))&&// console.log(`areEqual took ${performance.now() - t0} ms`);
+(!!n||!!i||l===f)};// console.log(`areEqual took ${performance.now() - t0} ms`);
 
 exports.areEqual = areEqual;
 exports["default"] = areEqual;

package/areEqual.esm.js

@@ -3,6 +3,33 @@ import { isObject } from './isObject.esm.js';
 import './getType.esm.js';
 import './isPlainObject.esm.js';
 
-let t=(r,e)=>{if(!e||r.length!==e.length)return !1;for(let t=0;t<r.length;t++)if(!areEqual(r[t],e[t]))return !1;return !0},u=(r,e)=>{if(!e)return !1;for(let t of Object.keys(r))if(!areEqual(r[t],e[t]))return !1;return !0};let areEqual=(l,f)=>{if(!l&&!f)return !0;if(!f&&l!==f)return !1;let n=isObject(l)&&isObject(f);if(n&&!u(l,f))return !1;let i=isArray(l)&&isArray(f);return !!(!i||t(l,f))&&(!!n||!!i||l===f)};
+/**
+ */let t=(r,e)=>{if(!e||r.length!==e.length)return !1;for(let t=0;t<r.length;t++)if(!areEqual(r[t],e[t]))return !1;return !0},/**
+ * NOTE: Since we do not care about `undefined` values we do not check for equal
+ * `Object.keys().length` equality
+ */u=(r,e)=>{if(!e)return !1;// const bKeys = Object.keys(b);
+// if (aKeys.length !== bKeys.length) {
+//   return false;
+// }
+for(let t of Object.keys(r))if(!areEqual(r[t],e[t]))return !1;return !0};/**
+ * A simple and quick deep equal objects utility. This is meant to be used
+ * solely to deduplicate requests payload and perform comparison on JSON ready
+ * objects made of primitives `string`, `number` and `boolean`s.
+ *
+ * It support nested `object`s and `array`s only.
+ *
+ * NB: `undefined` and `null` values do not count in the comparison as they are
+ * usually meant to be ignored in JSON requestBody payloads.
+ *
+ * According to very rudimentary tests this function takes on average between
+ * 0.15 ms and 2ms to compare two averaged sizes requet body payloads.
+ *
+ * @category object
+ */let areEqual=(l,f)=>{if(!l&&!f)// console.log(`areEqual took ${performance.now() - t0} ms`);
+return !0;// const t0 = performance.now();
+if(!f&&l!==f)// console.log(`areEqual took ${performance.now() - t0} ms`);
+return !1;let n=isObject(l)&&isObject(f);if(n&&!u(l,f))// console.log(`areEqual took ${performance.now() - t0} ms`);
+return !1;let i=isArray(l)&&isArray(f);return !!(!i||t(l,f))&&// console.log(`areEqual took ${performance.now() - t0} ms`);
+(!!n||!!i||l===f)};// console.log(`areEqual took ${performance.now() - t0} ms`);
 
 export { areEqual, areEqual as default };

package/arrayFilterFalsy.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let arrayFilterFalsy=r=>r?r.filter(r=>!!r):[];
+/**
+ * Given a list it returns it filtered without any falsy values (`null`,
+ * `undefined`, `false`, `0`, `""`). It "adjusts" the returned type as well.
+ *
+ * @category array
+ */let arrayFilterFalsy=r=>r?r.filter(r=>!!r):[];
 
 exports.arrayFilterFalsy = arrayFilterFalsy;
 exports["default"] = arrayFilterFalsy;

package/arrayFilterFalsy.esm.js

@@ -1,3 +1,8 @@
-let arrayFilterFalsy=r=>r?r.filter(r=>!!r):[];
+/**
+ * Given a list it returns it filtered without any falsy values (`null`,
+ * `undefined`, `false`, `0`, `""`). It "adjusts" the returned type as well.
+ *
+ * @category array
+ */let arrayFilterFalsy=r=>r?r.filter(r=>!!r):[];
 
 export { arrayFilterFalsy, arrayFilterFalsy as default };

package/arrayFindLastIndex.cjs.js

@@ -2,7 +2,19 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let arrayFindLastIndex=(r,e)=>{let t=r.length;for(;t--;)if(e(r[t],t,r))return t;return -1};
+/**
+ * Returns the index of the last element in the array where predicate is true, and -1
+ * otherwise.
+ *
+ * @borrows [SO's answer by Nico Timmerman](https://stackoverflow.com/a/53187807/1938970)
+ *
+ * @category array
+ *
+ * @param array The source array to search in
+ * @param predicate find calls predicate once for each element of the array, in descending
+ * order, until it finds one where predicate returns true. If such an element is found,
+ * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
+ */let arrayFindLastIndex=(r,e)=>{let t=r.length;for(;t--;)if(e(r[t],t,r))return t;return -1};
 
 exports.arrayFindLastIndex = arrayFindLastIndex;
 exports["default"] = arrayFindLastIndex;

package/arrayFindLastIndex.esm.js

@@ -1,3 +1,15 @@
-let arrayFindLastIndex=(r,e)=>{let t=r.length;for(;t--;)if(e(r[t],t,r))return t;return -1};
+/**
+ * Returns the index of the last element in the array where predicate is true, and -1
+ * otherwise.
+ *
+ * @borrows [SO's answer by Nico Timmerman](https://stackoverflow.com/a/53187807/1938970)
+ *
+ * @category array
+ *
+ * @param array The source array to search in
+ * @param predicate find calls predicate once for each element of the array, in descending
+ * order, until it finds one where predicate returns true. If such an element is found,
+ * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
+ */let arrayFindLastIndex=(r,e)=>{let t=r.length;for(;t--;)if(e(r[t],t,r))return t;return -1};
 
 export { arrayFindLastIndex, arrayFindLastIndex as default };

package/arrayOfAll.cjs.js

@@ -2,7 +2,22 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let arrayOfAll=()=>l=>l;
+/**
+ * Ensure an array contains all desired values
+ *
+ * @category array
+ * @borrows [SO comment by `CertainPerformance`](https://stackoverflow.com/a/60132060/1938970)
+ *
+ * @usage
+ * ```ts
+ * type Fruit = "pear" | "apple" | "orange";
+ *
+ * const arrayOfAllFruits = arrayOfAll<Fruit>();
+ *
+ * const allFruits = arrayOfAllFruits([ "pear", "apple", "orange" ]); // ts compiler ok
+ * const allFruits = arrayOfAllFruits([ "pear", "apple" ]); // ts compiler fails
+ * ```
+ */let arrayOfAll=()=>l=>l;
 
 exports.arrayOfAll = arrayOfAll;
 exports["default"] = arrayOfAll;

package/arrayOfAll.esm.js

@@ -1,3 +1,18 @@
-let arrayOfAll=()=>l=>l;
+/**
+ * Ensure an array contains all desired values
+ *
+ * @category array
+ * @borrows [SO comment by `CertainPerformance`](https://stackoverflow.com/a/60132060/1938970)
+ *
+ * @usage
+ * ```ts
+ * type Fruit = "pear" | "apple" | "orange";
+ *
+ * const arrayOfAllFruits = arrayOfAll<Fruit>();
+ *
+ * const allFruits = arrayOfAllFruits([ "pear", "apple", "orange" ]); // ts compiler ok
+ * const allFruits = arrayOfAllFruits([ "pear", "apple" ]); // ts compiler fails
+ * ```
+ */let arrayOfAll=()=>l=>l;
 
 export { arrayOfAll, arrayOfAll as default };

package/arraySum.cjs.js

@@ -2,7 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let arraySum=r=>r.reduce((r,e)=>r+e,0);
+/**
+ * Sum array of numbers
+ *
+ * @category array
+ * @category math
+ */let arraySum=r=>r.reduce((r,e)=>r+e,0);
 
 exports.arraySum = arraySum;
 exports["default"] = arraySum;

package/arraySum.esm.js

@@ -1,3 +1,8 @@
-let arraySum=r=>r.reduce((r,e)=>r+e,0);
+/**
+ * Sum array of numbers
+ *
+ * @category array
+ * @category math
+ */let arraySum=r=>r.reduce((r,e)=>r+e,0);
 
 export { arraySum, arraySum as default };

package/arrayToLookup.cjs.js

@@ -2,7 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let arrayToLookup=(o=[])=>o.reduce((o,r)=>(o[r]=1,o),{});
+/**
+ * Maps a simple flat array to a lookup dictionary object
+ *
+ * @category array
+ */let arrayToLookup=(o=[])=>o.reduce((o,r)=>(o[r]=1,o),{});
 
 exports.arrayToLookup = arrayToLookup;
 exports["default"] = arrayToLookup;

package/arrayToLookup.esm.js

@@ -1,3 +1,7 @@
-let arrayToLookup=(o=[])=>o.reduce((o,r)=>(o[r]=1,o),{});
+/**
+ * Maps a simple flat array to a lookup dictionary object
+ *
+ * @category array
+ */let arrayToLookup=(o=[])=>o.reduce((o,r)=>(o[r]=1,o),{});
 
 export { arrayToLookup, arrayToLookup as default };

package/arrayUniqueByProperties.cjs.js

@@ -2,7 +2,14 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let arrayUniqueByProperties=(e,r)=>e.filter((e,t,i)=>i.findIndex(t=>r.every(r=>t[r]===e[r]))===t);
+/**
+ * @borrows [SO answer](https://stackoverflow.com/a/56757215/1938970)
+ *
+ * @category array
+ * @param array The array to filter
+ * @param keys The keys to compare in each array item
+ * @returns The filtered array
+ */let arrayUniqueByProperties=(e,r)=>e.filter((e,t,i)=>i.findIndex(t=>r.every(r=>t[r]===e[r]))===t);
 
 exports.arrayUniqueByProperties = arrayUniqueByProperties;
 exports["default"] = arrayUniqueByProperties;

package/arrayUniqueByProperties.esm.js

@@ -1,3 +1,10 @@
-let arrayUniqueByProperties=(e,r)=>e.filter((e,t,i)=>i.findIndex(t=>r.every(r=>t[r]===e[r]))===t);
+/**
+ * @borrows [SO answer](https://stackoverflow.com/a/56757215/1938970)
+ *
+ * @category array
+ * @param array The array to filter
+ * @param keys The keys to compare in each array item
+ * @returns The filtered array
+ */let arrayUniqueByProperties=(e,r)=>e.filter((e,t,i)=>i.findIndex(t=>r.every(r=>t[r]===e[r]))===t);
 
 export { arrayUniqueByProperties, arrayUniqueByProperties as default };

package/buildUrlQueryString.cjs.js

@@ -7,7 +7,16 @@ var isNull = require('./isNull.cjs.js');
 var isUndefined = require('./isUndefined.cjs.js');
 require('./getType.cjs.js');
 
-let buildUrlQueryString=o=>{let l="";if(!o)return l;for(let i in o){let n=o[i];if(isArray.isArray(n))for(let e=0;e<n.length;e++)l+=`${i}=${encodeURIComponent(n[e]+"")}&`;else isNull.isNull(n)||isUndefined.isUndefined(n)||(l+=`${i}=${encodeURIComponent(n+"")}&`);}return l?`?${l.replace(/&+$/,"")}`:""};
+/**
+ * Get clean query string for URL
+ *
+ * It returns the query string **with** the initial `?`
+ *
+ * TODO: at some point replace with `URLSearchParams`, @see [caniuse](https://caniuse.com/?search=URLSearchParams)
+ *
+ * @category location
+ */let buildUrlQueryString=o=>{let l="";if(!o)return l;for(let i in o){let n=o[i];if(isArray.isArray(n))for(let e=0;e<n.length;e++)l+=`${i}=${encodeURIComponent(n[e]+"")}&`;else isNull.isNull(n)||isUndefined.isUndefined(n)||(l+=`${i}=${encodeURIComponent(n+"")}&`);}// removes the last &
+return l?`?${l.replace(/&+$/,"")}`:""};
 
 exports.buildUrlQueryString = buildUrlQueryString;
 exports["default"] = buildUrlQueryString;

package/buildUrlQueryString.esm.js

@@ -3,6 +3,15 @@ import { isNull } from './isNull.esm.js';
 import { isUndefined } from './isUndefined.esm.js';
 import './getType.esm.js';
 
-let buildUrlQueryString=o=>{let l="";if(!o)return l;for(let i in o){let n=o[i];if(isArray(n))for(let e=0;e<n.length;e++)l+=`${i}=${encodeURIComponent(n[e]+"")}&`;else isNull(n)||isUndefined(n)||(l+=`${i}=${encodeURIComponent(n+"")}&`);}return l?`?${l.replace(/&+$/,"")}`:""};
+/**
+ * Get clean query string for URL
+ *
+ * It returns the query string **with** the initial `?`
+ *
+ * TODO: at some point replace with `URLSearchParams`, @see [caniuse](https://caniuse.com/?search=URLSearchParams)
+ *
+ * @category location
+ */let buildUrlQueryString=o=>{let l="";if(!o)return l;for(let i in o){let n=o[i];if(isArray(n))for(let e=0;e<n.length;e++)l+=`${i}=${encodeURIComponent(n[e]+"")}&`;else isNull(n)||isUndefined(n)||(l+=`${i}=${encodeURIComponent(n+"")}&`);}// removes the last &
+return l?`?${l.replace(/&+$/,"")}`:""};
 
 export { buildUrlQueryString, buildUrlQueryString as default };

package/capitalize.cjs.js

@@ -2,7 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let capitalize=e=>(e||"").charAt(0).toUpperCase()+(e||"").slice(1);
+/**
+ * Capitalize first letter of the given string.
+ *
+ * @category text
+ * @resources
+ * - https://stackoverflow.com/a/11409944/1938970
+ */let capitalize=e=>(e||"").charAt(0).toUpperCase()+(e||"").slice(1);
 
 exports.capitalize = capitalize;
 exports["default"] = capitalize;

package/capitalize.esm.js

@@ -1,3 +1,9 @@
-let capitalize=e=>(e||"").charAt(0).toUpperCase()+(e||"").slice(1);
+/**
+ * Capitalize first letter of the given string.
+ *
+ * @category text
+ * @resources
+ * - https://stackoverflow.com/a/11409944/1938970
+ */let capitalize=e=>(e||"").charAt(0).toUpperCase()+(e||"").slice(1);
 
 export { capitalize, capitalize as default };

package/changeCaseCamel.cjs.js

@@ -4,7 +4,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var changeCaseHelpers = require('./changeCaseHelpers.cjs.js');
 
-let changeCaseCamel=(m,o)=>{let[c,s,C]=changeCaseHelpers.splitPrefixSuffix(m,o),g=changeCaseHelpers.lowerFactory(o?.locale),i=changeCaseHelpers.upperFactory(o?.locale),n=o?.mergeAmbiguousCharacters?changeCaseHelpers.capitalCaseTransformFactory(g,i):changeCaseHelpers.pascalCaseTransformFactory(g,i);return c+s.map((e,a)=>0===a?g(e):n(e,a)).join(o?.delimiter??"")+C};
+/**
+ * Convert a string to camel case (`fooBar`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseCamel=(m,o)=>{let[c,s,C]=changeCaseHelpers.splitPrefixSuffix(m,o),g=changeCaseHelpers.lowerFactory(o?.locale),i=changeCaseHelpers.upperFactory(o?.locale),n=o?.mergeAmbiguousCharacters?changeCaseHelpers.capitalCaseTransformFactory(g,i):changeCaseHelpers.pascalCaseTransformFactory(g,i);return c+s.map((e,a)=>0===a?g(e):n(e,a)).join(o?.delimiter??"")+C};
 
 exports.changeCaseCamel = changeCaseCamel;
 exports["default"] = changeCaseCamel;

package/changeCaseCamel.esm.js

@@ -1,5 +1,11 @@
 import { splitPrefixSuffix, lowerFactory, upperFactory, capitalCaseTransformFactory, pascalCaseTransformFactory } from './changeCaseHelpers.esm.js';
 
-let changeCaseCamel=(m,o)=>{let[c,s,C]=splitPrefixSuffix(m,o),g=lowerFactory(o?.locale),i=upperFactory(o?.locale),n=o?.mergeAmbiguousCharacters?capitalCaseTransformFactory(g,i):pascalCaseTransformFactory(g,i);return c+s.map((e,a)=>0===a?g(e):n(e,a)).join(o?.delimiter??"")+C};
+/**
+ * Convert a string to camel case (`fooBar`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseCamel=(m,o)=>{let[c,s,C]=splitPrefixSuffix(m,o),g=lowerFactory(o?.locale),i=upperFactory(o?.locale),n=o?.mergeAmbiguousCharacters?capitalCaseTransformFactory(g,i):pascalCaseTransformFactory(g,i);return c+s.map((e,a)=>0===a?g(e):n(e,a)).join(o?.delimiter??"")+C};
 
 export { changeCaseCamel, changeCaseCamel as default };

package/changeCaseCapital.cjs.js

@@ -4,7 +4,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var changeCaseHelpers = require('./changeCaseHelpers.cjs.js');
 
-let changeCaseCapital=(r,o)=>{let[p,i,c]=changeCaseHelpers.splitPrefixSuffix(r,o),n=changeCaseHelpers.lowerFactory(o?.locale),C=changeCaseHelpers.upperFactory(o?.locale);return p+i.map(changeCaseHelpers.capitalCaseTransformFactory(n,C)).join(o?.delimiter??" ")+c};
+/**
+ * Convert a string to sentence case (`Foo Bar`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseCapital=(r,o)=>{let[p,i,c]=changeCaseHelpers.splitPrefixSuffix(r,o),n=changeCaseHelpers.lowerFactory(o?.locale),C=changeCaseHelpers.upperFactory(o?.locale);return p+i.map(changeCaseHelpers.capitalCaseTransformFactory(n,C)).join(o?.delimiter??" ")+c};
 
 exports.changeCaseCapital = changeCaseCapital;
 exports["default"] = changeCaseCapital;

package/changeCaseCapital.esm.js

@@ -1,5 +1,11 @@
 import { splitPrefixSuffix, lowerFactory, upperFactory, capitalCaseTransformFactory } from './changeCaseHelpers.esm.js';
 
-let changeCaseCapital=(r,o)=>{let[p,i,c]=splitPrefixSuffix(r,o),n=lowerFactory(o?.locale),C=upperFactory(o?.locale);return p+i.map(capitalCaseTransformFactory(n,C)).join(o?.delimiter??" ")+c};
+/**
+ * Convert a string to sentence case (`Foo Bar`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseCapital=(r,o)=>{let[p,i,c]=splitPrefixSuffix(r,o),n=lowerFactory(o?.locale),C=upperFactory(o?.locale);return p+i.map(capitalCaseTransformFactory(n,C)).join(o?.delimiter??" ")+c};
 
 export { changeCaseCapital, changeCaseCapital as default };

package/changeCaseConstant.cjs.js

@@ -4,7 +4,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var changeCaseHelpers = require('./changeCaseHelpers.cjs.js');
 
-let changeCaseConstant=(a,n)=>{let[o,r,l]=changeCaseHelpers.splitPrefixSuffix(a,n);return o+r.map(changeCaseHelpers.upperFactory(n?.locale)).join(n?.delimiter??"_")+l};
+/**
+ * Convert a string to constant case (`FOO_BAR`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseConstant=(a,n)=>{let[o,r,l]=changeCaseHelpers.splitPrefixSuffix(a,n);return o+r.map(changeCaseHelpers.upperFactory(n?.locale)).join(n?.delimiter??"_")+l};
 
 exports.changeCaseConstant = changeCaseConstant;
 exports["default"] = changeCaseConstant;

package/changeCaseConstant.esm.js

@@ -1,5 +1,11 @@
 import { splitPrefixSuffix, upperFactory } from './changeCaseHelpers.esm.js';
 
-let changeCaseConstant=(a,n)=>{let[o,r,l]=splitPrefixSuffix(a,n);return o+r.map(upperFactory(n?.locale)).join(n?.delimiter??"_")+l};
+/**
+ * Convert a string to constant case (`FOO_BAR`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseConstant=(a,n)=>{let[o,r,l]=splitPrefixSuffix(a,n);return o+r.map(upperFactory(n?.locale)).join(n?.delimiter??"_")+l};
 
 export { changeCaseConstant, changeCaseConstant as default };

package/changeCaseDot.cjs.js

@@ -5,7 +5,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var changeCaseNone = require('./changeCaseNone.cjs.js');
 require('./changeCaseHelpers.cjs.js');
 
-let changeCaseDot=(t,a)=>changeCaseNone.changeCaseNone(t,{delimiter:".",...a});
+/**
+ * Convert a string to dot case (`foo.bar`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseDot=(t,a)=>changeCaseNone.changeCaseNone(t,{delimiter:".",...a});
 
 exports.changeCaseDot = changeCaseDot;
 exports["default"] = changeCaseDot;

package/changeCaseDot.esm.js

@@ -1,6 +1,12 @@
 import { changeCaseNone } from './changeCaseNone.esm.js';
 import './changeCaseHelpers.esm.js';
 
-let changeCaseDot=(t,a)=>changeCaseNone(t,{delimiter:".",...a});
+/**
+ * Convert a string to dot case (`foo.bar`).
+ *
+ * @category text
+ * @category case
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case)
+ */let changeCaseDot=(t,a)=>changeCaseNone(t,{delimiter:".",...a});
 
 export { changeCaseDot, changeCaseDot as default };