@ezez/utils 1.0.0

package/esm/setImmutable.js

@@ -0,0 +1,56 @@
+const isObject = (value) => (typeof value === "object" || typeof value === "function") && value !== null;
+const clone = (value) => {
+    if (Array.isArray(value)) {
+        return [...value];
+    }
+    return { ...value };
+};
+const hasOnlyValidPathParts = (array) => {
+    if (!array.length) {
+        return false;
+    }
+    return array.every(item => {
+        const type = typeof item;
+        return (type === "string" && item !== "") || type === "number";
+    });
+};
+const getPathParts = (path) => {
+    if (typeof path === "number") {
+        return [String(path)];
+    }
+    if (typeof path === "string") {
+        return path.split(".");
+    }
+    if (Array.isArray(path)) {
+        return path;
+    }
+    throw new TypeError("Path must be a string, a number or an array of strings and numbers");
+};
+const setImmutable = (source, path, value) => {
+    const pathParts = getPathParts(path);
+    const isValidPath = hasOnlyValidPathParts(pathParts);
+    if (!isValidPath) {
+        throw new TypeError("Path must not be empty or contain empty parts");
+    }
+    const len = pathParts.length;
+    const result = isObject(source) ? clone(source) : {};
+    let current = result;
+    for (let i = 0; i < len; i++) {
+        const isLast = i === len - 1;
+        const key = pathParts[i];
+        if (isLast) {
+            current[key] = value;
+            return result;
+        }
+        if (!isObject(current[key])) {
+            current[key] = {};
+        }
+        else {
+            current[key] = clone(current[key]);
+        }
+        current = current[key];
+    }
+    return result;
+};
+export { setImmutable };
+//# sourceMappingURL=setImmutable.js.map

package/esm/setImmutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setImmutable.js","sourceRoot":"","sources":["../src/setImmutable.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;AAElH,MAAM,KAAK,GAAG,CAAC,KAAyB,EAAE,EAAE;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACtB,OAAO,CAAC,GAAG,KAA2B,CAAC,CAAC;KAC3C;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACxB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,KAAgB,EAAE,EAAE;IAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QACf,OAAO,KAAK,CAAC;KAChB;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC;QACzB,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,IAAI,IAAI,KAAK,QAAQ,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAUF,MAAM,YAAY,GAAG,CAAC,IAAU,EAAE,EAAE;IAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;KACzB;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;KAC1B;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACrB,OAAO,IAAI,CAAC;KACf;IACD,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;AAC9F,CAAC,CAAC;AAwBF,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,IAAU,EAAE,KAAc,EAAoB,EAAE;IAClF,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,EAAE;QACd,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;KACxE;IACD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;IAE7B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD,IAAI,OAAO,GAAqB,MAAM,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,MAAM,EAAE;YACP,OAAkB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjC,OAAO,MAAM,CAAC;SACjB;QACD,IAAI,CAAC,QAAQ,CAAE,OAAkB,CAAC,GAAG,CAAC,CAAC,EAAE;YACpC,OAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;SACjC;aACI;YACA,OAAkB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAE,OAAkB,CAAC,GAAG,CAAuB,CAAC,CAAC;SACpF;QACD,OAAO,GAAI,OAAkB,CAAC,GAAG,CAAC,CAAC;KACtC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/esm/sortBy.d.ts

@@ -0,0 +1,3 @@
+declare const sortBy: <T>(propertyName: keyof T, asc?: boolean, defaultValue?: unknown) => (a: T, b: T) => 0 | 1 | -1;
+export { sortBy, };
+//# sourceMappingURL=sortBy.d.ts.map

package/esm/sortBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortBy.d.ts","sourceRoot":"","sources":["../src/sortBy.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,MAAM,2DAAwD,OAAO,+BAY1E,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}

package/esm/sortBy.js

@@ -0,0 +1,12 @@
+const sortBy = (propertyName, asc = true, defaultValue = null) => (a, b) => {
+    var _a, _b;
+    if (a[propertyName] === b[propertyName]) {
+        return 0;
+    }
+    if (((_a = a[propertyName]) !== null && _a !== void 0 ? _a : defaultValue) > ((_b = b[propertyName]) !== null && _b !== void 0 ? _b : defaultValue)) {
+        return asc ? 1 : -1;
+    }
+    return asc ? -1 : 1;
+};
+export { sortBy, };
+//# sourceMappingURL=sortBy.js.map

package/esm/sortBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortBy.js","sourceRoot":"","sources":["../src/sortBy.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,GAAG,CAAI,YAAqB,EAAE,GAAG,GAAG,IAAI,EAAE,eAAwB,IAAI,EAAE,EAAE,CAAC,CAAC,CAAI,EAAE,CAAI,EAAE,EAAE;;IAClG,IAAI,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE;QACrC,OAAO,CAAC,CAAC;KACZ;IAGD,IAAI,CAAC,MAAA,CAAC,CAAC,YAAY,CAAC,mCAAI,YAAY,CAAC,GAAG,CAAC,MAAA,CAAC,CAAC,YAAY,CAAC,mCAAI,YAAY,CAAC,EAAE;QAEvE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACvB;IAED,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}

package/esm/throttle.d.ts

@@ -0,0 +1,13 @@
+interface Opts {
+    leading?: boolean;
+    trailing?: boolean;
+}
+interface Extras {
+    cancel: () => void;
+    flush: () => void;
+}
+type CanReturnUndefined<F extends (...args: any[]) => any> = (...args: Parameters<F>) => ReturnType<F> | undefined;
+declare const throttle: <RT, F extends (...args: any[]) => RT>(fn: F, time?: number | [number, ...number[]], options?: Opts) => CanReturnUndefined<F> & Extras;
+export { throttle, };
+export type { Extras as ThrottledFunctionExtras, Opts as ThrottleOptions, CanReturnUndefined as ThrottledFunction, };
+//# sourceMappingURL=throttle.d.ts.map

package/esm/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../src/throttle.ts"],"names":[],"mappings":"AAAA,UAAU,IAAI;IAIV,OAAO,CAAC,EAAE,OAAO,CAAC;IAIlB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,MAAM;IAIZ,MAAM,EAAE,MAAM,IAAI,CAAC;IAInB,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAQD,KAAK,kBAAkB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAoBnH,QAAA,MAAM,QAAQ,2BAA4B,GAAG,EAAE,uBAC9B,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,YAAgB,IAAI,mCA6FlE,CAAC;AAEF,OAAO,EACH,QAAQ,GACX,CAAC;AAEF,YAAY,EACR,MAAM,IAAI,uBAAuB,EACjC,IAAI,IAAI,eAAe,EACvB,kBAAkB,IAAI,iBAAiB,GAC1C,CAAC"}

package/esm/throttle.js

@@ -0,0 +1,79 @@
+const defaultOptions = {
+    leading: true,
+    trailing: true,
+};
+const throttle = (fn, time = 0, options) => {
+    var _a, _b;
+    const opts = {
+        leading: (_a = options === null || options === void 0 ? void 0 : options.leading) !== null && _a !== void 0 ? _a : defaultOptions.leading,
+        trailing: (_b = options === null || options === void 0 ? void 0 : options.trailing) !== null && _b !== void 0 ? _b : defaultOptions.trailing,
+    };
+    if (!opts.trailing && !opts.leading) {
+        throw new TypeError("Throttle with trailing & leading options `false` won't do anything.");
+    }
+    if (typeof time !== "number" && !time.length) {
+        throw new TypeError("`time` must be an array with at least one number.");
+    }
+    const finalTime = typeof time === "number" ? time : time[time.length - 1];
+    let lastRun = 0, timeoutId = null, lastResult, lastArgs, lastTime = typeof time === "number" ? time : time[0], leadingCalled = false;
+    const times = typeof time === "number" ? [time] : [...time];
+    const throttledFn = ((...args) => {
+        var _a, _b, _c;
+        lastArgs = args;
+        if (timeoutId !== null) {
+            return lastResult;
+        }
+        if (!opts.trailing) {
+            if (Date.now() - lastRun < lastTime) {
+                return lastResult;
+            }
+            lastTime = (_a = times.shift()) !== null && _a !== void 0 ? _a : finalTime;
+            lastRun = Date.now();
+            lastResult = fn(...args);
+            return lastResult;
+        }
+        const diffLastRun = Date.now() - lastRun;
+        if (opts.leading && (!leadingCalled || typeof time === "number") && diffLastRun >= ((_b = times[0]) !== null && _b !== void 0 ? _b : finalTime)) {
+            lastRun = Date.now();
+            lastResult = fn(...args);
+            leadingCalled = true;
+            return lastResult;
+        }
+        if (lastRun || !opts.leading) {
+            lastTime = (_c = times.shift()) !== null && _c !== void 0 ? _c : finalTime;
+        }
+        timeoutId = setTimeout(() => {
+            timeoutId = null;
+            lastRun = Date.now();
+            lastResult = fn(...args);
+        }, lastRun ? (lastTime - diffLastRun + 1) : lastTime);
+        return lastResult;
+    });
+    throttledFn.cancel = () => {
+        timeoutId !== null && clearTimeout(timeoutId);
+        timeoutId = null;
+        lastRun = 0;
+        lastResult = undefined;
+        times.length = 0;
+        if (typeof time === "number") {
+            times.push(time);
+        }
+        else {
+            times.push(...time);
+        }
+        lastTime = typeof time === "number" ? time : time[0];
+    };
+    throttledFn.flush = () => {
+        if (timeoutId !== null) {
+            lastRun = Date.now();
+            lastResult = fn(...lastArgs);
+            clearTimeout(timeoutId);
+            timeoutId = null;
+            return throttledFn(...lastArgs);
+        }
+        return lastResult;
+    };
+    return throttledFn;
+};
+export { throttle, };
+//# sourceMappingURL=throttle.js.map

package/esm/throttle.js.map

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

package/esm/truthy.d.ts

@@ -0,0 +1,3 @@
+declare const truthy: <T>(val: false | "" | 0 | T | null | undefined) => val is T;
+export { truthy, };
+//# sourceMappingURL=truthy.d.ts.map

package/esm/truthy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truthy.d.ts","sourceRoot":"","sources":["../src/truthy.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,MAAM,6DAEX,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}

package/esm/truthy.js

@@ -0,0 +1,5 @@
+const truthy = (val) => {
+    return Boolean(val);
+};
+export { truthy, };
+//# sourceMappingURL=truthy.js.map

package/esm/truthy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truthy.js","sourceRoot":"","sources":["../src/truthy.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,GAAG,CAAI,GAA0C,EAAY,EAAE;IACvE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF,OAAO,EACH,MAAM,GACT,CAAC"}

package/esm/wait.d.ts

@@ -0,0 +1,3 @@
+declare const wait: (timeMs?: number) => Promise<void>;
+export { wait, };
+//# sourceMappingURL=wait.d.ts.map

package/esm/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,IAAI,oCAIT,CAAC;AAEF,OAAO,EACH,IAAI,GACP,CAAC"}

package/esm/wait.js

@@ -0,0 +1,7 @@
+const wait = (timeMs = 0) => {
+    return new Promise((resolve) => {
+        setTimeout(() => { resolve(); }, timeMs);
+    });
+};
+export { wait, };
+//# sourceMappingURL=wait.js.map

package/esm/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"AAKA,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE;IACxB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACjC,UAAU,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EACH,IAAI,GACP,CAAC"}

package/esm/waitFor.d.ts

@@ -0,0 +1,3 @@
+declare const waitFor: <T>(fn: () => T, interval?: number, timeout?: number) => Promise<T>;
+export { waitFor };
+//# sourceMappingURL=waitFor.d.ts.map

package/esm/waitFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitFor.d.ts","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAcA,QAAA,MAAM,OAAO,qEA8BZ,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/esm/waitFor.js

@@ -0,0 +1,31 @@
+const DEFAULT_INTERVAL = 50;
+const waitFor = (fn, interval = DEFAULT_INTERVAL, timeout = Infinity) => {
+    return new Promise((resolve, reject) => {
+        let intervalTimer, failTimer;
+        if (isFinite(timeout)) {
+            failTimer = setTimeout(() => {
+                reject(new Error("[waitFor] Timeout"));
+                clearInterval(intervalTimer);
+            }, timeout);
+        }
+        intervalTimer = setInterval(() => {
+            try {
+                const result = fn();
+                if (result) {
+                    clearTimeout(failTimer);
+                    clearInterval(intervalTimer);
+                    resolve(result);
+                }
+            }
+            catch (error) {
+                clearTimeout(failTimer);
+                clearInterval(intervalTimer);
+                const e = new Error("[waitFor] check function threw an error");
+                e.details = { error };
+                reject(e);
+            }
+        }, interval);
+    });
+};
+export { waitFor };
+//# sourceMappingURL=waitFor.js.map

package/esm/waitFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitFor.js","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAc5B,MAAM,OAAO,GAAG,CAAI,EAAW,EAAE,QAAQ,GAAG,gBAAgB,EAAE,OAAO,GAAG,QAAQ,EAAE,EAAE;IAChF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,aAAwB,EAAE,SAAmB,CAAC;QAElD,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE;YACnB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACvC,aAAa,CAAC,aAAa,CAAC,CAAC;YACjC,CAAC,EAAE,OAAO,CAAC,CAAC;SACf;QAED,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI;gBACA,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;gBACpB,IAAI,MAAM,EAAE;oBACR,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;iBACnB;aACJ;YACD,OAAO,KAAc,EAAE;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,aAAa,CAAC,aAAa,CAAC,CAAC;gBAE7B,MAAM,CAAC,GAAkC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBAC9F,CAAC,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,CAAC,CAAC,CAAC;aACb;QACL,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/esm/waitSync.d.ts

@@ -0,0 +1,3 @@
+declare const waitSync: (timeMs?: number) => void;
+export { waitSync, };
+//# sourceMappingURL=waitSync.d.ts.map

package/esm/waitSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitSync.d.ts","sourceRoot":"","sources":["../src/waitSync.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,QAAQ,2BAIb,CAAC;AAEF,OAAO,EACH,QAAQ,GACX,CAAC"}

package/esm/waitSync.js

@@ -0,0 +1,6 @@
+const waitSync = (timeMs = 0) => {
+    const s = Date.now();
+    while (Date.now() - s < timeMs) { }
+};
+export { waitSync, };
+//# sourceMappingURL=waitSync.js.map

package/esm/waitSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitSync.js","sourceRoot":"","sources":["../src/waitSync.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAErB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,GAAE;AACtC,CAAC,CAAC;AAEF,OAAO,EACH,QAAQ,GACX,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@ezez/utils",
+  "version": "1.0.0",
+  "repository": "https://github.com/dzek69/bottom-line.git",
+  "author": "Jacek Nowacki @dzek69 <git-public@dzek.eu>",
+  "license": "MIT",
+  "scripts": {
+    "test": "NODE_ENV=test jest",
+    "test:lodashImports": "node test/lodash-tree.cjs",
+    "docs": "typedoc src/index.ts --skipErrorChecking --out docs --includeVersion --pluginPages ./pagesconfig.json",
+    "compile": "yarn compile:esm && yarn compile:cjs",
+    "compile:esm": "rm -rf esm && tsc --project tsconfig.esm.json && node ./build-scripts/compile.esm.after.mjs",
+    "compile:cjs": "rm -rf dist && tsc --project tsconfig.cjs.json && node ./build-scripts/compile.cjs.after.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx,.js,.jsx,.mjs",
+    "lint:fix": "yarn lint --fix",
+    "prepack": "yarn compile",
+    "prepublishOnly": "yarn audit && yarn lint && yarn test && yarn docs",
+    "start:dev": "nodemon",
+    "start:dev:compatibility": "TS_NODE_FILES=true yarn start:dev",
+    "prepare": "husky install",
+    "updates": "npx --yes npm-check-updates --dep prod",
+    "updates:dev": "npx --yes npm-check-updates --dep dev",
+    "updates:all": "npx --yes npm-check-updates"
+  },
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./esm/index.d.ts",
+      "default": "./esm/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./esm/index.d.ts",
+  "module": "./esm/index.js",
+  "type": "module",
+  "devDependencies": {
+    "@babel/core": "^7.19.3",
+    "@babel/preset-env": "^7.19.3",
+    "@babel/preset-typescript": "^7.18.6",
+    "@dzek69/eslint-config-base": "^2.3.0",
+    "@dzek69/eslint-config-typescript": "^1.0.2",
+    "@types/jest": "^29.0.3",
+    "@types/lodash": "^4.14.168",
+    "@typescript-eslint/eslint-plugin": "^5.38.1",
+    "@typescript-eslint/parser": "^5.38.1",
+    "babel-plugin-module-extension": "^0.1.3",
+    "eslint": "^8.24.0",
+    "fs-extra": "^10.1.0",
+    "husky": "^8.0.1",
+    "jest": "^29.1.1",
+    "lodash": "^4.17.21",
+    "must": "^0.13.4",
+    "nodemon": "^2.0.20",
+    "ts-node": "^10.9.1",
+    "typedoc": "^0.23.15",
+    "typescript": "^4.9.5",
+    "eslint-plugin-import": "^2.26.0",
+    "@dzek69/eslint-config-import": "^1.0.0",
+    "@dzek69/eslint-config-import-typescript": "^1.0.0",
+    "@knodes/typedoc-plugin-pages": "^0.23.1",
+    "prettier": "^2.8.3"
+  },
+  "husky": {
+    "hooks": {
+      "pre-push": "yarn prepublishOnly && yarn compile"
+    }
+  },
+  "libraryTemplate": {
+    "version": "3.8.0",
+    "language": "typescript",
+    "fixDefaultForCommonJS": false,
+    "jsx": false
+  }
+}

package/src/cap.spec.ts

@@ -0,0 +1,36 @@
+import { cap } from "./cap.js";
+
+describe("cap", () => {
+    it("caps too big values", () => {
+        cap(200, 100).must.equal(100);
+        cap(101, 100).must.equal(100);
+        cap(100.0001, 100).must.equal(100);
+    });
+
+    it("leaves not big values", () => {
+        cap(100, 100).must.equal(100);
+        cap(99.999, 100).must.equal(99.999);
+    });
+
+    it("caps too small values", () => {
+        cap(-100, 100, 5).must.equal(5);
+        cap(4, 100, 5).must.equal(5);
+    });
+
+    it("leaves not too small values", () => {
+        cap(6, 100, 5).must.equal(6);
+        cap(5, 100, 5).must.equal(5);
+        cap(23, 100, 5).must.equal(23);
+    });
+
+    it("throws when max expected value is lower than min expected value", () => {
+        (() => cap(6.4, 5, 7)).must.throw();
+    });
+
+    it("allows the same min and max value", function() {
+        (() => cap(5, 5, 5)).must.not.throw();
+        cap(5, 5, 5).must.equal(5);
+        cap(4, 5, 5).must.equal(5);
+        cap(6, 5, 5).must.equal(5);
+    });
+});

package/src/cap.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns a number capped between an upper and lower limit.
+ * @param {number} value - value to cap
+ * @param {number} upperLimit - upper limit, inclusive
+ * @param {number} [lowerLimit] - lower limit, inclusive
+ */
+const cap = (value: number, upperLimit: number, lowerLimit?: number) => {
+    if (lowerLimit == null) {
+        return Math.min(value, upperLimit);
+    }
+    if (upperLimit < lowerLimit) {
+        throw new TypeError("upperLimit must be greater than lowerLimit");
+    }
+    return Math.min(upperLimit, Math.max(lowerLimit, value));
+};
+
+export {
+    cap,
+};

package/src/capitalize.spec.ts

@@ -0,0 +1,18 @@
+import { capitalize } from "./capitalize.js";
+
+describe("capitalize", () => {
+    it("capitalizes first letter", () => {
+        const string = "abcd";
+        capitalize(string).must.equal("Abcd");
+    });
+
+    it("doesn't touch other characters by default", function() {
+        const string = "aBcD";
+        capitalize(string).must.equal("ABcD");
+    });
+
+    it("converts other to small caps if reqested", function() {
+        const string = "aBcD";
+        capitalize(string, true).must.equal("Abcd");
+    });
+});

package/src/capitalize.ts

@@ -0,0 +1,16 @@
+/**
+ * Capitalize the first letter of a string.
+ * @param {string} text - source string
+ * @param {boolean} [restLowercase=false] - should the rest of the string be forced to lowercase?
+ * @example capitalize("hello") // "Hello"
+ * @example capitalize("hello my Friend", true) // "Hello my friend"
+ * @example capitalize("hello my Friend", false) // "Hello my Friend"
+ */
+const capitalize = (text: string, restLowercase = false) => {
+    const rest = restLowercase ? text.slice(1).toLowerCase() : text.slice(1);
+    return text.charAt(0).toUpperCase() + rest;
+};
+
+export {
+    capitalize,
+};

package/src/coalesce.spec.ts

@@ -0,0 +1,23 @@
+import { coalesce } from "./coalesce.js";
+
+describe("coalesce", () => {
+    it("works with basic values", () => {
+        coalesce(undefined, null, 69).must.equal(69);
+        coalesce(null, null, undefined, 69, null).must.equal(69);
+    });
+
+    it("returns falsy values", () => {
+        coalesce(undefined, null, false, 5).must.equal(false);
+        coalesce(undefined, null, 0, 5).must.equal(0);
+        coalesce(undefined, null, "", 5).must.equal("");
+        coalesce(undefined, null, NaN, 5).must.be.nan();
+    });
+
+    it("returns null if no non-nil value is found", () => {
+        (coalesce(null, undefined) === null).must.be.true();
+    });
+
+    it("returns null if no arguments are given", () => {
+        (coalesce() === null).must.be.true();
+    });
+});

package/src/coalesce.ts

@@ -0,0 +1,21 @@
+/**
+ * Returns first non-nil (not undefined, not null) value from given arguments.
+ *
+ * @param {...*} args - values
+ * @example coalesce(null, undefined, void 0, 5); // returns 5
+ * @example coalesce(4, null, 6, undefined); // returns 4
+ * @example coalesce(undefined); // returns null
+ * @example coalesce(); // returns null
+ * @returns {*|null} first non-nil value or null
+ */
+const coalesce = <T>(...args: T[]): NonNullable<T> | null => {
+    for (let i = 0; i < args.length; i++) {
+        const item = args[i];
+        if (item != null) {
+            return item;
+        }
+    }
+    return null;
+};
+
+export { coalesce };

package/src/ensureArray.spec.ts

@@ -0,0 +1,87 @@
+import { ensureArray } from "./ensureArray.js";
+
+describe("ensureArray", () => {
+    it("must return given value untouched if the value is an array", () => {
+        singleValue: {
+            const x = [5];
+            const result = ensureArray(x);
+            result.must.be.an.array();
+            result.must.have.length(1);
+            result.must.equal(x);
+            result.must.eql([5]);
+        }
+
+        noValue: {
+            const x = [];
+            const result = ensureArray(x);
+            result.must.be.an.array();
+            result.must.have.length(0);
+            result.must.equal(x);
+        }
+
+        manyValues: {
+            const x = [1, "5"];
+            const result = ensureArray(x);
+            result.must.be.an.array();
+            result.must.have.length(2);
+            result.must.equal(x);
+            result.must.eql([1, "5"]);
+        }
+
+        arrayOfArrays: {
+            const x = [[1], [2]];
+            const result = ensureArray(x);
+            result.must.be.an.array();
+            result.must.have.length(2);
+            result.must.equal(x);
+            result.must.eql([[1], [2]]);
+        }
+    });
+
+    it("must arrarize object", () => {
+        const y = { title: "dzek" };
+        const result = ensureArray(y);
+        result.must.be.an.array();
+        result.must.have.length(1);
+        result[0].must.equal(y);
+        result.must.eql([{ title: "dzek" }]);
+    });
+
+    it("must arrarize function", () => {
+        const y = () => 5;
+
+        const result = ensureArray(y);
+        result.must.be.an.array();
+        result.must.have.length(1);
+        result[0].must.equal(y);
+        result.must.eql([y]);
+    });
+
+    it("must arrarize null", () => {
+        const result = ensureArray(null);
+        result.must.be.an.array();
+        result.must.have.length(1);
+        result.must.eql([null]);
+    });
+
+    it("must arrarize string", () => {
+        const result = ensureArray("hey joe");
+        result.must.be.an.array();
+        result.must.have.length(1);
+        result.must.eql(["hey joe"]);
+    });
+
+    it("must arrarize number", () => {
+        const result = ensureArray(123);
+        result.must.be.an.array();
+        result.must.have.length(1);
+        result.must.eql([123]);
+    });
+
+    it("must arrarize NaN", () => {
+        const result = ensureArray(NaN);
+        result.must.be.an.array();
+        result.must.have.length(1);
+        result.must.eql([NaN]);
+    });
+});

package/src/ensureArray.ts

@@ -0,0 +1,13 @@
+/**
+ * Wraps value in an array until the value is already an array
+ * @param {*} value - value to be wrapped
+ * @returns {Array}
+ */
+const ensureArray = <T>(value: T | T[]): T[] => {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    return [value];
+};
+
+export { ensureArray };

package/src/ensureError.spec.ts

@@ -0,0 +1,29 @@
+import { ensureError } from "./ensureError.js";
+
+describe("ensureError", () => {
+    it("returns unmodified error if error given", () => {
+        const e = new Error("Test");
+
+        const result = ensureError(e);
+        (e === result).must.be.true();
+        result.message.must.equal("Test");
+    });
+
+    it("returns error on anything else than error", () => {
+        const eNull = ensureError(null);
+        eNull.must.be.instanceof(Error);
+        eNull.message.must.equal("Expected error instance, got something else: null");
+
+        const eUndefined = ensureError(undefined);
+        eUndefined.must.be.instanceof(Error);
+        eUndefined.message.must.equal("Expected error instance, got something else: undefined");
+
+        const eNumber = ensureError(6);
+        eNumber.must.be.instanceof(Error);
+        eNumber.message.must.equal("Expected error instance, got something else: 6");
+
+        const eFunction = ensureError(() => {});
+        eFunction.must.be.instanceof(Error);
+        eFunction.message.must.equal("Expected error instance, got something else: () => {}");
+    });
+});