@koine/utils 1.0.105 → 1.1.0

package/Defer.d.ts

@@ -1,7 +1,7 @@
 /**
  * @category async
  */
-export declare type Deferred<T> = Promise<T> & {
+export type Deferred<T> = Promise<T> & {
     resolve: PromiseConstructor["resolve"];
     reject: PromiseConstructor["reject"];
 };

package/README.md

@@ -6,6 +6,7 @@ Libraries to encapsulate and re-export from here, the selection is based on:
 - [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)
@@ -34,6 +35,8 @@ anyway like [those of `yup`](https://github.com/jquense/yup/blob/master/package.
 - [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.d.ts

@@ -3,7 +3,7 @@
  *
  * @category text
  */
-export declare type AccentsSet = [string, string];
+export type AccentsSet = [string, string];
 /**
  * Accent sets
  *

package/areEqual.d.ts

@@ -0,0 +1,19 @@
+type ComparablePrimitive = string | number | boolean;
+type Comparable = ComparablePrimitive | object | Record<string, ComparablePrimitive> | Array<ComparablePrimitive>;
+/**
+ * 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 objects
+ */
+export declare function areEqual(a: Comparable, b?: Comparable): boolean;
+export default areEqual;

package/areEqual.js

@@ -0,0 +1,77 @@
+import { isArray } from "./isArray";
+import { isObject } from "./isObject";
+function areEqualArrays(a, b) {
+    if (!b)
+        return false;
+    if (a.length !== b.length)
+        return false;
+    for (var i = 0; i < a.length; i++) {
+        var aValue = a[i];
+        var bValue = b[i];
+        if (!areEqual(aValue, bValue))
+            return false;
+    }
+    return true;
+}
+function areEqualObjects(a, b) {
+    if (!b)
+        return false;
+    var aKeys = Object.keys(a);
+    var bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) {
+        return false;
+    }
+    for (var _i = 0, aKeys_1 = aKeys; _i < aKeys_1.length; _i++) {
+        var _key = aKeys_1[_i];
+        var key = _key;
+        var aValue = a[key];
+        var bValue = b[key];
+        if (!areEqual(aValue, bValue)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 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 objects
+ */
+export function areEqual(a, b) {
+    if (!a && !b) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return true;
+    }
+    // const t0 = performance.now();
+    if (!b && a !== b) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    var areObjects = isObject(a) && isObject(b);
+    if (areObjects && !areEqualObjects(a, b)) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    var areArrays = isArray(a) && isArray(b);
+    if (areArrays && !areEqualArrays(a, b)) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    if (!areObjects && !areArrays && a !== b) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    // console.log(`areEqual took ${performance.now() - t0} ms`);
+    return true;
+}
+export default areEqual;

package/cookie.d.ts

@@ -7,7 +7,7 @@
  * - [js-cookie](https://github.com/js-cookie/js-cookie)
  * - [cookie](https://github.com/jshttp/cookie)
  */
-declare type CookieAttributes = {
+type CookieAttributes = {
     /**
      * Define when the cookie will be removed. Value can be a Number
      * which will be interpreted as days from time of creation or a
@@ -41,13 +41,13 @@ declare type CookieAttributes = {
      */
     sameSite?: "strict" | "Strict" | "lax" | "Lax" | "none" | "None" | undefined;
 };
-export declare type CookieAttributesServer = CookieAttributes & {
+export type CookieAttributesServer = CookieAttributes & {
     maxAge?: number;
     httpOnly?: boolean;
     encode?: (input: string) => string;
     decode?: (input: string) => string;
 };
-export declare type CookieAttributesClient = CookieAttributes;
+export type CookieAttributesClient = CookieAttributes;
 export declare const defaultAttributesClient: {
     path: string;
 };

package/forin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * To easily get typed native `for in`
+ *
+ * @category objects
+ */
+export declare function forin<T>(object: T, cb: <K extends keyof T>(key: K, value: T[K]) => void): void;
+export default forin;

package/forin.js

@@ -0,0 +1,11 @@
+/**
+ * To easily get typed native `for in`
+ *
+ * @category objects
+ */
+export function forin(object, cb) {
+    for (var key in object) {
+        cb(key, object[key]);
+    }
+}
+export default forin;

package/getMediaQueryWidthResolvers.d.ts

@@ -1,4 +1,4 @@
-export declare type GetMediaQueryWidthResolversBreakpoints = Record<string, number>;
+export type GetMediaQueryWidthResolversBreakpoints = Record<string, number>;
 export declare function getMediaQueryWidthResolvers<TBreakpointsConfig extends GetMediaQueryWidthResolversBreakpoints>(customBreakpoints: TBreakpointsConfig): {
     max: (br: Extract<keyof TBreakpointsConfig, string>) => string;
     min: (br: Extract<keyof TBreakpointsConfig, string>) => string;

package/getType.d.ts

@@ -7,11 +7,11 @@
  * - `isInt`
  * - `isFloat`
  */
-export declare type AnyFunction = (...args: any[]) => any;
-export declare type AnyAsyncFunction = (...args: any[]) => Promise<any>;
-export declare type AnyClass = new (...args: any[]) => any;
-export declare type PlainObject = Record<string | number | symbol, any>;
-export declare type TypeGuard<A, B extends A> = (payload: A) => payload is B;
+export type AnyFunction = (...args: any[]) => any;
+export type AnyAsyncFunction = (...args: any[]) => Promise<any>;
+export type AnyClass = new (...args: any[]) => any;
+export type PlainObject = Record<string | number | symbol, any>;
+export type TypeGuard<A, B extends A> = (payload: A) => payload is B;
 /**
  * Returns the object type of the given payload
  *

package/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./accentSets";
 export * from "./addOrReplaceAtIdx";
+export * from "./areEqual";
 export * from "./arrayOfAll";
 export * from "./arraySum";
 export * from "./arrayToLookup";
@@ -21,6 +22,7 @@ export * from "./Emitter";
 export * from "./encode";
 export * from "./ensureInt";
 export * from "./findDuplicatedIndexes";
+export * from "./forin";
 export * from "./gbToBytes";
 export * from "./getEmptyArray";
 export * from "./getKeys";
@@ -86,12 +88,14 @@ export * from "./mbToBytes";
 export * from "./mergeObjects";
 export * from "./mergeUrlQueryParams";
 export * from "./moveSortableArrayItemByKey";
+export * from "./noop";
 export * from "./normaliseUrlPathname";
 export * from "./normaliseUrl";
 export * from "./objectPick";
 export * from "./objectOmit";
 export * from "./parseCookie";
 export * from "./parseURL";
+export * from "./quaranteneProps";
 export * from "./randomInt";
 export * from "./randomKey";
 export * from "./readCookie";
@@ -120,5 +124,6 @@ export * from "./updateLinkParams";
 export * from "./updateUrlQueryParams";
 export * from "./uppercase";
 export * from "./uuid";
+export * from "./uuidNumeric";
 export * from "./wait";
 export type { Primitive, Class, Constructor, TypedArray, Observer, ObservableLike, Except, Writable, Merge, MergeDeep, MergeExclusive, RequireAtLeastOne, RequireExactlyOne, RequireAllOrNone, RemoveIndexSignature, PartialDeep, ReadonlyDeep, LiteralUnion, Opaque, InvariantOf, SetOptional, SetRequired, ValueOf, ConditionalKeys, ConditionalPick, ConditionalExcept, UnionToIntersection, LiteralToPrimitive, Stringified, IterableElement, Entry, Exact, Entries, SetReturnType, Simplify, Get, StringKeyOf, Schema, Jsonify, JsonPrimitive, JsonObject, JsonArray, JsonValue, Promisable, AsyncReturnType, Asyncify, Trim, Split, Includes, Join, LastArrayElement, FixedLengthArray, MultidimensionalArray, MultidimensionalReadonlyArray, PositiveInfinity, NegativeInfinity, Finite, Integer, Float, NegativeFloat, Negative, NonNegative, NegativeInteger, NonNegativeInteger, CamelCase, CamelCasedProperties, CamelCasedPropertiesDeep, KebabCase, KebabCasedProperties, KebabCasedPropertiesDeep, PascalCase, PascalCasedProperties, PascalCasedPropertiesDeep, SnakeCase, SnakeCasedProperties, SnakeCasedPropertiesDeep, ScreamingSnakeCase, DelimiterCase, DelimiterCasedProperties, DelimiterCasedPropertiesDeep, PackageJson, TsConfigJson, SetNonNullable, Spread, PartialOnUndefinedDeep, OptionalKeysOf, HasOptionalKeys, RequiredKeysOf, HasRequiredKeys, UnwrapOpaque, EmptyObject, IsEmptyObject, TupleToUnion, OmitIndexSignature, PickIndexSignature, ConditionalPickDeep, } from "type-fest";

package/index.js

@@ -1,5 +1,6 @@
 export * from "./accentSets";
 export * from "./addOrReplaceAtIdx";
+export * from "./areEqual";
 export * from "./arrayOfAll";
 export * from "./arraySum";
 export * from "./arrayToLookup";
@@ -22,6 +23,7 @@ export * from "./encode";
 export * from "./ensureInt";
 // export * from "./env"
 export * from "./findDuplicatedIndexes";
+export * from "./forin";
 export * from "./gbToBytes";
 export * from "./getEmptyArray";
 export * from "./getKeys";
@@ -87,12 +89,14 @@ export * from "./mbToBytes";
 export * from "./mergeObjects";
 export * from "./mergeUrlQueryParams";
 export * from "./moveSortableArrayItemByKey";
+export * from "./noop";
 export * from "./normaliseUrlPathname";
 export * from "./normaliseUrl";
 export * from "./objectPick";
 export * from "./objectOmit";
 export * from "./parseCookie";
 export * from "./parseURL";
+export * from "./quaranteneProps";
 export * from "./randomInt";
 export * from "./randomKey";
 export * from "./readCookie";
@@ -122,4 +126,5 @@ export * from "./updateLinkParams";
 export * from "./updateUrlQueryParams";
 export * from "./uppercase";
 export * from "./uuid";
+export * from "./uuidNumeric";
 export * from "./wait";

package/location.d.ts

@@ -1,4 +1,4 @@
 /**
  * @category location
  */
-export declare type AnyQueryParams = undefined | null | Record<string | number, unknown>;
+export type AnyQueryParams = undefined | null | Record<string | number, unknown>;

package/matchSorter.d.ts

@@ -1,4 +1,4 @@
-declare type KeyAttributes = {
+type KeyAttributes = {
     threshold?: Ranking;
     maxRanking: Ranking;
     minRanking: Ranking;
@@ -30,7 +30,7 @@ interface KeyAttributesOptions<ItemType> {
     maxRanking?: Ranking;
     minRanking?: Ranking;
 }
-declare type KeyOption<ItemType> = KeyAttributesOptions<ItemType> | ValueGetterKey<ItemType> | string;
+type KeyOption<ItemType> = KeyAttributesOptions<ItemType> | ValueGetterKey<ItemType> | string;
 interface MatchSorterOptions<ItemType = unknown> {
     keys?: ReadonlyArray<KeyOption<ItemType>>;
     threshold?: Ranking;
@@ -46,7 +46,7 @@ declare const RANKING_CONTAINS = 3;
 declare const RANKING_ACRONYM = 2;
 declare const RANKING_MATCHES = 1;
 declare const RANKING_NO_MATCH = 0;
-declare type Ranking = typeof RANKING_CASE_SENSITIVE_EQUAL | typeof RANKING_EQUAL | typeof RANKING_STARTS_WITH | typeof RANKING_WORD_STARTS_WITH | typeof RANKING_CONTAINS | typeof RANKING_ACRONYM | typeof RANKING_MATCHES | typeof RANKING_NO_MATCH;
+type Ranking = typeof RANKING_CASE_SENSITIVE_EQUAL | typeof RANKING_EQUAL | typeof RANKING_STARTS_WITH | typeof RANKING_WORD_STARTS_WITH | typeof RANKING_CONTAINS | typeof RANKING_ACRONYM | typeof RANKING_MATCHES | typeof RANKING_NO_MATCH;
 declare const defaultBaseSortFn: BaseSorter<unknown>;
 /**
  * Takes an array of items and a value and returns a new array with the items that match the given value

package/node/areEqual.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.areEqual = void 0;
+var isArray_1 = require("./isArray");
+var isObject_1 = require("./isObject");
+function areEqualArrays(a, b) {
+    if (!b)
+        return false;
+    if (a.length !== b.length)
+        return false;
+    for (var i = 0; i < a.length; i++) {
+        var aValue = a[i];
+        var bValue = b[i];
+        if (!areEqual(aValue, bValue))
+            return false;
+    }
+    return true;
+}
+function areEqualObjects(a, b) {
+    if (!b)
+        return false;
+    var aKeys = Object.keys(a);
+    var bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) {
+        return false;
+    }
+    for (var _i = 0, aKeys_1 = aKeys; _i < aKeys_1.length; _i++) {
+        var _key = aKeys_1[_i];
+        var key = _key;
+        var aValue = a[key];
+        var bValue = b[key];
+        if (!areEqual(aValue, bValue)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 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 objects
+ */
+function areEqual(a, b) {
+    if (!a && !b) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return true;
+    }
+    // const t0 = performance.now();
+    if (!b && a !== b) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    var areObjects = (0, isObject_1.isObject)(a) && (0, isObject_1.isObject)(b);
+    if (areObjects && !areEqualObjects(a, b)) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    var areArrays = (0, isArray_1.isArray)(a) && (0, isArray_1.isArray)(b);
+    if (areArrays && !areEqualArrays(a, b)) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    if (!areObjects && !areArrays && a !== b) {
+        // console.log(`areEqual took ${performance.now() - t0} ms`);
+        return false;
+    }
+    // console.log(`areEqual took ${performance.now() - t0} ms`);
+    return true;
+}
+exports.areEqual = areEqual;
+exports.default = areEqual;

package/node/forin.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forin = void 0;
+/**
+ * To easily get typed native `for in`
+ *
+ * @category objects
+ */
+function forin(object, cb) {
+    for (var key in object) {
+        cb(key, object[key]);
+    }
+}
+exports.forin = forin;
+exports.default = forin;

package/node/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./accentSets"), exports);
 tslib_1.__exportStar(require("./addOrReplaceAtIdx"), exports);
+tslib_1.__exportStar(require("./areEqual"), exports);
 tslib_1.__exportStar(require("./arrayOfAll"), exports);
 tslib_1.__exportStar(require("./arraySum"), exports);
 tslib_1.__exportStar(require("./arrayToLookup"), exports);
@@ -25,6 +26,7 @@ tslib_1.__exportStar(require("./encode"), exports);
 tslib_1.__exportStar(require("./ensureInt"), exports);
 // export * from "./env"
 tslib_1.__exportStar(require("./findDuplicatedIndexes"), exports);
+tslib_1.__exportStar(require("./forin"), exports);
 tslib_1.__exportStar(require("./gbToBytes"), exports);
 tslib_1.__exportStar(require("./getEmptyArray"), exports);
 tslib_1.__exportStar(require("./getKeys"), exports);
@@ -90,12 +92,14 @@ tslib_1.__exportStar(require("./mbToBytes"), exports);
 tslib_1.__exportStar(require("./mergeObjects"), exports);
 tslib_1.__exportStar(require("./mergeUrlQueryParams"), exports);
 tslib_1.__exportStar(require("./moveSortableArrayItemByKey"), exports);
+tslib_1.__exportStar(require("./noop"), exports);
 tslib_1.__exportStar(require("./normaliseUrlPathname"), exports);
 tslib_1.__exportStar(require("./normaliseUrl"), exports);
 tslib_1.__exportStar(require("./objectPick"), exports);
 tslib_1.__exportStar(require("./objectOmit"), exports);
 tslib_1.__exportStar(require("./parseCookie"), exports);
 tslib_1.__exportStar(require("./parseURL"), exports);
+tslib_1.__exportStar(require("./quaranteneProps"), exports);
 tslib_1.__exportStar(require("./randomInt"), exports);
 tslib_1.__exportStar(require("./randomKey"), exports);
 tslib_1.__exportStar(require("./readCookie"), exports);
@@ -125,4 +129,5 @@ tslib_1.__exportStar(require("./updateLinkParams"), exports);
 tslib_1.__exportStar(require("./updateUrlQueryParams"), exports);
 tslib_1.__exportStar(require("./uppercase"), exports);
 tslib_1.__exportStar(require("./uuid"), exports);
+tslib_1.__exportStar(require("./uuidNumeric"), exports);
 tslib_1.__exportStar(require("./wait"), exports);

package/node/noop.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noop = void 0;
+/**
+ * No operation function
+ *
+ * @category native
+ */
+var noop = function () { return void 0; };
+exports.noop = noop;
+exports.default = exports.noop;

package/node/quaranteneProps.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quaranteneProps = void 0;
+/**
+ * @category impl
+ * @usage
+ *
+ * ```ts
+ * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
+ *   "onPointerLeave",
+ *   "onPointerMove",
+ *   "onClick",
+ *   "onPointerDown",
+ *   "onPointerUp",
+ *   "onKeyDown",
+ * ]);
+ * ```
+ */
+function quaranteneProps(props, propsKeysToQuarantene) {
+    // approach 1)
+    var healthyProps = {
+        _: {},
+    };
+    for (var key in props) {
+        var prop = props[key];
+        if (propsKeysToQuarantene.includes(key)) {
+            healthyProps._[key] = prop;
+        }
+        else {
+            // @ts-expect-error nevermind
+            healthyProps[key] = prop;
+        }
+    }
+    return healthyProps;
+}
+exports.quaranteneProps = quaranteneProps;
+exports.default = quaranteneProps;

package/node/uuidNumeric.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidNumeric = void 0;
+/**
+ * @category uid
+ * @see https://stackoverflow.com/a/18048162/1938970
+ */
+var uuidNumeric = function () { return new Date().valueOf(); };
+exports.uuidNumeric = uuidNumeric;
+exports.default = exports.uuidNumeric;

package/noop.d.ts

@@ -0,0 +1,7 @@
+/**
+ * No operation function
+ *
+ * @category native
+ */
+export declare const noop: () => undefined;
+export default noop;

package/noop.js

@@ -0,0 +1,7 @@
+/**
+ * No operation function
+ *
+ * @category native
+ */
+export var noop = function () { return void 0; };
+export default noop;

package/package.json

@@ -2,13 +2,13 @@
   "name": "@koine/utils",
   "sideEffects": false,
   "main": "./node/index.js",
-  "typings": "./index.d.ts",
-  "dependencies": {
-    "ts-debounce": "^4.0.0",
-    "tslib": "^2.4.0"
+  "types": "./index.d.ts",
+  "dependencies": {},
+  "peerDependencies": {
+    "ts-debounce": "4.0.0",
+    "type-fest": "3.5.3",
+    "tslib": "2.5.0"
   },
-  "peerDependencies": {},
-  "version": "1.0.105",
-  "module": "./index.js",
-  "types": "./index.d.ts"
+  "version": "1.1.0",
+  "module": "./index.js"
 }

package/quaranteneProps.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @category impl
+ * @usage
+ *
+ * ```ts
+ * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
+ *   "onPointerLeave",
+ *   "onPointerMove",
+ *   "onClick",
+ *   "onPointerDown",
+ *   "onPointerUp",
+ *   "onKeyDown",
+ * ]);
+ * ```
+ */
+export declare function quaranteneProps<TProps extends Record<never, never>, TSupectPropsKeys extends QuaranteneProps<TProps>>(props: TProps, propsKeysToQuarantene: TSupectPropsKeys): Omit<TProps, TSupectPropsKeys[number]> & {
+    _: Pick<TProps, TSupectPropsKeys[number]>;
+};
+export default quaranteneProps;
+type QuaranteneProps<TProps extends Record<never, never>> = readonly (keyof {
+    [K in keyof TProps]?: TProps[K];
+})[];

package/quaranteneProps.js

@@ -0,0 +1,33 @@
+/**
+ * @category impl
+ * @usage
+ *
+ * ```ts
+ * const { _: { onKeyDown }, myOwnProp, ...rest } = quaranteneProps([
+ *   "onPointerLeave",
+ *   "onPointerMove",
+ *   "onClick",
+ *   "onPointerDown",
+ *   "onPointerUp",
+ *   "onKeyDown",
+ * ]);
+ * ```
+ */
+export function quaranteneProps(props, propsKeysToQuarantene) {
+    // approach 1)
+    var healthyProps = {
+        _: {},
+    };
+    for (var key in props) {
+        var prop = props[key];
+        if (propsKeysToQuarantene.includes(key)) {
+            healthyProps._[key] = prop;
+        }
+        else {
+            // @ts-expect-error nevermind
+            healthyProps[key] = prop;
+        }
+    }
+    return healthyProps;
+}
+export default quaranteneProps;

package/uuidNumeric.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @category uid
+ * @see https://stackoverflow.com/a/18048162/1938970
+ */
+export declare const uuidNumeric: () => number;
+export default uuidNumeric;

package/uuidNumeric.js

@@ -0,0 +1,6 @@
+/**
+ * @category uid
+ * @see https://stackoverflow.com/a/18048162/1938970
+ */
+export var uuidNumeric = function () { return new Date().valueOf(); };
+export default uuidNumeric;

package/createStorage.d.ts

@@ -1,53 +0,0 @@
-export declare type CreateStorageConfig = Record<string, any>;
-/**
- * Utility to create a storage instance to interact with `localStorage` using
- * encrypted (encoded) key/values.
- */
-export declare const createStorage: <T extends CreateStorageConfig>(config: Partial<T>) => {
-    /**
-     * Get all storage value (it uses `localStorage.get()`).
-     *
-     * Unparseable values with `JSON.parse()` return their value as it is.
-     * If the given `key` argument is not found `null` is returned.
-     */
-    get<TKey extends keyof T>(key: TKey): T[TKey] | null;
-    /**
-     * Get all storage values (it uses `localStorage.get()`).
-     *
-     * `undefined` and `null` values are not returned.
-     */
-    getAll(): T;
-    /**
-     * Set a storage value (it uses `localStorage.set()`).
-     *
-     * Non-string values are stringified with `JSON.stringify()`
-     */
-    set<TKey_1 extends keyof T>(key: TKey_1, value: T[TKey_1]): void;
-    /**
-     * Set all given storage values (it uses `localStorage.set()`).
-     *
-     * Non-string values are stringified with `JSON.stringify()`, `undefined`
-     * and `null` values are removed from the storage
-     */
-    setMany(newValues: Partial<T>): void;
-    /**
-     * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
-     */
-    has<TKey_2 extends keyof T>(key: TKey_2): boolean;
-    /**
-     * Remove a storage value (it uses `localStorage.remove()`).
-     */
-    remove<TKey_3 extends keyof T>(key: TKey_3): void;
-    /**
-     * Clear all storage values (it uses `localStorage.remove()`).
-     */
-    clear(): void;
-    /**
-     * Watch a storage value changes, this needs to be executed only in browser
-     * context (it uses `window.addEventListener("storage")`).
-     *
-     * Inspiration from [Multi Tab Logout in React — Redux](https://medium.com/front-end-weekly/multi-tab-logout-in-react-redux-4715f071c7fa)
-     */
-    watch: <TKey_4 extends keyof T>(keyToWatch: TKey_4, onRemoved?: () => void, onAdded?: () => void) => () => void;
-};
-export default createStorage;

package/createStorage.js

@@ -1,137 +0,0 @@
-import { __assign } from "tslib";
-import { decode } from "./decode";
-import { encode } from "./encode";
-import { isBrowser } from "./isBrowser";
-import { isNullOrUndefined } from "./isNullOrUndefined";
-import { isString } from "./isString";
-/**
- * Utility to create a storage instance to interact with `localStorage` using
- * encrypted (encoded) key/values.
- */
-export var createStorage = function (config) {
-    var methodsMap = { g: "getItem", s: "setItem", r: "removeItem" };
-    /**
-     * Super minifiable localStorage wrapper with SSR safety
-     */
-    var ls = function (method, key, value) {
-        return isBrowser
-            ? localStorage[methodsMap[method]](key, value)
-            : function () {
-                if (process.env["NODE_ENV"] !== "production") {
-                    console.warn("[@koine/utils] createStorage: localStorage does not exists in this environment.");
-                }
-            };
-    };
-    var keys = Object.keys(config).reduce(function (map, key) {
-        var _a;
-        return (__assign(__assign({}, map), (_a = {}, _a[key] = encode(key), _a)));
-    }, {});
-    return {
-        /**
-         * Get all storage value (it uses `localStorage.get()`).
-         *
-         * Unparseable values with `JSON.parse()` return their value as it is.
-         * If the given `key` argument is not found `null` is returned.
-         */
-        get: function (key) {
-            var stored = ls("g", keys[key]);
-            if (stored) {
-                stored = decode(stored);
-                try {
-                    return JSON.parse(stored);
-                }
-                catch (_e) {
-                    return stored;
-                }
-            }
-            return null;
-        },
-        /**
-         * Get all storage values (it uses `localStorage.get()`).
-         *
-         * `undefined` and `null` values are not returned.
-         */
-        getAll: function () {
-            var all = {};
-            for (var key in keys) {
-                var value = this.get(key);
-                if (!isNullOrUndefined(value)) {
-                    all[key] = value;
-                }
-            }
-            return all;
-        },
-        /**
-         * Set a storage value (it uses `localStorage.set()`).
-         *
-         * Non-string values are stringified with `JSON.stringify()`
-         */
-        set: function (key, value) {
-            ls("s", keys[key], isString(value) ? encode(value) : encode(JSON.stringify(value)));
-        },
-        /**
-         * Set all given storage values (it uses `localStorage.set()`).
-         *
-         * Non-string values are stringified with `JSON.stringify()`, `undefined`
-         * and `null` values are removed from the storage
-         */
-        setMany: function (newValues) {
-            for (var key in newValues) {
-                var value = newValues[key];
-                if (!isNullOrUndefined(value)) {
-                    this.set(key, value);
-                }
-                else {
-                    this.remove(key);
-                }
-            }
-        },
-        /**
-         * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
-         */
-        has: function (key) {
-            var stored = ls("g", keys[key]);
-            return !!stored;
-        },
-        /**
-         * Remove a storage value (it uses `localStorage.remove()`).
-         */
-        remove: function (key) {
-            ls("r", keys[key]);
-        },
-        /**
-         * Clear all storage values (it uses `localStorage.remove()`).
-         */
-        clear: function () {
-            for (var key in keys) {
-                ls("r", keys[key]);
-            }
-        },
-        /**
-         * Watch a storage value changes, this needs to be executed only in browser
-         * context (it uses `window.addEventListener("storage")`).
-         *
-         * Inspiration from [Multi Tab Logout in React — Redux](https://medium.com/front-end-weekly/multi-tab-logout-in-react-redux-4715f071c7fa)
-         */
-        watch: function (keyToWatch, onRemoved, onAdded) {
-            var handler = function (event) {
-                var key = event.key, oldValue = event.oldValue, newValue = event.newValue;
-                if (key === keys[keyToWatch]) {
-                    if (oldValue && !newValue) {
-                        onRemoved === null || onRemoved === void 0 ? void 0 : onRemoved();
-                    }
-                    else if (!oldValue && newValue) {
-                        onAdded === null || onAdded === void 0 ? void 0 : onAdded();
-                    }
-                }
-            };
-            if (!isBrowser)
-                return function () { return void 0; };
-            window.addEventListener("storage", handler);
-            return function () {
-                window.removeEventListener("storage", handler);
-            };
-        },
-    };
-};
-export default createStorage;

package/getZonedDate.d.ts

@@ -1,16 +0,0 @@
-/**
- * It returns a `Date` object from a date `string` adjusted on the user timeZone,
- * if a timeZone is not provided we try getting it from the `Intl` browwser native
- * API. It gracefully falls back returning a _non-timezone-based_ `Date`.
- *
- * @category date
- *
- * @resources
- * - to get the timeZone client side see [this article](https://attacomsian.com/blog/javascript-current-timezone)
- * - for converting the date based on the time zone [date-fns docs](https://date-fns.org/v2.27.0/docs/Time-Zones) and [date-fns-tz docs](https://github.com/marnusw/date-fns-tz)
- *
- * @param dateString A parseable date as string, `Z` is automatically suffixed if not present to correctly get time zone based time from a UTC date.
- * @param timeZone Optionally pass a timeZone (e.g. from user preference or from the server), it falls back trying to read it from the `Intl` browwser native API.
- */
-export declare function getZonedDate(dateString?: string, timeZone?: string): Date;
-export default getZonedDate;

package/getZonedDate.js

@@ -1,37 +0,0 @@
-import utcToZonedTime from "date-fns-tz/utcToZonedTime";
-import isBrowser from "./isBrowser";
-/**
- * It returns a `Date` object from a date `string` adjusted on the user timeZone,
- * if a timeZone is not provided we try getting it from the `Intl` browwser native
- * API. It gracefully falls back returning a _non-timezone-based_ `Date`.
- *
- * @category date
- *
- * @resources
- * - to get the timeZone client side see [this article](https://attacomsian.com/blog/javascript-current-timezone)
- * - for converting the date based on the time zone [date-fns docs](https://date-fns.org/v2.27.0/docs/Time-Zones) and [date-fns-tz docs](https://github.com/marnusw/date-fns-tz)
- *
- * @param dateString A parseable date as string, `Z` is automatically suffixed if not present to correctly get time zone based time from a UTC date.
- * @param timeZone Optionally pass a timeZone (e.g. from user preference or from the server), it falls back trying to read it from the `Intl` browwser native API.
- */
-export function getZonedDate(dateString, timeZone) {
-    if (dateString === void 0) { dateString = ""; }
-    if (!dateString.endsWith("Z"))
-        dateString += "Z";
-    if (!timeZone && isBrowser) {
-        try {
-            timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        }
-        catch (e) {
-            if (process.env["NODE_ENV"] !== "production") {
-                console.warn("[@koine/utils:getZonedDate] failed reading timeZone, error", e);
-            }
-            // no need to do anything here, it just means `Intl` failed, probably
-            // because the browser does not support it
-        }
-    }
-    return timeZone
-        ? utcToZonedTime(new Date(dateString), timeZone)
-        : new Date(dateString);
-}
-export default getZonedDate;

package/isIE.d.ts

@@ -1,7 +0,0 @@
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/21712356/12285349
- */
-export declare function isIE(ssrValue?: boolean): boolean;
-export default isIE;

package/isIE.js

@@ -1,18 +0,0 @@
-import { isServer } from "./isServer";
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/21712356/12285349
- */
-export function isIE(ssrValue) {
-    if (ssrValue === void 0) { ssrValue = true; }
-    if (isServer) {
-        return ssrValue;
-    }
-    var ua = window.navigator.userAgent;
-    if (ua.indexOf("MSIE ") > 0 || ua.indexOf("Trident/") > 0) {
-        return true;
-    }
-    return false;
-}
-export default isIE;

package/isMobile.d.ts

@@ -1,7 +0,0 @@
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/3540295
- */
-export declare function isMobile(ssrValue?: boolean): boolean;
-export default isMobile;

package/isMobile.js

@@ -1,16 +0,0 @@
-import { isServer } from "./isServer";
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/3540295
- */
-export function isMobile(ssrValue) {
-    if (ssrValue === void 0) { ssrValue = true; }
-    if (isServer) {
-        return ssrValue;
-    }
-    return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
-    // return /(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|ipad|iris|kindle|Android|Silk|lge |maemo|midp|mmp|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows (ce|phone)|xda|xiino/i.test(navigator.userAgent)
-    //   || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(navigator.userAgent.substr(0,4)
-}
-export default isMobile;

package/navigateToHash.d.ts

@@ -1,8 +0,0 @@
-/**
- * It updates the browser's location hash by replacing the history state.
- * The non-silent standard way would simply be `location.hash = "#new-hash"`
- *
- * @category location
- */
-export declare function navigateToHash(hash?: string): void;
-export default navigateToHash;

package/navigateToHash.js

@@ -1,12 +0,0 @@
-/**
- * It updates the browser's location hash by replacing the history state.
- * The non-silent standard way would simply be `location.hash = "#new-hash"`
- *
- * @category location
- */
-export function navigateToHash(hash) {
-    if (hash === void 0) { hash = ""; }
-    var pathname = location.pathname, search = location.search;
-    history.replaceState(null, "", pathname + (search ? "?" + search : "") + "#" + hash);
-}
-export default navigateToHash;

package/navigateToHashParams.d.ts

@@ -1,9 +0,0 @@
-import { type AnyQueryParams } from "./location";
-/**
- * It updates the `location.hash` with the given query params, it uses `location.hash`
- * if a second argument `hash` is not provded
- *
- * @category location
- */
-export declare function navigateToHashParams(params?: string | AnyQueryParams, hash?: string): string;
-export default navigateToHashParams;

package/navigateToHashParams.js

@@ -1,22 +0,0 @@
-import buildUrlQueryString from "./buildUrlQueryString";
-import getUrlHashPathname from "./getUrlHashPathname";
-/**
- * It updates the `location.hash` with the given query params, it uses `location.hash`
- * if a second argument `hash` is not provded
- *
- * @category location
- */
-export function navigateToHashParams(params, hash) {
-    if (params === void 0) { params = {}; }
-    if (hash === void 0) { hash = ""; }
-    var useLocation = !hash;
-    hash = hash || location.hash;
-    var hashQueryLess = getUrlHashPathname(hash);
-    var queryString = typeof params === "string" ? params : buildUrlQueryString(params);
-    var newHash = "#/" + hashQueryLess + queryString;
-    if (useLocation) {
-        location.hash = newHash;
-    }
-    return newHash;
-}
-export default navigateToHashParams;

package/navigateToMergedHashParams.d.ts

@@ -1,8 +0,0 @@
-import { type AnyQueryParams } from "./location";
-/**
- * It updates the "query params" within the `location.hash`, it uses `location`
- *
- * @category location
- */
-export declare function navigateToMergedHashParams(params?: NonNullable<AnyQueryParams>, hash?: string): string;
-export default navigateToMergedHashParams;

package/navigateToMergedHashParams.js

@@ -1,14 +0,0 @@
-import getUrlHashParams from "./getUrlHashParams";
-import mergeUrlQueryParams from "./mergeUrlQueryParams";
-import navigateToHashParams from "./navigateToHashParams";
-/**
- * It updates the "query params" within the `location.hash`, it uses `location`
- *
- * @category location
- */
-export function navigateToMergedHashParams(params, hash) {
-    if (params === void 0) { params = {}; }
-    if (hash === void 0) { hash = ""; }
-    return navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(hash), params), hash);
-}
-export default navigateToMergedHashParams;

package/navigateToMergedParams.d.ts

@@ -1,9 +0,0 @@
-import { type AnyQueryParams } from "./location";
-/**
- * Merge current URL query parameters with the given ones, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- */
-export declare function navigateToMergedParams(params?: NonNullable<AnyQueryParams>, replace?: boolean): string;
-export default navigateToMergedParams;

package/navigateToMergedParams.js

@@ -1,14 +0,0 @@
-import getUrlQueryParams from "./getUrlQueryParams";
-import mergeUrlQueryParams from "./mergeUrlQueryParams";
-import navigateToParams from "./navigateToParams";
-/**
- * Merge current URL query parameters with the given ones, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- */
-export function navigateToMergedParams(params, replace) {
-    if (params === void 0) { params = {}; }
-    return navigateToParams(mergeUrlQueryParams(getUrlQueryParams(), params), replace);
-}
-export default navigateToMergedParams;

package/navigateToParams.d.ts

@@ -1,10 +0,0 @@
-import { type AnyQueryParams } from "./location";
-/**
- * Change current URL query parameters, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- * @returns The query string with initial `?`
- */
-export declare function navigateToParams(params?: string | AnyQueryParams, replace?: boolean): string;
-export default navigateToParams;

package/navigateToParams.js

@@ -1,18 +0,0 @@
-import buildUrlQueryString from "./buildUrlQueryString";
-import isBrowser from "./isBrowser";
-/**
- * Change current URL query parameters, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- * @returns The query string with initial `?`
- */
-export function navigateToParams(params, replace) {
-    if (params === void 0) { params = {}; }
-    var queryString = typeof params === "string" ? params : buildUrlQueryString(params);
-    if (isBrowser) {
-        history[replace ? "replaceState" : "pushState"](null, "", location.pathname + queryString);
-    }
-    return queryString;
-}
-export default navigateToParams;

package/navigateWithoutUrlParam.d.ts

@@ -1,8 +0,0 @@
-/**
- * Remove URL query parameter, it uses `history`
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- */
-export declare function navigateWithoutUrlParam(paramName?: string, replace?: boolean): string;
-export default navigateWithoutUrlParam;

package/navigateWithoutUrlParam.js

@@ -1,19 +0,0 @@
-import getUrlQueryParams from "./getUrlQueryParams";
-import navigateToParams from "./navigateToParams";
-/**
- * Remove URL query parameter, it uses `history`
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- */
-export function navigateWithoutUrlParam(paramName, replace) {
-    var params = {};
-    var currentParams = getUrlQueryParams();
-    for (var key in currentParams) {
-        if (key !== paramName) {
-            params[key] = currentParams[key];
-        }
-    }
-    return navigateToParams(params, replace);
-}
-export default navigateWithoutUrlParam;

package/pageview.d.ts

@@ -1,9 +0,0 @@
-export declare type GtmPageviewArgs = [
-    page_path?: string,
-    page_title?: string,
-    page_location?: string
-];
-/**
- * @category analytics-google
- */
-export declare const pageview: (page_path?: string | undefined, page_title?: string | undefined, page_location?: string | undefined) => void;

package/pageview.js

@@ -1,29 +0,0 @@
-import isUndefined from "./isUndefined";
-/**
- * @category analytics-google
- */
-export var pageview = function () {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    if (!isUndefined(window) && !isUndefined(window.gtag)) {
-        window.gtag("event", "page_view", {
-            page_path: args[0] || location.pathname,
-            page_title: args[1] || document.title,
-            page_location: args[2] || location.href,
-            // send_to: '<GA_MEASUREMENT_ID>'
-        });
-    }
-};
-// export type GtmEventArgs = [
-//   eventCategory?: string,
-//   eventAction?: string,
-//   eventLabel?: string,
-//   eventValue?: string
-// ];
-// export const event = (...args: GtmEventArgs) => {
-//   if (!isUndefined(window) && !isUndefined(window.gtag)) {
-//     window.gtag("send", "event", ...args);
-//   }
-// };

package/redirectTo.d.ts

@@ -1,9 +0,0 @@
-import { type AnyQueryParams } from "./location";
-/**
- * Redirect to url with params {optionally}, removes eventual trailing question
- * marks from the given URL, it uses `location`
- *
- * @category location
- */
-export declare function redirectTo(url: string, params?: AnyQueryParams): void;
-export default redirectTo;

package/redirectTo.js

@@ -1,15 +0,0 @@
-import buildUrlQueryString from "./buildUrlQueryString";
-import isBrowser from "./isBrowser";
-/**
- * Redirect to url with params {optionally}, removes eventual trailing question
- * marks from the given URL, it uses `location`
- *
- * @category location
- */
-export function redirectTo(url, params) {
-    if (isBrowser) {
-        var queryString = buildUrlQueryString(params);
-        location.href = url.replace(/\?+$/g, "") + queryString;
-    }
-}
-export default redirectTo;