@stryke/helpers 0.1.0

package/dist/get-ordered-by.d.ts

@@ -0,0 +1,36 @@
+type Order = "asc" | "desc";
+/**
+ * Sorts an array of objects based on multiple properties and their corresponding order directions.
+ *
+ * @remarks
+ * This function takes an array of objects, an array of keys to sort by, and an array of order directions.
+ * It returns the sorted array, ordering by each key according to its corresponding direction
+ * ('asc' for ascending or 'desc' for descending). If values for a key are equal,
+ * it moves to the next key to determine the order.
+ *
+ * @example
+ * ```typescript
+ * // Sort an array of objects by 'user' in ascending order and 'age' in descending order.
+ * const users = [
+ *   { user: 'fred', age: 48 },
+ *   { user: 'barney', age: 34 },
+ *   { user: 'fred', age: 40 },
+ *   { user: 'barney', age: 36 },
+ * ];
+ * const result = orderBy(users, ['user', 'age'], ['asc', 'desc']);
+ * // result will be:
+ * // [
+ * //   { user: 'barney', age: 36 },
+ * //   { user: 'barney', age: 34 },
+ * //   { user: 'fred', age: 48 },
+ * //   { user: 'fred', age: 40 },
+ * // ]
+ * ```
+ *
+ * @param collection - The array of objects to be sorted.
+ * @param keys - An array of keys (properties) by which to sort.
+ * @param orders - An array of order directions ('asc' for ascending or 'desc' for descending).
+ * @returns The sorted array.
+ */
+export declare function getOrderedBy<T>(collection: T[], keys: (keyof T)[], orders: Order[]): T[];
+export {};

package/dist/get-ordered-by.mjs

@@ -0,0 +1 @@
+export function getOrderedBy(f,n,o){const u=(r,e,t)=>r<e?t==="asc"?-1:1:r>e?t==="asc"?1:-1:0,T=n.map((r,e)=>o[e]??o.at(-1));return[...f].sort((r,e)=>{for(const[t,c]of n.entries()){const i=T[t],s=u(r[c],e[c],i);if(s!==0)return s}return 0})}

package/dist/get-unique.cjs

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getUnique = void 0;
+exports.getUniqueBy = getUniqueBy;
+const getUnique = e => [...new Set(e)];
+exports.getUnique = getUnique;
+function getUniqueBy(e, r) {
+  const t = new Map();
+  for (const n of e) {
+    const o = r(n);
+    t.has(o) || t.set(o, n);
+  }
+  return [...t.values()];
+}

package/dist/get-unique.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Returns an array of unique values from the given array.
+ *
+ * @param arr - The array to get unique values from.
+ * @returns An array of unique values.
+ */
+export declare const getUnique: <T = any>(arr: T[]) => T[];
+/**
+ * Returns a new array containing only the unique elements from the original array,
+ * based on the values returned by the mapper function.
+ *
+ * @example
+ * ```ts
+ * uniqBy([1.2, 1.5, 2.1, 3.2, 5.7, 5.3, 7.19], Math.floor);
+ * // [1.2, 2.1, 3.2, 5.7, 7.19]
+ * ```
+ *
+ * @param arr - The array to process.
+ * @param mapper - The function used to convert the array elements.
+ * @returns A new array containing only the unique elements from the original array, based on the values returned by the mapper function.
+ */
+export declare function getUniqueBy<T, U>(arr: readonly T[], mapper: (item: T) => U): T[];

package/dist/get-unique.mjs

@@ -0,0 +1 @@
+export const getUnique=e=>[...new Set(e)];export function getUniqueBy(e,r){const t=new Map;for(const n of e){const o=r(n);t.has(o)||t.set(o,n)}return[...t.values()]}

package/dist/identity.cjs

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.identity = identity;
+function identity(t) {
+  return t;
+}

package/dist/identity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns the input value unchanged.
+ *
+ * @example
+ * ```ts
+ * identity(5); // Returns 5
+ * identity('hello'); // Returns 'hello'
+ * identity({ key: 'value' }); // Returns { key: 'value' }
+ * ```
+ *
+ * @template T - The type of the input value.
+ * @param x - The value to be returned.
+ * @returns The input value.
+ */
+export declare function identity<T>(x: T): T;

package/dist/identity.mjs

@@ -0,0 +1 @@
+export function identity(t){return t}

package/dist/index.cjs

@@ -0,0 +1,280 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _argIdentity = require("./arg-identity.cjs");
+Object.keys(_argIdentity).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _argIdentity[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _argIdentity[key];
+    }
+  });
+});
+var _debounce = require("./debounce.cjs");
+Object.keys(_debounce).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _debounce[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _debounce[key];
+    }
+  });
+});
+var _deepClone = require("./deep-clone.cjs");
+Object.keys(_deepClone).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _deepClone[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _deepClone[key];
+    }
+  });
+});
+var _deepMerge = require("./deep-merge.cjs");
+Object.keys(_deepMerge).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _deepMerge[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _deepMerge[key];
+    }
+  });
+});
+var _delay = require("./delay.cjs");
+Object.keys(_delay).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _delay[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _delay[key];
+    }
+  });
+});
+var _flattenObject = require("./flatten-object.cjs");
+Object.keys(_flattenObject).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _flattenObject[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _flattenObject[key];
+    }
+  });
+});
+var _getField = require("./get-field.cjs");
+Object.keys(_getField).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getField[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getField[key];
+    }
+  });
+});
+var _getOrderedBy = require("./get-ordered-by.cjs");
+Object.keys(_getOrderedBy).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getOrderedBy[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getOrderedBy[key];
+    }
+  });
+});
+var _getUnique = require("./get-unique.cjs");
+Object.keys(_getUnique).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getUnique[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getUnique[key];
+    }
+  });
+});
+var _identity = require("./identity.cjs");
+Object.keys(_identity).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _identity[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _identity[key];
+    }
+  });
+});
+var _isEqual = require("./is-equal.cjs");
+Object.keys(_isEqual).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isEqual[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _isEqual[key];
+    }
+  });
+});
+var _isProduction = require("./is-production.cjs");
+Object.keys(_isProduction).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isProduction[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _isProduction[key];
+    }
+  });
+});
+var _isRuntimeServer = require("./is-runtime-server.cjs");
+Object.keys(_isRuntimeServer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isRuntimeServer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _isRuntimeServer[key];
+    }
+  });
+});
+var _matchSorter = require("./match-sorter.cjs");
+Object.keys(_matchSorter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _matchSorter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _matchSorter[key];
+    }
+  });
+});
+var _noop = require("./noop.cjs");
+Object.keys(_noop).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _noop[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _noop[key];
+    }
+  });
+});
+var _removeAccents = require("./remove-accents.cjs");
+Object.keys(_removeAccents).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _removeAccents[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _removeAccents[key];
+    }
+  });
+});
+var _removeEmptyItems = require("./remove-empty-items.cjs");
+Object.keys(_removeEmptyItems).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _removeEmptyItems[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _removeEmptyItems[key];
+    }
+  });
+});
+var _setField = require("./set-field.cjs");
+Object.keys(_setField).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _setField[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _setField[key];
+    }
+  });
+});
+var _throttle = require("./throttle.cjs");
+Object.keys(_throttle).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _throttle[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _throttle[key];
+    }
+  });
+});
+var _timeout = require("./timeout.cjs");
+Object.keys(_timeout).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _timeout[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _timeout[key];
+    }
+  });
+});
+var _toDeepKey = require("./to-deep-key.cjs");
+Object.keys(_toDeepKey).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _toDeepKey[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _toDeepKey[key];
+    }
+  });
+});
+var _toPath = require("./to-path.cjs");
+Object.keys(_toPath).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _toPath[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _toPath[key];
+    }
+  });
+});
+var _unflattenObject = require("./unflatten-object.cjs");
+Object.keys(_unflattenObject).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _unflattenObject[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _unflattenObject[key];
+    }
+  });
+});
+var _union = require("./union.cjs");
+Object.keys(_union).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _union[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _union[key];
+    }
+  });
+});
+var _withTimeout = require("./with-timeout.cjs");
+Object.keys(_withTimeout).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _withTimeout[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _withTimeout[key];
+    }
+  });
+});

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export * from "./arg-identity";
+export * from "./debounce";
+export * from "./deep-clone";
+export * from "./deep-merge";
+export * from "./delay";
+export * from "./flatten-object";
+export * from "./get-field";
+export * from "./get-ordered-by";
+export * from "./get-unique";
+export * from "./identity";
+export * from "./is-equal";
+export * from "./is-production";
+export * from "./is-runtime-server";
+export * from "./match-sorter";
+export * from "./noop";
+export * from "./remove-accents";
+export * from "./remove-empty-items";
+export * from "./set-field";
+export * from "./throttle";
+export * from "./timeout";
+export * from "./to-deep-key";
+export * from "./to-path";
+export * from "./unflatten-object";
+export * from "./union";
+export * from "./with-timeout";

package/dist/index.mjs

@@ -0,0 +1 @@
+export*from"./arg-identity";export*from"./debounce";export*from"./deep-clone";export*from"./deep-merge";export*from"./delay";export*from"./flatten-object";export*from"./get-field";export*from"./get-ordered-by";export*from"./get-unique";export*from"./identity";export*from"./is-equal";export*from"./is-production";export*from"./is-runtime-server";export*from"./match-sorter";export*from"./noop";export*from"./remove-accents";export*from"./remove-empty-items";export*from"./set-field";export*from"./throttle";export*from"./timeout";export*from"./to-deep-key";export*from"./to-path";export*from"./unflatten-object";export*from"./union";export*from"./with-timeout";

package/dist/is-equal.cjs

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isEqual = isEqual;
+var _types = require("@stryke/types");
+const l = typeof Map == "function",
+  a = typeof Set == "function",
+  c = typeof ArrayBuffer == "function" && !!ArrayBuffer.isView;
+function o(e, t) {
+  if (e === t) return !0;
+  if (e && t && typeof e == "object" && typeof t == "object") {
+    if (e.constructor !== t.constructor) return !1;
+    let n;
+    if (Array.isArray(e)) {
+      if (n = e.length, n != t.length) return !1;
+      for (let r = n; r-- !== 0;) if (!o(e[r], t[r])) return !1;
+      return !0;
+    }
+    let i;
+    if (l && e instanceof Map && t instanceof Map) {
+      if (e.size !== t.size) return !1;
+      i = e.entries();
+      let r;
+      for (; !(r = i.next()).done;) if (!t.has(r.value[0])) return !1;
+      for (i = e.entries(); !(r = i.next()).done;) if (!o(r.value[1], t.get(r.value[0]))) return !1;
+      return !0;
+    }
+    if (a && e instanceof Set && t instanceof Set) {
+      if (e.size !== t.size) return !1;
+      i = e.entries();
+      let r;
+      for (; !(r = i.next()).done;) if (!t.has(r.value[0])) return !1;
+      return !0;
+    }
+    if (Array.isArray(e) && Array.isArray(t) && c && ArrayBuffer.isView(e) && ArrayBuffer.isView(t)) {
+      if (n = e.length, n != t.length) return !1;
+      for (let r = n; r-- !== 0;) if (e[r] !== t[r]) return !1;
+      return !0;
+    }
+    if (e.constructor === RegExp) return e.source === t.source && e.flags === t.flags;
+    if (e.valueOf !== Object.prototype.valueOf && typeof e.valueOf == "function" && typeof t.valueOf == "function") return e.valueOf() === t.valueOf();
+    if (e.toString !== Object.prototype.toString && typeof e.toString == "function" && typeof t.toString == "function") return e.toString() === t.toString();
+    const f = Object.keys(e);
+    if (n = f.length, n !== Object.keys(t).length) return !1;
+    for (let r = n; r-- !== 0;) if (!(0, _types.isSet)(r) || !(0, _types.isSetString)(f[r]) || !Object.prototype.hasOwnProperty.call(t, f[r])) return !1;
+    for (let r = n; r-- !== 0;) if (!(Array.isArray(f) && (f[r] === "_owner" || f[r] === "__v" || f[r] === "__o") && e.$$typeof) && (!(0, _types.isSet)(r) || !(0, _types.isSetString)(f[r]) || !o(e[f[r]], t[f[r]]))) return !1;
+    return !0;
+  }
+  return e !== e && t !== t;
+}
+function isEqual(e, t) {
+  try {
+    return o(e, t);
+  } catch (n) {
+    if (/stack|recursion/i.test(n?.message || "")) return console.warn("isEqual cannot handle circular refs"), !1;
+    throw n;
+  }
+}

package/dist/is-equal.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Checks if two values are equal, including support for `Date`, `RegExp`, and deep object comparison.
+ *
+ * @example
+ * ```ts
+ * isEqual(1, 1); // true
+ * isEqual({ a: 1 }, { a: 1 }); // true
+ * isEqual(/abc/g, /abc/g); // true
+ * isEqual(new Date('2020-01-01'), new Date('2020-01-01')); // true
+ * isEqual([1, 2, 3], [1, 2, 3]); // true
+ * isEqual({ a: 1, b: { c: 2 } }, { a: 1, b: { c: 2 } }); // true
+ * ```
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns `true` if the values are equal, otherwise `false`.
+ */
+export declare function isEqual(a: any, b: any): boolean;

package/dist/is-equal.mjs

@@ -0,0 +1 @@
+import{isSet as s,isSetString as u}from"@stryke/types";const l=typeof Map=="function",a=typeof Set=="function",c=typeof ArrayBuffer=="function"&&!!ArrayBuffer.isView;function o(e,t){if(e===t)return!0;if(e&&t&&typeof e=="object"&&typeof t=="object"){if(e.constructor!==t.constructor)return!1;let n;if(Array.isArray(e)){if(n=e.length,n!=t.length)return!1;for(let r=n;r--!==0;)if(!o(e[r],t[r]))return!1;return!0}let i;if(l&&e instanceof Map&&t instanceof Map){if(e.size!==t.size)return!1;i=e.entries();let r;for(;!(r=i.next()).done;)if(!t.has(r.value[0]))return!1;for(i=e.entries();!(r=i.next()).done;)if(!o(r.value[1],t.get(r.value[0])))return!1;return!0}if(a&&e instanceof Set&&t instanceof Set){if(e.size!==t.size)return!1;i=e.entries();let r;for(;!(r=i.next()).done;)if(!t.has(r.value[0]))return!1;return!0}if(Array.isArray(e)&&Array.isArray(t)&&c&&ArrayBuffer.isView(e)&&ArrayBuffer.isView(t)){if(n=e.length,n!=t.length)return!1;for(let r=n;r--!==0;)if(e[r]!==t[r])return!1;return!0}if(e.constructor===RegExp)return e.source===t.source&&e.flags===t.flags;if(e.valueOf!==Object.prototype.valueOf&&typeof e.valueOf=="function"&&typeof t.valueOf=="function")return e.valueOf()===t.valueOf();if(e.toString!==Object.prototype.toString&&typeof e.toString=="function"&&typeof t.toString=="function")return e.toString()===t.toString();const f=Object.keys(e);if(n=f.length,n!==Object.keys(t).length)return!1;for(let r=n;r--!==0;)if(!s(r)||!u(f[r])||!Object.prototype.hasOwnProperty.call(t,f[r]))return!1;for(let r=n;r--!==0;)if(!(Array.isArray(f)&&(f[r]==="_owner"||f[r]==="__v"||f[r]==="__o")&&e.$$typeof)&&(!s(r)||!u(f[r])||!o(e[f[r]],t[f[r]])))return!1;return!0}return e!==e&&t!==t}export function isEqual(e,t){try{return o(e,t)}catch(n){if(/stack|recursion/i.test(n?.message||""))return console.warn("isEqual cannot handle circular refs"),!1;throw n}}

package/dist/is-production.cjs

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isProduction = exports.isMode = exports.isDevelopment = void 0;
+const isMode = (o, t) => t?.toLowerCase() === o,
+  isProduction = o => isMode("production", o),
+  isDevelopment = o => !isProduction(o);
+exports.isDevelopment = isDevelopment;
+exports.isProduction = isProduction;
+exports.isMode = isMode;

package/dist/is-production.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Check the current runtime mode of the process
+ *
+ * @param mode - The mode to check the current process's mode against
+ * @param env - An optional environment name to check the current process's mode against
+ * @returns An indicator specifying if the current runtime matches the `mode` parameter
+ */
+export declare const isMode: (mode: string, env: string) => boolean;
+/**
+ * The function checks if the code is running in production.
+ *
+ * @param env - An environment name to check the current process's mode against
+ * @returns A boolean indicating if the code is running in production.
+ */
+export declare const isProduction: (env: string) => boolean;
+/**
+ * The function checks if the code is **NOT** running in production.
+ *
+ * @remarks
+ * **Please note:** This function does **not** check if the mode equals 'development' specifically.
+ *
+ * To check for the 'development' mode specifically, run:
+ *
+ * ```typescript
+ * const isDevelopmentSpecifically = isMode("development");
+ * ```
+ * @param env - An environment name to check the current process's mode against
+ * @returns A boolean indicating if the code is **NOT** running in production.
+ */
+export declare const isDevelopment: (env: string) => boolean;

package/dist/is-production.mjs

@@ -0,0 +1 @@
+export const isMode=(o,t)=>t?.toLowerCase()===o,isProduction=o=>isMode("production",o),isDevelopment=o=>!isProduction(o);

package/dist/is-runtime-server.cjs

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isRuntimeServer = exports.isRuntimeClient = void 0;
+const isRuntimeServer = () => typeof globalThis > "u" || "Deno" in globalThis,
+  isRuntimeClient = () => !isRuntimeServer();
+exports.isRuntimeClient = isRuntimeClient;
+exports.isRuntimeServer = isRuntimeServer;

package/dist/is-runtime-server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The function checks if the code is running on the server-side
+ *
+ * @returns An indicator specifying if the code is running on the server-side
+ */
+export declare const isRuntimeServer: () => boolean;
+/**
+ * The function checks if the code is running in
+ * the browser (and not on the server).
+ */
+export declare const isRuntimeClient: () => boolean;

package/dist/is-runtime-server.mjs

@@ -0,0 +1 @@
+export const isRuntimeServer=()=>typeof globalThis>"u"||"Deno"in globalThis,isRuntimeClient=()=>!isRuntimeServer();