ciorent 0.0.23 → 0.0.24

package/README.md

@@ -243,7 +243,7 @@ cio.concurrent(5, task);
 ```
 
 ### Debounce
-Dropping tasks for a period of time
+Dropping tasks for a period of time.
 ```ts
 import * as cio from 'ciorent';
 
@@ -252,7 +252,23 @@ const fn = cio.debounce((id: number) => {
 }, 500);
 
 fn(1); // fn(1) gets skipped
-cio.sleepSync(100);
+await cio.sleep(100);
 fn(2); // fn(2) gets executed
 ```
 
+### Throttle
+Limit function calls for a specific period of time.
+```ts
+import * as cio from 'ciorent';
+
+const fn = cio.throttle((id: number) => {
+  console.log('ID:', id);
+}, 500, 1);
+
+fn(1); // fn(1) gets executed
+await cio.sleep(100);
+fn(2); // fn(2) gets skipped
+await cio.sleep(500);
+fn(3); // fn(3) gets executed
+```
+

package/index.d.ts

@@ -34,8 +34,15 @@ export declare const sequential: <const T extends any[]>(n: number, task: (...ar
  */
 export declare const concurrent: <const T extends any[], const R>(n: number, task: (...args: [...T, id: number]) => Promise<R>, ...args: T) => Promise<R[]>;
 /**
- * Drop sync function calls for a specific period
+ * Drop function calls until it doesn't get called for a specific period.
  * @param f - The target function to debounce
  * @param ms - The time period in milliseconds
  */
 export declare const debounce: <const Args extends any[]>(f: (...args: Args) => any, ms: number) => ((...args: Args) => void);
+/**
+ * Drop function calls for a specific period
+ * @param f - The target function to throttle
+ * @param ms - The time period in milliseconds
+ * @param limit - The call limit in the time period
+ */
+export declare const throttle: <const Args extends any[]>(f: (...args: Args) => any, ms: number, limit: number) => ((...args: Args) => void);

package/index.js

@@ -1 +1 @@
-export let pause=Promise.resolve();export let sleep=globalThis.Bun?.sleep??globalThis.process?.getBuiltinModule?.("timers/promises").setTimeout??((ms)=>new Promise((res)=>{setTimeout(res,ms)}));let sharedBuf=new Int32Array(new SharedArrayBuffer(4));export let sleepSync=globalThis.Bun?.sleepSync??((ms)=>{Atomics.wait(sharedBuf,0,0,ms)});export let sequential=async(n,task,...args)=>{for(let i=0;i<n;i++)await task(...args,i)};export let concurrent=(n,task,...args)=>{let arr=new Array(n);for(let i=0;i<n;i++)arr[i]=task(...args,i);return Promise.all(arr)};export let debounce=(f,ms)=>{let args;let unlocked=true;let unlock=()=>{unlocked=true};let call=()=>Promise.try(f,...args).finally(unlock);return(...a)=>{args=a;if(unlocked){unlocked=false;setTimeout(call,ms)}}};
+export let pause=Promise.resolve();export let sleep=globalThis.Bun?.sleep??globalThis.process?.getBuiltinModule?.("timers/promises").setTimeout??((ms)=>new Promise((res)=>{setTimeout(res,ms)}));let sharedBuf=new Int32Array(new SharedArrayBuffer(4));export let sleepSync=globalThis.Bun?.sleepSync??((ms)=>{Atomics.wait(sharedBuf,0,0,ms)});export let sequential=async(n,task,...args)=>{for(let i=0;i<n;i++)await task(...args,i)};export let concurrent=(n,task,...args)=>{let arr=new Array(n);for(let i=0;i<n;i++)arr[i]=task(...args,i);return Promise.all(arr)};export let debounce=(f,ms)=>{let id;return(...a)=>{clearTimeout(id);id=setTimeout(f,ms,...a)}};export let throttle=(f,ms,limit)=>{let cur=limit;let call=(...a)=>{cur++;f(...a)};return(...a)=>{if(cur>0){cur--;setTimeout(call,ms,...a)}}};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ciorent",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "description": "A lightweight, low-overhead concurrency library",
   "homepage": "https://ciorent.netlify.app",
   "repository": {
@@ -18,14 +18,14 @@
   "main": "./index.js",
   "types": "./index.d.ts",
   "exports": {
-    "./fixed-queue": "./fixed-queue.js",
     "./sliding-queue": "./sliding-queue.js",
-    "./fiber": "./fiber.js",
-    "./channel": "./channel.js",
+    "./fixed-queue": "./fixed-queue.js",
     "./dropping-queue": "./dropping-queue.js",
-    "./topic": "./topic.js",
+    "./latch": "./latch.js",
     "./semaphore": "./semaphore.js",
     ".": "./index.js",
-    "./latch": "./latch.js"
+    "./topic": "./topic.js",
+    "./channel": "./channel.js",
+    "./fiber": "./fiber.js"
   }
 }