@aliexme/js-utils 1.2.0-alpha.1 → 2.1.0

package/dist/async/index.d.ts

@@ -1,2 +1,3 @@
 export * from './asyncify';
 export * from './asyncResult';
+export * from './sleep';

package/dist/async/sleep.d.ts

@@ -0,0 +1 @@
+export declare const sleep: (ms: number) => Promise<void>;

package/dist/async/sleep.js

@@ -0,0 +1,4 @@
+const t = async (e) => new Promise((s) => setTimeout(s, e));
+export {
+  t as sleep
+};

package/dist/function/debounce.d.ts

@@ -0,0 +1,9 @@
+export interface DebouncedFunc<T extends (...args: unknown[]) => unknown> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+}
+export interface DebounceOptions {
+    maxWait?: number;
+    withLeading?: boolean;
+}
+export declare const debounce: <T extends (...args: unknown[]) => unknown>(func: T, delay: number, options?: DebounceOptions) => DebouncedFunc<T>;

package/dist/function/debounce.js

@@ -0,0 +1,26 @@
+import { clamp as C } from "../number/clamp.js";
+const p = (l, i, m = {}) => {
+  const { maxWait: c, withLeading: f = !1 } = m;
+  let t = null, e = null;
+  const o = () => {
+    t !== null && (clearTimeout(t), t = null);
+  }, n = () => {
+    e = null;
+  }, T = () => {
+    o(), n();
+  }, s = (...r) => {
+    o();
+    const a = Date.now(), d = e ? a - e : 0, u = c ? C(c - d, 0, i) : i;
+    if (!e && (e = a, f)) {
+      l(...r), t = setTimeout(n, u);
+      return;
+    }
+    t = setTimeout(() => {
+      l(...r), n();
+    }, u);
+  };
+  return s.cancel = T, s;
+};
+export {
+  p as debounce
+};

package/dist/function/index.d.ts

@@ -1 +1,3 @@
 export * from './noop';
+export * from './debounce';
+export * from './throttle';

package/dist/function/throttle.d.ts

@@ -0,0 +1,8 @@
+export interface ThrottledFunc<T extends (...args: unknown[]) => unknown> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+}
+export interface ThrottleOptions {
+    withTrailing?: boolean;
+}
+export declare const throttle: <T extends (...args: unknown[]) => unknown>(func: T, delay: number, options?: ThrottleOptions) => ThrottledFunc<T>;

package/dist/function/throttle.js

@@ -0,0 +1,23 @@
+const f = (n, c, s = {}) => {
+  const { withTrailing: T = !1 } = s;
+  let e = null, l = null, t = !1;
+  const o = () => {
+    e !== null && (clearTimeout(e), e = null);
+  }, m = () => {
+    l !== null && (clearTimeout(l), l = null);
+  }, r = () => {
+    t = !1;
+  }, a = () => {
+    o(), m(), r();
+  }, i = (...u) => {
+    if (t) {
+      T && (o(), e = setTimeout(() => n(...u), c));
+      return;
+    }
+    o(), n(...u), t = !0, l = setTimeout(r, c);
+  };
+  return i.cancel = a, i;
+};
+export {
+  f as throttle
+};

package/dist/index.js

@@ -1,38 +1,46 @@
 import { capitalize as e } from "./string/capitalize.js";
 import { secureString as m } from "./string/secureString.js";
-import { randomString as p } from "./string/randomString.js";
+import { randomString as f } from "./string/randomString.js";
 import { round as n } from "./number/round.js";
-import { randomInt as i } from "./number/randomInt.js";
-import { uniquify as s } from "./array/uniquify.js";
-import { subtractArrays as u } from "./array/subtractArrays.js";
-import { arraysIntersection as b } from "./array/arraysIntersection.js";
-import { groupArrayItems as g } from "./array/groupArrayItems.js";
-import { randomArrayItem as O } from "./array/randomArrayItem.js";
-import { getObjectKey as A } from "./object/getObjectKey.js";
-import { findObjectKey as S } from "./object/findObjectKey.js";
-import { objectForEach as q } from "./object/objectForEach.js";
-import { omitObjectProperties as E } from "./object/omitObjectProperties.js";
-import { omitUndefinedObjectValues as P } from "./object/omitUndefinedObjectValues.js";
-import { noop as U } from "./function/noop.js";
-import { asyncify as k } from "./async/asyncify.js";
-import { asyncResult as w } from "./async/asyncResult.js";
+import { clamp as c } from "./number/clamp.js";
+import { randomInt as s } from "./number/randomInt.js";
+import { uniquify as u } from "./array/uniquify.js";
+import { subtractArrays as b } from "./array/subtractArrays.js";
+import { arraysIntersection as j } from "./array/arraysIntersection.js";
+import { groupArrayItems as I } from "./array/groupArrayItems.js";
+import { randomArrayItem as A } from "./array/randomArrayItem.js";
+import { getObjectKey as K } from "./object/getObjectKey.js";
+import { findObjectKey as q } from "./object/findObjectKey.js";
+import { objectForEach as E } from "./object/objectForEach.js";
+import { omitObjectProperties as P } from "./object/omitObjectProperties.js";
+import { omitUndefinedObjectValues as U } from "./object/omitUndefinedObjectValues.js";
+import { noop as k } from "./function/noop.js";
+import { debounce as w } from "./function/debounce.js";
+import { throttle as C } from "./function/throttle.js";
+import { asyncify as G } from "./async/asyncify.js";
+import { asyncResult as J } from "./async/asyncResult.js";
+import { sleep as M } from "./async/sleep.js";
 export {
-  b as arraysIntersection,
-  w as asyncResult,
-  k as asyncify,
+  j as arraysIntersection,
+  J as asyncResult,
+  G as asyncify,
   e as capitalize,
-  S as findObjectKey,
-  A as getObjectKey,
-  g as groupArrayItems,
-  U as noop,
-  q as objectForEach,
-  E as omitObjectProperties,
-  P as omitUndefinedObjectValues,
-  O as randomArrayItem,
-  i as randomInt,
-  p as randomString,
+  c as clamp,
+  w as debounce,
+  q as findObjectKey,
+  K as getObjectKey,
+  I as groupArrayItems,
+  k as noop,
+  E as objectForEach,
+  P as omitObjectProperties,
+  U as omitUndefinedObjectValues,
+  A as randomArrayItem,
+  s as randomInt,
+  f as randomString,
   n as round,
   m as secureString,
-  u as subtractArrays,
-  s as uniquify
+  M as sleep,
+  b as subtractArrays,
+  C as throttle,
+  u as uniquify
 };

package/dist/number/clamp.d.ts

@@ -0,0 +1 @@
+export declare const clamp: (value: number, min: number, max: number) => number;

package/dist/number/clamp.js

@@ -0,0 +1,4 @@
+const n = (t, a, m) => Math.min(Math.max(t, a), m);
+export {
+  n as clamp
+};

package/dist/number/index.d.ts

@@ -1,2 +1,3 @@
 export * from './round';
+export * from './clamp';
 export * from './randomInt';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliexme/js-utils",
-  "version": "1.2.0-alpha.1",
+  "version": "2.1.0",
   "description": "Common JavaScript utilities",
   "private": false,
   "author": "Alexander Smirnov <al.smirnov996@gmail.com>",
@@ -25,5 +25,5 @@
     "build": "vite build",
     "ts:check": "tsc --noEmit"
   },
-  "gitHead": "2106876d0d328dd81f7ff58c6e558465d2ca8804"
+  "gitHead": "e00bfc1c4f1f64875f0e2b9c6b8119c5725fc77f"
 }