es-toolkit 1.31.0 → 1.32.0-dev.1003

package/dist/promise/semaphore.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A counting semaphore for async functions that manages available permits.
+ * Semaphores are mainly used to limit the number of concurrent async tasks.
+ *
+ * Each `acquire` operation takes a permit or waits until one is available.
+ * Each `release` operation adds a permit, potentially allowing a waiting task to proceed.
+ *
+ * The semaphore ensures fairness by maintaining a FIFO (First In, First Out) order for acquirers.
+ *
+ * @example
+ * const sema = new Semaphore(2);
+ *
+ * async function task() {
+ *   await sema.acquire();
+ *   try {
+ *     // This code can only be executed by two tasks at the same time
+ *   } finally {
+ *     sema.release();
+ *   }
+ * }
+ *
+ * task();
+ * task();
+ * task(); // This task will wait until one of the previous tasks releases the semaphore.
+ */
+declare class Semaphore {
+    /**
+     * The maximum number of concurrent operations allowed.
+     * @type {number}
+     */
+    capacity: number;
+    /**
+     * The number of available permits.
+     * @type {number}
+     */
+    available: number;
+    private deferredTasks;
+    /**
+     * Creates an instance of Semaphore.
+     * @param {number} capacity - The maximum number of concurrent operations allowed.
+     *
+     * @example
+     * const sema = new Semaphore(3); // Allows up to 3 concurrent operations.
+     */
+    constructor(capacity: number);
+    /**
+     * Acquires a semaphore, blocking if necessary until one is available.
+     * @returns {Promise<void>} A promise that resolves when the semaphore is acquired.
+     *
+     * @example
+     * const sema = new Semaphore(1);
+     *
+     * async function criticalSection() {
+     *   await sema.acquire();
+     *   try {
+     *     // This code section cannot be executed simultaneously
+     *   } finally {
+     *     sema.release();
+     *   }
+     * }
+     */
+    acquire(): Promise<void>;
+    /**
+     * Releases a semaphore, allowing one more operation to proceed.
+     *
+     * @example
+     * const sema = new Semaphore(1);
+     *
+     * async function task() {
+     *   await sema.acquire();
+     *   try {
+     *     // This code can only be executed by two tasks at the same time
+     *   } finally {
+     *     sema.release(); // Allows another waiting task to proceed.
+     *   }
+     * }
+     */
+    release(): void;
+}
+
+export { Semaphore };

package/dist/promise/semaphore.mjs

@@ -0,0 +1,30 @@
+class Semaphore {
+    capacity;
+    available;
+    deferredTasks = [];
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.available = capacity;
+    }
+    async acquire() {
+        if (this.available > 0) {
+            this.available--;
+            return;
+        }
+        return new Promise(resolve => {
+            this.deferredTasks.push(resolve);
+        });
+    }
+    release() {
+        const deferredTask = this.deferredTasks.shift();
+        if (deferredTask != null) {
+            deferredTask();
+            return;
+        }
+        if (this.available < this.capacity) {
+            this.available++;
+        }
+    }
+}
+
+export { Semaphore };

package/error.d.ts

@@ -0,0 +1 @@
+export * from './dist/error';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.31.0",
+  "version": "1.32.0-dev.1003+2241152e",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {
@@ -35,6 +35,26 @@
         "default": "./dist/array/index.js"
       }
     },
+    "./compat": {
+      "import": {
+        "types": "./dist/compat/index.d.mts",
+        "default": "./dist/compat/index.mjs"
+      },
+      "require": {
+        "types": "./dist/compat/index.d.ts",
+        "default": "./dist/compat/index.js"
+      }
+    },
+    "./error": {
+      "import": {
+        "types": "./dist/error/index.d.mts",
+        "default": "./dist/error/index.mjs"
+      },
+      "require": {
+        "types": "./dist/error/index.d.ts",
+        "default": "./dist/error/index.js"
+      }
+    },
     "./function": {
       "import": {
         "types": "./dist/function/index.d.mts",
@@ -105,16 +125,6 @@
         "default": "./dist/util/index.js"
       }
     },
-    "./compat": {
-      "import": {
-        "types": "./dist/compat/index.d.mts",
-        "default": "./dist/compat/index.mjs"
-      },
-      "require": {
-        "types": "./dist/compat/index.d.ts",
-        "default": "./dist/compat/index.js"
-      }
-    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -148,6 +158,26 @@
           "default": "./dist/array/index.js"
         }
       },
+      "./compat": {
+        "import": {
+          "types": "./dist/compat/index.d.mts",
+          "default": "./dist/compat/index.mjs"
+        },
+        "require": {
+          "types": "./dist/compat/index.d.ts",
+          "default": "./dist/compat/index.js"
+        }
+      },
+      "./error": {
+        "import": {
+          "types": "./dist/error/index.d.mts",
+          "default": "./dist/error/index.mjs"
+        },
+        "require": {
+          "types": "./dist/error/index.d.ts",
+          "default": "./dist/error/index.js"
+        }
+      },
       "./function": {
         "import": {
           "types": "./dist/function/index.d.mts",
@@ -218,16 +248,6 @@
           "default": "./dist/util/index.js"
         }
       },
-      "./compat": {
-        "import": {
-          "types": "./dist/compat/index.d.mts",
-          "default": "./dist/compat/index.mjs"
-        },
-        "require": {
-          "types": "./dist/compat/index.d.ts",
-          "default": "./dist/compat/index.js"
-        }
-      },
       "./package.json": "./package.json"
     }
   },
@@ -254,6 +274,7 @@
     "eslint-plugin-vue": "^9.28.0",
     "execa": "^9.3.0",
     "globals": "^15.9.0",
+    "happy-dom": "^16.7.3",
     "jscodeshift": "^17.0.0",
     "prettier": "^3.2.5",
     "prettier-plugin-sort-re-exports": "^0.1.0",

package/dist/_chunk/index-BGZDR9.js

@@ -1,50 +0,0 @@
-'use strict';
-
-class AbortError extends Error {
-    constructor(message = 'The operation was aborted') {
-        super(message);
-        this.name = 'AbortError';
-    }
-}
-
-class TimeoutError extends Error {
-    constructor(message = 'The operation was timed out') {
-        super(message);
-        this.name = 'TimeoutError';
-    }
-}
-
-function delay(ms, { signal } = {}) {
-    return new Promise((resolve, reject) => {
-        const abortError = () => {
-            reject(new AbortError());
-        };
-        const abortHandler = () => {
-            clearTimeout(timeoutId);
-            abortError();
-        };
-        if (signal?.aborted) {
-            return abortError();
-        }
-        const timeoutId = setTimeout(() => {
-            signal?.removeEventListener('abort', abortHandler);
-            resolve();
-        }, ms);
-        signal?.addEventListener('abort', abortHandler, { once: true });
-    });
-}
-
-async function timeout(ms) {
-    await delay(ms);
-    throw new TimeoutError();
-}
-
-async function withTimeout(run, ms) {
-    return Promise.race([run(), timeout(ms)]);
-}
-
-exports.AbortError = AbortError;
-exports.TimeoutError = TimeoutError;
-exports.delay = delay;
-exports.timeout = timeout;
-exports.withTimeout = withTimeout;

package/dist/_chunk/isPlainObject-octpoD.js

@@ -1,32 +0,0 @@
-'use strict';
-
-function isPrimitive(value) {
-    return value == null || (typeof value !== 'object' && typeof value !== 'function');
-}
-
-function isTypedArray(x) {
-    return ArrayBuffer.isView(x) && !(x instanceof DataView);
-}
-
-function getSymbols(object) {
-    return Object.getOwnPropertySymbols(object).filter(symbol => Object.prototype.propertyIsEnumerable.call(object, symbol));
-}
-
-function isPlainObject(value) {
-    if (!value || typeof value !== 'object') {
-        return false;
-    }
-    const proto = Object.getPrototypeOf(value);
-    const hasObjectPrototype = proto === null ||
-        proto === Object.prototype ||
-        Object.getPrototypeOf(proto) === null;
-    if (!hasObjectPrototype) {
-        return false;
-    }
-    return Object.prototype.toString.call(value) === '[object Object]';
-}
-
-exports.getSymbols = getSymbols;
-exports.isPlainObject = isPlainObject;
-exports.isPrimitive = isPrimitive;
-exports.isTypedArray = isTypedArray;