@giveback007/util-lib 0.25.4 → 1.0.0

package/src/clone.ts

@@ -1,35 +1,34 @@
-/* tslint:disable */
-// original source from:
-// https://github.com/davidmarkclements/rfdc
-
-/** Performances deep clone of a given object */
-export function clone<T>(o: T): T
-{
-    let c, x, l, i, k: any, a: any, q: any;
-    if (typeof o !== 'object' || o === null) return o;
-    if (o instanceof Date) return new Date(o) as any;
-
-    x = Object.keys(o); l = x.length;
-
-    if (Array.isArray(o)) {
-      a = new Array(l)
-      for (i = 0; i < l; i++) {
-        k = x[i]; c = o[k];
-        if (typeof c !== 'object' || c === null) a[k] = c;
-        else if (c instanceof Date) a[k] = new Date(c);
-        else a[k] = clone(c);
-      }
-      return a;
-    }
-
-    q = {};
-
-    for (i = 0; i < l; i++) {
-      k = x[i]; c = (o as any)[k];
-      if (Object.hasOwnProperty.call(o, k) === false) continue;
-      if (typeof c !== 'object' || c === null) q[k] = c;
-      else if (c instanceof Date) q[k] = new Date(c);
-      else q[k] = clone(c);
-    }
-    return q;
-}
+/* tslint:disable */
+// original source from:
+// https://github.com/davidmarkclements/rfdc
+
+/** Performances deep clone of a given object */
+export function clone<T>(o: T): T {
+    var c, x, l, i, k: any, a: any, q: any;
+    if (typeof o !== 'object' || o === null) return o;
+    if (o instanceof Date) return new Date(o) as any;
+
+    x = Object.keys(o); l = x.length;
+
+    if (Array.isArray(o)) {
+        a = new Array(l)
+        for (i = 0; i < l; i++) {
+            k = x[i]; c = o[k];
+            if (typeof c !== 'object' || c === null) a[k] = c;
+            else if (c instanceof Date) a[k] = new Date(c);
+            else a[k] = clone(c);
+        }
+        return a;
+    }
+
+    q = {};
+
+    for (i = 0; i < l; i++) {
+        k = x[i]; c = (o as any)[k];
+        if (Object.hasOwnProperty.call(o, k) === false) continue;
+        if (typeof c !== 'object' || c === null) q[k] = c;
+        else if (c instanceof Date) q[k] = new Date(c);
+        else q[k] = clone(c);
+    }
+    return q;
+}

package/src/equality.ts

@@ -1,80 +1,80 @@
-/* tslint:disable */
-// original source from:
-// https://github.com/epoberezkin/fast-deep-equal
-
-export function equal(a: any, b: any) 
-{
-	if (a === b) return true;
-
-	if (a && b && typeof a === 'object' && typeof b === 'object') {
-		if (a.constructor !== b.constructor) return false;
-
-		var length, i, keys;
-		if (Array.isArray(a)) {
-			length = a.length;
-			if (length !== b.length) return false;
-			for (i = length; i-- !== 0;)
-				if (!equal(a[i], b[i])) return false;
-			return true;
-		}
-
-		if ((a instanceof Map) && (b instanceof Map)) {
-			if (a.size !== b.size) return false;
-			for (i of (a as any).entries())
-				if (!b.has(i[0])) return false;
-			for (i of (a  as any).entries())
-				if (!equal(i[1], b.get(i[0]))) return false;
-			return true;
-		}
-
-		if ((a instanceof Set) && (b instanceof Set)) {
-			if (a.size !== b.size) return false;
-			for (i of (a as any).entries())
-				if (!b.has(i[0])) return false;
-			return true;
-		}
-
-		if (ArrayBuffer.isView(a) && ArrayBuffer.isView(b)) {
-			length = (a as any).length;
-			if (length != (b  as any).length) return false;
-			for (i = length; i-- !== 0;)
-				if ((a as any)[i] !== (b as any)[i]) return false;
-			return true;
-		}
-
-
-		if (a.constructor === RegExp)
-			return a.source === b.source && a.flags === b.flags;
-		if (a.valueOf !== Object.prototype.valueOf)
-			return a.valueOf() === b.valueOf();
-		if (a.toString !== Object.prototype.toString)
-			return a.toString() === b.toString();
-
-		keys = Object.keys(a);
-		length = keys.length;
-		if (length !== Object.keys(b).length) return false;
-
-		for (i = length; i-- !== 0;)
-			if (!Object.prototype.hasOwnProperty.call(b, keys[i]))
-				return false;
-
-		for (i = length; i-- !== 0;) {
-			var key = keys[i];
-
-			if (key === '_owner' && a.$$typeof) {
-				// React-specific: avoid traversing React elements'
-				// _owner. _owner contains circular references
-				// and is not needed when comparing the actual elements
-				// (and not their owners)
-				continue;
-			}
-
-			if (!equal(a[key], b[key])) return false;
-		}
-
-		return true;
-	}
-
-	// true if both NaN, false otherwise
-	return a !== a && b !== b;
-};
+/* tslint:disable */
+// original source from:
+// https://github.com/epoberezkin/fast-deep-equal
+
+export function equal(a: any, b: any)
+{
+	if (a === b) return true;
+
+	if (a && b && typeof a === 'object' && typeof b === 'object') {
+		if (a.constructor !== b.constructor) return false;
+
+		var length, i, keys;
+		if (Array.isArray(a)) {
+			length = a.length;
+			if (length !== b.length) return false;
+			for (i = length; i-- !== 0;)
+				if (!equal(a[i], b[i])) return false;
+			return true;
+		}
+
+		if ((a instanceof Map) && (b instanceof Map)) {
+			if (a.size !== b.size) return false;
+			for (i of (a as any).entries())
+				if (!b.has(i[0])) return false;
+			for (i of (a  as any).entries())
+				if (!equal(i[1], b.get(i[0]))) return false;
+			return true;
+		}
+
+		if ((a instanceof Set) && (b instanceof Set)) {
+			if (a.size !== b.size) return false;
+			for (i of (a as any).entries())
+				if (!b.has(i[0])) return false;
+			return true;
+		}
+
+		if (ArrayBuffer.isView(a) && ArrayBuffer.isView(b)) {
+			length = (a as any).length;
+			if (length != (b  as any).length) return false;
+			for (i = length; i-- !== 0;)
+				if ((a as any)[i] !== (b as any)[i]) return false;
+			return true;
+		}
+
+
+		if (a.constructor === RegExp)
+			return a.source === b.source && a.flags === b.flags;
+		if (a.valueOf !== Object.prototype.valueOf)
+			return a.valueOf() === b.valueOf();
+		if (a.toString !== Object.prototype.toString)
+			return a.toString() === b.toString();
+
+		keys = Object.keys(a);
+		length = keys.length;
+		if (length !== Object.keys(b).length) return false;
+
+		for (i = length; i-- !== 0;)
+			if (!Object.prototype.hasOwnProperty.call(b, keys[i]!))
+				return false;
+
+		for (i = length; i-- !== 0;) {
+			var key = keys[i];
+
+			if (key === '_owner' && a.$$typeof) {
+				// React-specific: avoid traversing React elements'
+				// _owner. _owner contains circular references
+				// and is not needed when comparing the actual elements
+				// (and not their owners)
+				continue;
+			}
+
+			if (!equal(a[key as any], b[key as any])) return false;
+		}
+
+		return true;
+	}
+
+	// true if both NaN, false otherwise
+	return a !== a && b !== b;
+};

package/src/general.ts

@@ -1,152 +1,192 @@
-// import * as fetchJsonp from 'fetch-jsonp';
-import type { AnyObj, JsType } from '.';
-import { isType, objMap, hasKey, clone } from '.';
-
-/**
- * @example
- * ```js
- * interval((i) => console.log('idx: ' + i), 1000, 2))
- * // (log =>) "idx: 0"
- * // (log =>) "idx: 1"
- * // only ran twice because maxTimes was set to: `2` (third parameter)
- *
- * interval((i, stop) => i === 10 && stop());
- * // when i is 10 will stop the interval
- * ```
- */
-export const interval = (
-    funct: (i: number, stop: () => void) => any,
-    ms: number,
-
-    /** */
-    maxTimes?: number
-) => {
-    if (isType(maxTimes, 'number') && maxTimes < 1)
-        throw Error('argument "times" can\'t be less than 1');
-
-    let i = 0;
-    /** stops the interval */
-    const stop = () => clearInterval(itv);
-    const itv = setInterval(() => {
-        funct(i, stop);
-        i++;
-
-        if (maxTimes && i >= maxTimes) stop();
-    }, ms);
-
-    return {
-        /** Stop the interval */
-        stop
-    };
-}
-
-/** A promise that waits `ms` amount of milliseconds to execute */
-export const wait = (ms: number): Promise<void> =>
-    new Promise((res) => setTimeout(() => res(), ms));
-
-const usubAllFunct = (x: any, unsubName = 'unsubscribe') =>
-    isType(x, 'object')
-    &&
-    hasKey(x, unsubName) ? x[unsubName]() : null;
-
-export function unsubAll(objOrArr: AnyObj | any[], unsubName = 'unsubscribe') {
-    if (isType(objOrArr, 'array'))
-        objOrArr.forEach(x => usubAllFunct(x, unsubName));
-    else if (isType(objOrArr, 'object'))
-        objMap(objOrArr, ({ val }) => usubAllFunct(val, unsubName));
-    else
-        throw Error('argument "objOrArr" must be of type "object" or "array"');
-}
-
-/**
- * Alternative to console.log in that it will clone the obj.
- *
- * Useful for when it is need to see the object in a specific
- * state instance.
- */
-export const cloneLog = (x: any) => console.log(clone(x));
-
-/** An improved version of native `typeof` */
-export function type(val: any): JsType
-{
-    if (typeof val === 'object') {
-        if (Array.isArray(val)) return 'array';
-        else if (val === null)  return 'null';
-        else                    return 'object';
-    } else {
-        if (val !== val)        return 'NaN';
-        else                    return typeof val;
-    }
-}
-
-// https://httptoolkit.tech/blog/5-big-features-of-typescript-3.7#assert-signatures
-export function assertType<T extends JsType>(
-    val: any,
-    types: T | T[]
-): asserts val is T {
-    if (!isType(types, 'array')) types = [types];
-    for (const t of types) if (isType(val, t)) return;
-
-    throw Error(`value needs to be of type ${types.join(' || ')}`)
-}
-
-export const uuid = () =>
-{
-    let d = new Date().getTime();
-    let d2 = (
-        performance
-        &&
-        performance.now
-        &&
-        (performance.now() * 1000)
-    ) || 0;
-
-    const str = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx';
-    return str.replace(/[xy]/g, (c) => {
-        let r = Math.random() * 16;
-        if (d > 0) {
-            r = (d + r)%16 | 0;
-            d = Math.floor(d/16);
-        } else {
-            r = (d2 + r)%16 | 0;
-            d2 = Math.floor(d2/16);
-        }
-
-        return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
-    });
-}
-
-export const randomColorHex = () =>
-    '#' + ((1<<24)*Math.random() | 0).toString(16);
-
-// export const jsonp = async <T = any>(
-//     url: string,
-//     options?: fetchJsonp.Options
-// ) => (await fetchJsonp(url, options)).json<T>();
-
-// // TODO: include async functions
-// export function strToFnt(fStr: string) {
-//     const x = fStr.slice(fStr.indexOf('('));
-//     const start = x.slice(0, x.indexOf(')') + 1);
-//     const end = x.slice(x.indexOf(')') + 1);
-
-//     // tslint:disable-next-line: no-eval
-//     return eval(start + ' =>' + end);
-// }
-
-export function debounceTimeOut() {
-    let timeoutId: ReturnType<typeof setTimeout> | null = null;
-
-    return (fct: Function | 'cancel', ms?: number) => {
-        if (timeoutId) clearTimeout(timeoutId);
-
-        if (fct !== 'cancel')
-            timeoutId = setTimeout(fct, ms || 0) as any;
-    }
-}
-
-export function promiseOut<T = any>() {
-    let resolve: any;
-    const promise = new Promise((res) => resolve = res);
-    return { resolve: resolve as (value: T) => void, promise };
-}
+// import * as fetchJsonp from 'fetch-jsonp';
+import type { AnyObj, JsType } from '.';
+import { isType, objMap, hasKey, clone } from '.';
+
+/**
+ * @example
+ * ```js
+ * interval((i) => console.log('idx: ' + i), 1000, 2))
+ * // (log =>) "idx: 0"
+ * // (log =>) "idx: 1"
+ * // only ran twice because maxTimes was set to: `2` (third parameter)
+ *
+ * interval((i, stop) => i === 10 && stop());
+ * // when i is 10 will stop the interval
+ * ```
+ */
+export const interval = (
+    func: (i: number, stop: () => void) => any,
+    ms: number = 0,
+
+    /** n times to run the interval */
+    maxTimes: number = Infinity
+) => {
+    maxTimes = Math.floor(maxTimes);
+    if (maxTimes < 1) return { stop: () => void(0) };
+
+    let i = 0;
+
+    const stop = () => clearInterval(itv);
+    const itv = setInterval(() => {
+        func(i, stop);
+        i++;
+
+        if (maxTimes && i >= maxTimes) stop();
+    }, ms);
+
+    return {
+        /** Stop the interval */
+        stop
+    };
+}
+
+/** A promise that waits `ms` amount of milliseconds to execute */
+export const wait = (ms: number): Promise<void> =>
+    new Promise((res) => setTimeout(() => res(), ms));
+
+const usubAllFunct = (x: any, unsubName = 'unsubscribe') =>
+    isType(x, 'object')
+    &&
+    hasKey(x, unsubName) ? x[unsubName]() : null;
+
+export function unsubAll(objOrArr: AnyObj | any[], unsubName = 'unsubscribe') {
+    if (isType(objOrArr, 'array'))
+        objOrArr.forEach(x => usubAllFunct(x, unsubName));
+    else if (isType(objOrArr, 'object'))
+        objMap(objOrArr, ({ val }) => usubAllFunct(val, unsubName));
+    else
+        throw Error('argument "objOrArr" must be of type "object" or "array"');
+}
+
+/**
+ * Alternative to console.log in that it will clone the obj.
+ *
+ * Useful for when it is need to see the object in a specific
+ * state instance.
+ */
+export const cloneLog = (x: any) => console.log(clone(x));
+
+/** An improved version of native `typeof` */
+export function type(val: any): JsType
+{
+    if (typeof val === 'object') {
+        if (Array.isArray(val)) return 'array';
+        else if (val === null)  return 'null';
+        else                    return 'object';
+    } else {
+        if (val !== val)        return 'NaN';
+        else                    return typeof val;
+    }
+}
+
+// https://httptoolkit.tech/blog/5-big-features-of-typescript-3.7#assert-signatures
+export function assertType<T extends JsType>(
+    val: any,
+    types: T | T[]
+): asserts val is T {
+    if (!isType(types, 'array')) types = [types];
+    for (const t of types) if (isType(val, t)) return;
+
+    throw Error(`value needs to be of type: ${types.join(' || ')}`)
+}
+
+export const uuid = () =>
+{
+    let d = new Date().getTime();
+    let d2 = (
+        performance
+        &&
+        performance.now
+        &&
+        (performance.now() * 1000)
+    ) || 0;
+
+    const str = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx';
+    return str.replace(/[xy]/g, (c) => {
+        let r = Math.random() * 16;
+        if (d > 0) {
+            r = (d + r)%16 | 0;
+            d = Math.floor(d/16);
+        } else {
+            r = (d2 + r)%16 | 0;
+            d2 = Math.floor(d2/16);
+        }
+
+        return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
+    });
+}
+
+export const randomColorHex = () =>
+    '#' + ((1<<24)*Math.random() | 0).toString(16);
+
+export const debounce = (fn: AnyFnc, ms: num) => {
+    let timeoutId: ReturnType<typeof setTimeout>;
+    return function (this: any, ...args: any[]) {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn.apply(this, args), ms);
+    };
+};
+
+export function debounceTimeOut() {
+    let timeoutId: ReturnType<typeof setTimeout> | null = null;
+
+    return (fct: Function | 'cancel', ms?: number) => {
+        if (timeoutId) clearTimeout(timeoutId);
+
+        if (fct !== 'cancel')
+            timeoutId = setTimeout(fct, ms || 0) as any;
+    }
+}
+
+export const debounceById = (() => {
+    const debounceDict: Dict<num> = {};
+    return (fn: AnyFnc, ms: num, id: str | num) => {
+        const dId = debounceDict[id];
+        if (dId) clearTimeout(dId);
+
+        debounceDict[id] = setTimeout(fn, ms) as any;
+    }
+})();
+
+export function promiseOut<T = any>() {
+    let resolve: any;
+    let error: any;
+
+    const promise: Promise<T> = new Promise((res, err) => {
+        resolve = res;
+        error = err;
+    });
+
+    return {
+        error: error as (reason?: any) => void,
+        resolve: resolve as (value: T) => void,
+        promise,
+    };
+}
+
+export async function concurrentTasks<T, Res = any>(
+    arr: T[],
+    fn: (x: T, idx: number) => Promise<Res> | Res,
+    nOfConcurrentTasks = 8
+): Promise<Res[]> {
+    let idx = -1;
+    const result: Res[] = [];
+
+    await Promise.all(Array(nOfConcurrentTasks).fill(0).map(async () => {
+        let data: T | undefined;
+        while (data = arr[++idx]) {
+            const i = idx;
+            result[i] = await fn(data, idx)
+        }
+    }));
+
+    return result;
+}
+
+export function hash(str: string) {
+    let hash = 0n;
+    for (let i = 0; i < str.length; i++)
+        hash = (hash * 31n + BigInt(str.charCodeAt(i))) & 0xFFFFFFFFFFFFFFFFn;
+
+    return hash.toString(36);
+}

package/src/index.ts

@@ -1,11 +1,11 @@
-export * from './@types';
-export * from './array';
-export * from './clone';
-export * from './equality';
-export * from './general';
-export * from './iterate';
-export * from './number';
-export * from './object';
-export * from './string';
-export * from './test';
-export * from './time';
+export * from './@types';
+export * from './array';
+export * from './clone';
+export * from './equality';
+export * from './general';
+export * from './iterate';
+export * from './number';
+export * from './object';
+export * from './string';
+export * from './test';
+export * from './time';