@koine/utils 2.0.0-beta.77 → 2.0.0-beta.78

package/Defer.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./Defer";
+export { default } from "./Defer";

package/Defer.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./Defer.cjs.js').default;

package/Defer.cjs.js

@@ -0,0 +1,17 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+function Defer() {
+    const self = this || {};
+    const p = (self.promise = new Promise((resolve, reject) => {
+        self.resolve = resolve;
+        self.reject = reject;
+    }));
+    self.then = p.then.bind(p);
+    self.catch = p.catch.bind(p);
+    return self;
+}
+
+exports.Defer = Defer;
+exports["default"] = Defer;

package/Defer.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './Defer.cjs.js';
+export { _default as default } from './Defer.cjs.default.js';

package/Defer.esm.js

@@ -0,0 +1,12 @@
+function Defer() {
+    const self = this || {};
+    const p = (self.promise = new Promise((resolve, reject) => {
+        self.resolve = resolve;
+        self.reject = reject;
+    }));
+    self.then = p.then.bind(p);
+    self.catch = p.catch.bind(p);
+    return self;
+}
+
+export { Defer, Defer as default };

package/Emitter.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./Emitter";
+export { default } from "./Emitter";

package/Emitter.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./Emitter.cjs.js').default;

package/Emitter.cjs.js

@@ -0,0 +1,26 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let Emitter = (namespace) => {
+    const all = new Map();
+    return {
+        on(name, handler) {
+            const handlers = all.get(`${namespace}.${String(name)}`);
+            const added = handlers && handlers.push(handler);
+            if (!added) {
+                all.set(`${namespace}.${String(name)}`, [handler]);
+            }
+        },
+        emit(name, data) {
+            (all.get(`${namespace}.${String(name)}`) || [])
+                .slice()
+                .map((handler) => {
+                handler(data);
+            });
+        },
+    };
+};
+
+exports.Emitter = Emitter;
+exports["default"] = Emitter;

package/Emitter.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './Emitter.cjs.js';
+export { _default as default } from './Emitter.cjs.default.js';

package/Emitter.esm.js

@@ -0,0 +1,21 @@
+let Emitter = (namespace) => {
+    const all = new Map();
+    return {
+        on(name, handler) {
+            const handlers = all.get(`${namespace}.${String(name)}`);
+            const added = handlers && handlers.push(handler);
+            if (!added) {
+                all.set(`${namespace}.${String(name)}`, [handler]);
+            }
+        },
+        emit(name, data) {
+            (all.get(`${namespace}.${String(name)}`) || [])
+                .slice()
+                .map((handler) => {
+                handler(data);
+            });
+        },
+    };
+};
+
+export { Emitter, Emitter as default };

package/README.md

@@ -0,0 +1,48 @@
+# @koine/utils
+
+Libraries to encapsulate and re-export from here, the selection is based on:
+
+- [x] full typescript support
+- [x] treeshake-ability
+- [x] docs in source comments
+
+- [dhmk-utils](https://github.com/dhmk083/dhmk-utils)
+- [mesqueeb/merge-anything](https://github.com/mesqueeb/merge-anything)
+- [mesqueeb/filter-anything](https://github.com/mesqueeb/filter-anything)
+- [mesqueeb/case-anything](https://github.com/mesqueeb/case-anything)
+- [mesqueeb/nestify-anything](https://github.com/mesqueeb/nestify-anything)
+- [mesqueeb/fast-sort (fork)](https://github.com/mesqueeb/fast-sort "fork")
+- [mesqueeb/compare-anything](https://github.com/mesqueeb/compare-anything)
+- [mesqueeb/copy-anything](https://github.com/mesqueeb/copy-anything)
+- [mesqueeb/flatten-anything](https://github.com/mesqueeb/flatten-anything)
+
+To consider:
+
+- [dlv](https://www.npmjs.com/package/dlv)
+- [lukeed/dset](https://github.com/lukeed/dset)
+- [angus-c/just](https://github.com/angus-c/just)
+
+About ts utilities types @see:
+
+- [sindresorhus/type-fest](https://github.com/sindresorhus/type-fest)
+- [millsp/ts-toolbelt](https://github.com/millsp/ts-toolbelt)
+- [ts-essentials](https://github.com/ts-essentials/ts-essentials)
+
+For inspiration look at [1loc.dev](https://1loc.dev).
+
+About utilities useful examples @see:
+
+- [chakra-ui](https://github.com/chakra-ui/chakra-ui/blob/main/packages/utils/src)
+
+TODO: We could also re-exports direct dependencies of packages that we often use
+anyway like [those of `yup`](https://github.com/jquense/yup/blob/master/package.json#L103):
+
+- [tiny-case](https://github.com/jquense/tiny-case)
+- [property-expr](https://github.com/jquense/expr/blob/master/index.js)
+- [toposort](https://github.com/marcelklehr/toposort)
+
+TODO: check typescript utilities in [TypeScript core](https://github.com/microsoft/TypeScript/blob/main/src/compiler/core.ts)
+
+## Code
+
+- Transformative functions like `truncate` or `titleCase` should allow for nullable inputs as much as possible, acceptin both `undefined` and `null`.

package/accentSets.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./accentSets";
+export { default } from "./accentSets";

package/accentSets.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./accentSets.cjs.js').default;

package/accentSets.cjs.js

@@ -0,0 +1,36 @@
+'use strict';
+
+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", "ŹŻŽ"],
+];
+
+exports.accentsSets = accentsSets;
+exports["default"] = accentsSets;

package/accentSets.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './accentSets.cjs.js';
+export { _default as default } from './accentSets.cjs.default.js';

package/accentSets.esm.js

@@ -0,0 +1,31 @@
+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.d.ts

@@ -0,0 +1,2 @@
+export * from "./addOrReplaceAtIdx";
+export { default } from "./addOrReplaceAtIdx";

package/addOrReplaceAtIdx.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./addOrReplaceAtIdx.cjs.js').default;

package/addOrReplaceAtIdx.cjs.js

@@ -0,0 +1,21 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let addOrReplaceAtIdx = (list, newItem, newIdx) => {
+    if (list.length === 0) {
+        return [newItem];
+    }
+    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
+        return [...list, newItem];
+    }
+    return list.map((item, idx) => {
+        if (idx === newIdx) {
+            return newItem;
+        }
+        return item;
+    });
+};
+
+exports.addOrReplaceAtIdx = addOrReplaceAtIdx;
+exports["default"] = addOrReplaceAtIdx;

package/addOrReplaceAtIdx.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './addOrReplaceAtIdx.cjs.js';
+export { _default as default } from './addOrReplaceAtIdx.cjs.default.js';

package/addOrReplaceAtIdx.esm.js

@@ -0,0 +1,16 @@
+let addOrReplaceAtIdx = (list, newItem, newIdx) => {
+    if (list.length === 0) {
+        return [newItem];
+    }
+    if (typeof newIdx === "undefined" || list.length - 1 < newIdx) {
+        return [...list, newItem];
+    }
+    return list.map((item, idx) => {
+        if (idx === newIdx) {
+            return newItem;
+        }
+        return item;
+    });
+};
+
+export { addOrReplaceAtIdx, addOrReplaceAtIdx as default };

package/areEqual.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./areEqual";
+export { default } from "./areEqual";

package/areEqual.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./areEqual.cjs.js').default;

package/areEqual.cjs.js

@@ -0,0 +1,55 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var isArray = require('./isArray.cjs.js');
+var isObject = require('./isObject.cjs.js');
+require('./getType.cjs.js');
+require('./isPlainObject.cjs.js');
+
+let areEqualArrays = (a, b) => {
+    if (!b)
+        return false;
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!areEqual(a[i], b[i]))
+            return false;
+    }
+    return true;
+};
+let areEqualObjects = (a, b) => {
+    if (!b)
+        return false;
+    const aKeys = Object.keys(a);
+    for (const _key of aKeys) {
+        const key = _key;
+        if (!areEqual(a[key], b[key])) {
+            return false;
+        }
+    }
+    return true;
+};
+let areEqual = (a, b) => {
+    if (!a && !b) {
+        return true;
+    }
+    if (!b && a !== b) {
+        return false;
+    }
+    const areObjects = isObject.isObject(a) && isObject.isObject(b);
+    if (areObjects && !areEqualObjects(a, b)) {
+        return false;
+    }
+    const areArrays = isArray.isArray(a) && isArray.isArray(b);
+    if (areArrays && !areEqualArrays(a, b)) {
+        return false;
+    }
+    if (!areObjects && !areArrays && a !== b) {
+        return false;
+    }
+    return true;
+};
+
+exports.areEqual = areEqual;
+exports["default"] = areEqual;

package/areEqual.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './areEqual.cjs.js';
+export { _default as default } from './areEqual.cjs.default.js';

package/areEqual.esm.js

@@ -0,0 +1,50 @@
+import { isArray } from './isArray.esm.js';
+import { isObject } from './isObject.esm.js';
+import './getType.esm.js';
+import './isPlainObject.esm.js';
+
+let areEqualArrays = (a, b) => {
+    if (!b)
+        return false;
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!areEqual(a[i], b[i]))
+            return false;
+    }
+    return true;
+};
+let areEqualObjects = (a, b) => {
+    if (!b)
+        return false;
+    const aKeys = Object.keys(a);
+    for (const _key of aKeys) {
+        const key = _key;
+        if (!areEqual(a[key], b[key])) {
+            return false;
+        }
+    }
+    return true;
+};
+let areEqual = (a, b) => {
+    if (!a && !b) {
+        return true;
+    }
+    if (!b && a !== b) {
+        return false;
+    }
+    const areObjects = isObject(a) && isObject(b);
+    if (areObjects && !areEqualObjects(a, b)) {
+        return false;
+    }
+    const areArrays = isArray(a) && isArray(b);
+    if (areArrays && !areEqualArrays(a, b)) {
+        return false;
+    }
+    if (!areObjects && !areArrays && a !== b) {
+        return false;
+    }
+    return true;
+};
+
+export { areEqual, areEqual as default };

package/arrayFilterFalsy.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./arrayFilterFalsy";
+export { default } from "./arrayFilterFalsy";

package/arrayFilterFalsy.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./arrayFilterFalsy.cjs.js').default;

package/arrayFilterFalsy.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let arrayFilterFalsy = (list) => (list ? list.filter((r) => !!r) : []);
+
+exports.arrayFilterFalsy = arrayFilterFalsy;
+exports["default"] = arrayFilterFalsy;

package/arrayFilterFalsy.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './arrayFilterFalsy.cjs.js';
+export { _default as default } from './arrayFilterFalsy.cjs.default.js';

package/arrayFilterFalsy.esm.js

@@ -0,0 +1,3 @@
+let arrayFilterFalsy = (list) => (list ? list.filter((r) => !!r) : []);
+
+export { arrayFilterFalsy, arrayFilterFalsy as default };

package/arrayFindLastIndex.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./arrayFindLastIndex";
+export { default } from "./arrayFindLastIndex";

package/arrayFindLastIndex.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./arrayFindLastIndex.cjs.js').default;

package/arrayFindLastIndex.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let arrayFindLastIndex = (array, predicate) => {
+    let l = array.length;
+    while (l--) {
+        if (predicate(array[l], l, array))
+            return l;
+    }
+    return -1;
+};
+
+exports.arrayFindLastIndex = arrayFindLastIndex;
+exports["default"] = arrayFindLastIndex;

package/arrayFindLastIndex.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './arrayFindLastIndex.cjs.js';
+export { _default as default } from './arrayFindLastIndex.cjs.default.js';

package/arrayFindLastIndex.esm.js

@@ -0,0 +1,10 @@
+let arrayFindLastIndex = (array, predicate) => {
+    let l = array.length;
+    while (l--) {
+        if (predicate(array[l], l, array))
+            return l;
+    }
+    return -1;
+};
+
+export { arrayFindLastIndex, arrayFindLastIndex as default };

package/arrayOfAll.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./arrayOfAll";
+export { default } from "./arrayOfAll";

package/arrayOfAll.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./arrayOfAll.cjs.js').default;

package/arrayOfAll.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let arrayOfAll = () => (array) => array;
+
+exports.arrayOfAll = arrayOfAll;
+exports["default"] = arrayOfAll;

package/arrayOfAll.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './arrayOfAll.cjs.js';
+export { _default as default } from './arrayOfAll.cjs.default.js';

package/arrayOfAll.esm.js

@@ -0,0 +1,3 @@
+let arrayOfAll = () => (array) => array;
+
+export { arrayOfAll, arrayOfAll as default };

package/arraySum.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./arraySum";
+export { default } from "./arraySum";

package/arraySum.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./arraySum.cjs.js').default;

package/arraySum.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let arraySum = (numbers) => numbers.reduce((sum, current) => sum + current, 0);
+
+exports.arraySum = arraySum;
+exports["default"] = arraySum;

package/arraySum.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './arraySum.cjs.js';
+export { _default as default } from './arraySum.cjs.default.js';

package/arraySum.esm.js

@@ -0,0 +1,3 @@
+let arraySum = (numbers) => numbers.reduce((sum, current) => sum + current, 0);
+
+export { arraySum, arraySum as default };

package/arrayToLookup.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./arrayToLookup";
+export { default } from "./arrayToLookup";

package/arrayToLookup.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./arrayToLookup.cjs.js').default;

package/arrayToLookup.cjs.js

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let arrayToLookup = (array = []) => array.reduce((obj, item) => {
+    obj[item] = 1;
+    return obj;
+}, {});
+
+exports.arrayToLookup = arrayToLookup;
+exports["default"] = arrayToLookup;

package/arrayToLookup.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './arrayToLookup.cjs.js';
+export { _default as default } from './arrayToLookup.cjs.default.js';

package/arrayToLookup.esm.js

@@ -0,0 +1,6 @@
+let arrayToLookup = (array = []) => array.reduce((obj, item) => {
+    obj[item] = 1;
+    return obj;
+}, {});
+
+export { arrayToLookup, arrayToLookup as default };

package/arrayUniqueByProperties.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./arrayUniqueByProperties";
+export { default } from "./arrayUniqueByProperties";

package/arrayUniqueByProperties.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./arrayUniqueByProperties.cjs.js').default;

package/arrayUniqueByProperties.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let arrayUniqueByProperties = (array, keys) => array.filter((item, idx, arr) => arr.findIndex((itemWith) => keys.every((k) => itemWith[k] === item[k])) === idx);
+
+exports.arrayUniqueByProperties = arrayUniqueByProperties;
+exports["default"] = arrayUniqueByProperties;

package/arrayUniqueByProperties.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './arrayUniqueByProperties.cjs.js';
+export { _default as default } from './arrayUniqueByProperties.cjs.default.js';

package/arrayUniqueByProperties.esm.js

@@ -0,0 +1,3 @@
+let arrayUniqueByProperties = (array, keys) => array.filter((item, idx, arr) => arr.findIndex((itemWith) => keys.every((k) => itemWith[k] === item[k])) === idx);
+
+export { arrayUniqueByProperties, arrayUniqueByProperties as default };

package/buildUrlQueryString.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./buildUrlQueryString";
+export { default } from "./buildUrlQueryString";

package/buildUrlQueryString.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./buildUrlQueryString.cjs.js').default;

package/buildUrlQueryString.cjs.js

@@ -0,0 +1,29 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var isArray = require('./isArray.cjs.js');
+var isNull = require('./isNull.cjs.js');
+var isUndefined = require('./isUndefined.cjs.js');
+require('./getType.cjs.js');
+
+let buildUrlQueryString = (params) => {
+    let output = "";
+    if (!params)
+        return output;
+    for (const key in params) {
+        const value = params[key];
+        if (isArray.isArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                output += `${key}=${encodeURIComponent(value[i] + "")}&`;
+            }
+        }
+        else if (!isNull.isNull(value) && !isUndefined.isUndefined(value)) {
+            output += `${key}=${encodeURIComponent(value + "")}&`;
+        }
+    }
+    return output ? `?${output.replace(/&+$/, "")}` : "";
+};
+
+exports.buildUrlQueryString = buildUrlQueryString;
+exports["default"] = buildUrlQueryString;

package/buildUrlQueryString.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './buildUrlQueryString.cjs.js';
+export { _default as default } from './buildUrlQueryString.cjs.default.js';