mini-semaphore 1.3.16 → 1.4.2

package/cjs/core.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.release = exports.acquire = void 0;
+exports.releaseWithAbort = exports.acquireWithAbort = exports.release = exports.acquire = void 0;
 /**
  * @typedef {import("./index").TVoidFunction} TVoidFunction
  * @typedef {import("./index").Deque<TVoidFunction>} Deque
+ * @typedef {import("./index").TFlowableLockWithAbort} TFlowableLockWithAbort
+ * @typedef {import("./index").Deque<TResolver>} DequeWithAbort
  * @typedef {import("./index").ISimplifiedLock} ISimplifiedLock
  * @typedef {import("./index").TFlowableLock} TFlowableLock
  * @typedef {import("./index").IFlowableLock} IFlowableLock
@@ -62,4 +64,45 @@ const release = (dis) => {
         dis.capacity = dis.limit;
     }
 };
-exports.release = release;
+exports.release = release;
+/**
+ * @param {TFlowableLockWithAbort} dis
+ * @returns {Promise<void>}
+ */
+const acquireWithAbort = (dis) => {
+    return new Promise((resolve, reject) => {
+        if (dis.capacity > 0) {
+            dis.capacity--, resolve();
+        }
+        else {
+            dis.q.push({
+                resolve, reject
+            });
+        }
+    });
+};
+exports.acquireWithAbort = acquireWithAbort;
+/**
+ * @param {TFlowableLockWithAbort} dis
+ * @returns {void}
+ */
+const releaseWithAbort = (dis) => {
+    /** @type {DequeWithAbort} */
+    let dq;
+    if ((dq = dis.q).length) {
+        const resolver = dq.shift();
+        /* istanbul ignore next */
+        if (!resolver) {
+            THROW();
+        }
+        else {
+            resolver.resolve();
+        }
+    }
+    else {
+        if (dis.capacity < dis.limit) {
+            dis.capacity++;
+        }
+    }
+};
+exports.releaseWithAbort = releaseWithAbort;

package/cjs/deque.js

@@ -23,26 +23,28 @@ const am = (src, si, dst, di, len) => {
  */
 const p2l = (n) => {
     n = n >>> 0;
-    n = n - 1;
-    n = n | (n >> 1);
-    n = n | (n >> 2);
-    n = n | (n >> 4);
-    n = n | (n >> 8);
-    n = n | (n >> 16);
+    n--;
+    n |= n >> 1;
+    n |= n >> 2;
+    n |= n >> 4;
+    n |= n >> 8;
+    n |= n >> 16;
     return n + 1;
 };
 /**
  * getCapacity
- * @param {number=} n
+ * @param {number} n
  */
 const gc = (n) => {
-    // @ts-ignore typescript cannot allow (undefined | 0) expression
     return p2l(Math.min(Math.max(16, n | 0), 1073741824));
 };
 /**
  * ### Implementation restricted to FIFO
  *
- * this class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
+ * This class uses a ring buffer for efficient FIFO operations.
+ * The maximum buffer size is **`1073741824`**.
+ *
+ * This class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
  * Released under the MIT License: https://github.com/petkaantonov/deque/blob/master/LICENSE
  *
  * @template {any} T
@@ -55,23 +57,28 @@ class Deque {
     constructor(ic) {
         /**
          * capacity
-         * @type {number}
+         * @internal
          */
-        this._c = gc(ic);
+        this._c = gc(ic || 16);
         /**
          * current length (size
-         * @type {number}
+         * @internal
          */
         this._l = 0;
         /**
          * current front position
-         * @type {number}
+         * @internal
          */
         this._f = 0;
         /**
          * @type {T[]}
+         * @internal
          */
         this._a = [];
+        /**
+         * current length (size
+         */
+        this.length = 0;
     }
     /**
      * @param {T} s subject
@@ -83,7 +90,7 @@ class Deque {
         }
         const i = (this._f + l) & (this._c - 1);
         this._a[i] = s;
-        this._l = l + 1;
+        this.length = this._l = l + 1;
     }
     shift() {
         const l = this._l;
@@ -95,12 +102,9 @@ class Deque {
         const r = this._a[f];
         this._a[f] = /** @type {T} */ (void 0);
         this._f = (f + 1) & (this._c - 1);
-        this._l = l - 1;
+        this.length = this._l = l - 1;
         return r;
     }
-    get length() {
-        return this._l;
-    }
 }
 exports.Deque = Deque;
 /**
@@ -109,6 +113,7 @@ exports.Deque = Deque;
  * @template {any} T
  * @param {Deque<T>} dis
  * @param {number} n expected capacity
+ * @todo test code
  */
 const rt = (dis, n) => {
     const oc = dis._c;

package/cjs/index.d.ts

@@ -7,23 +7,24 @@
 export declare class Deque<T extends any> {
     /**
      * capacity
-     * @type {number}
+     * @internal
      */
     _c: number;
     /**
      * current length (size
-     * @type {number}
+     * @internal
      */
     _l: number;
     /**
      * current front position
-     * @type {number}
+     * @internal
      */
     _f: number;
     /**
-     * @type {T[]}
+     * @internal
      */
     _a: T[];
+
     /**
      * default capacity `16`
      * @param ic initial capacity
@@ -35,7 +36,7 @@ export declare class Deque<T extends any> {
     push(s: T): void;
     shift(): T | undefined;
     // clear(): void;
-    get length(): number;
+    readonly length: number;
 }
 
 /**
@@ -95,6 +96,14 @@ export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
 };
 export declare type TVoidFunction = () => void;
 
+export declare type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export declare type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+};
 
 /**
  * #### Mini Semaphore
@@ -160,7 +169,7 @@ export declare class MiniSemaphore implements TFlowableLock {
 }
 
 /**
- * object implementation of `IFlowableLock`
+ * object implementation of `TFlowableLock`
  *
  *   + constructs a semaphore object limited at `capacity`
  *
@@ -168,7 +177,18 @@ export declare class MiniSemaphore implements TFlowableLock {
  * @date 2020/2/7
  * @version 1.0
  */
-export declare const create: (capacity: number) => IFlowableLock;
+export declare const create: (capacity: number) => TFlowableLock;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ * 
+ *   + constructs a semaphore object limited at `capacity`
+ * 
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
+
 
 declare namespace fr {
     /**

package/cjs/index.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.version = exports.restrictor = exports.Deque = exports.create = exports.MiniSemaphore = void 0;
+exports.version = exports.restrictor = exports.Deque = exports.createWithAbort = exports.create = exports.MiniSemaphore = void 0;
 var class_1 = require("./class");
 Object.defineProperty(exports, "MiniSemaphore", { enumerable: true, get: function () { return class_1.MiniSemaphore; } });
 var object_1 = require("./object");
 Object.defineProperty(exports, "create", { enumerable: true, get: function () { return object_1.create; } });
+Object.defineProperty(exports, "createWithAbort", { enumerable: true, get: function () { return object_1.createWithAbort; } });
 var deque_1 = require("./deque");
 Object.defineProperty(exports, "Deque", { enumerable: true, get: function () { return deque_1.Deque; } });
 var flow_restrictor_1 = require("./flow-restrictor");
 Object.defineProperty(exports, "restrictor", { enumerable: true, get: function () { return flow_restrictor_1.restrictor; } });
-exports.version = "v1.3.16";
+exports.version = "v1.4.2";

package/cjs/object.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.create = void 0;
+exports.createWithAbort = exports.create = void 0;
 /*!
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
   Copyright (C) 2020 jeffy-g <hirotom1107@gmail.com>
@@ -17,6 +17,26 @@ const core = require("./core");
 const deque_1 = require("./deque");
 const a = core.acquire;
 const r = core.release;
+const aa = core.acquireWithAbort;
+const ra = core.releaseWithAbort;
+/**
+ * @template {core.IFlowableLock & { q: Deque<unknown>}} T
+ * @param {number} capacity
+ * @returns
+ */
+const createBase = (capacity) => {
+    return /** @type {T} */ ({
+        capacity,
+        limit: capacity,
+        q: new deque_1.Deque(capacity),
+        /**
+         * @param {number} restriction
+         */
+        setRestriction(restriction) {
+            this.limit = this.capacity = restriction;
+        },
+    });
+};
 /**
  * object implementation of `IFlowableLock`
  *
@@ -27,10 +47,13 @@ const r = core.release;
  * @version 1.0
  */
 const create = (capacity) => {
+    /** @type {core.TFlowableLock} */
+    const base = createBase(capacity);
     return /** @satisfies {core.TFlowableLock} */ ({
-        capacity,
-        limit: capacity,
-        q: new deque_1.Deque(capacity),
+        ...base,
+        get pending() {
+            return this.q.length;
+        },
         /**
          *
          * @param {boolean} [lazy]
@@ -43,29 +66,77 @@ const create = (capacity) => {
             r(this);
         },
         /**
-         * @param {number} restriction
+         * @template {any} T
+         * @param {() => Promise<T>} process
+         * @param {boolean} [lazy]
+         * @returns {Promise<T>}
          */
-        setRestriction(restriction) {
-            this.limit = this.capacity = restriction;
-        },
+        async flow(process, lazy) {
+            await a(this, lazy);
+            try {
+                return await process();
+            }
+            finally {
+                r(this);
+            }
+        }
+    });
+};
+exports.create = create;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ *
+ *   + constructs a semaphore object limited at `capacity`
+ *
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+const createWithAbort = (capacity) => {
+    /** @type {core.TFlowableLockWithAbort} */
+    const base = createBase(capacity);
+    return /** @satisfies {core.TFlowableLockWithAbort} */ ({
+        ...base,
         get pending() {
             return this.q.length;
         },
+        /**
+         * @returns {Promise<void>}
+         */
+        acquire() {
+            return aa(this);
+        },
+        release() {
+            ra(this);
+        },
         /**
          * @template {any} T
          * @param {() => Promise<T>} process
-         * @param {boolean} [lazy]
          * @returns {Promise<T>}
          */
-        async flow(process, lazy) {
-            await a(this, lazy);
+        async flow(process) {
+            await aa(this);
             try {
                 return await process();
             }
             finally {
-                r(this);
+                ra(this);
+            }
+        },
+        /**
+         * @throws {AggregateError} description
+         */
+        abort() {
+            const dq = this.q;
+            let resolver;
+            const reason = {
+                message: "Process Aborted"
+            };
+            while (resolver = dq.shift()) {
+                resolver.reject(reason);
             }
+            this.capacity = this.limit;
         }
     });
 };
-exports.create = create;
+exports.createWithAbort = createWithAbort;

package/esm/core.mjs

@@ -1,6 +1,8 @@
 /**
  * @typedef {import("./index.mjs").TVoidFunction} TVoidFunction
  * @typedef {import("./index.mjs").Deque<TVoidFunction>} Deque
+ * @typedef {import("./index.mjs").TFlowableLockWithAbort} TFlowableLockWithAbort
+ * @typedef {import("./index.mjs").Deque<TResolver>} DequeWithAbort
  * @typedef {import("./index.mjs").ISimplifiedLock} ISimplifiedLock
  * @typedef {import("./index.mjs").TFlowableLock} TFlowableLock
  * @typedef {import("./index.mjs").IFlowableLock} IFlowableLock
@@ -57,4 +59,43 @@ export const release = (dis) => {
         console.warn("inconsistent release!");
         dis.capacity = dis.limit;
     }
+};
+/**
+ * @param {TFlowableLockWithAbort} dis
+ * @returns {Promise<void>}
+ */
+export const acquireWithAbort = (dis) => {
+    return new Promise((resolve, reject) => {
+        if (dis.capacity > 0) {
+            dis.capacity--, resolve();
+        }
+        else {
+            dis.q.push({
+                resolve, reject
+            });
+        }
+    });
+};
+/**
+ * @param {TFlowableLockWithAbort} dis
+ * @returns {void}
+ */
+export const releaseWithAbort = (dis) => {
+    /** @type {DequeWithAbort} */
+    let dq;
+    if ((dq = dis.q).length) {
+        const resolver = dq.shift();
+        /* istanbul ignore next */
+        if (!resolver) {
+            THROW();
+        }
+        else {
+            resolver.resolve();
+        }
+    }
+    else {
+        if (dis.capacity < dis.limit) {
+            dis.capacity++;
+        }
+    }
 };

package/esm/deque.mjs

@@ -20,26 +20,28 @@ const am = (src, si, dst, di, len) => {
  */
 const p2l = (n) => {
     n = n >>> 0;
-    n = n - 1;
-    n = n | (n >> 1);
-    n = n | (n >> 2);
-    n = n | (n >> 4);
-    n = n | (n >> 8);
-    n = n | (n >> 16);
+    n--;
+    n |= n >> 1;
+    n |= n >> 2;
+    n |= n >> 4;
+    n |= n >> 8;
+    n |= n >> 16;
     return n + 1;
 };
 /**
  * getCapacity
- * @param {number=} n
+ * @param {number} n
  */
 const gc = (n) => {
-    // @ts-ignore typescript cannot allow (undefined | 0) expression
     return p2l(Math.min(Math.max(16, n | 0), 1073741824));
 };
 /**
  * ### Implementation restricted to FIFO
  *
- * this class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
+ * This class uses a ring buffer for efficient FIFO operations.
+ * The maximum buffer size is **`1073741824`**.
+ *
+ * This class is based on https://github.com/petkaantonov/deque/blob/master/js/deque.js
  * Released under the MIT License: https://github.com/petkaantonov/deque/blob/master/LICENSE
  *
  * @template {any} T
@@ -52,23 +54,28 @@ export class Deque {
     constructor(ic) {
         /**
          * capacity
-         * @type {number}
+         * @internal
          */
-        this._c = gc(ic);
+        this._c = gc(ic || 16);
         /**
          * current length (size
-         * @type {number}
+         * @internal
          */
         this._l = 0;
         /**
          * current front position
-         * @type {number}
+         * @internal
          */
         this._f = 0;
         /**
          * @type {T[]}
+         * @internal
          */
         this._a = [];
+        /**
+         * current length (size
+         */
+        this.length = 0;
     }
     /**
      * @param {T} s subject
@@ -80,7 +87,7 @@ export class Deque {
         }
         const i = (this._f + l) & (this._c - 1);
         this._a[i] = s;
-        this._l = l + 1;
+        this.length = this._l = l + 1;
     }
     shift() {
         const l = this._l;
@@ -92,12 +99,9 @@ export class Deque {
         const r = this._a[f];
         this._a[f] = /** @type {T} */ (void 0);
         this._f = (f + 1) & (this._c - 1);
-        this._l = l - 1;
+        this.length = this._l = l - 1;
         return r;
     }
-    get length() {
-        return this._l;
-    }
 }
 /**
  * resize to
@@ -105,6 +109,7 @@ export class Deque {
  * @template {any} T
  * @param {Deque<T>} dis
  * @param {number} n expected capacity
+ * @todo test code
  */
 const rt = (dis, n) => {
     const oc = dis._c;

package/esm/index.d.mts

@@ -7,23 +7,24 @@
 export declare class Deque<T extends any> {
     /**
      * capacity
-     * @type {number}
+     * @internal
      */
     _c: number;
     /**
      * current length (size
-     * @type {number}
+     * @internal
      */
     _l: number;
     /**
      * current front position
-     * @type {number}
+     * @internal
      */
     _f: number;
     /**
-     * @type {T[]}
+     * @internal
      */
     _a: T[];
+
     /**
      * default capacity `16`
      * @param ic initial capacity
@@ -35,7 +36,7 @@ export declare class Deque<T extends any> {
     push(s: T): void;
     shift(): T | undefined;
     // clear(): void;
-    get length(): number;
+    readonly length: number;
 }
 
 /**
@@ -95,6 +96,14 @@ export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
 };
 export declare type TVoidFunction = () => void;
 
+export declare type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export declare type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+};
 
 /**
  * #### Mini Semaphore
@@ -160,7 +169,7 @@ export declare class MiniSemaphore implements TFlowableLock {
 }
 
 /**
- * object implementation of `IFlowableLock`
+ * object implementation of `TFlowableLock`
  *
  *   + constructs a semaphore object limited at `capacity`
  *
@@ -168,7 +177,18 @@ export declare class MiniSemaphore implements TFlowableLock {
  * @date 2020/2/7
  * @version 1.0
  */
-export declare const create: (capacity: number) => IFlowableLock;
+export declare const create: (capacity: number) => TFlowableLock;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ * 
+ *   + constructs a semaphore object limited at `capacity`
+ * 
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
+
 
 declare namespace fr {
     /**

package/esm/index.mjs

@@ -1,5 +1,5 @@
 export { MiniSemaphore } from "./class.mjs";
-export { create } from "./object.mjs";
+export { create, createWithAbort } from "./object.mjs";
 export { Deque } from "./deque.mjs";
 export { restrictor } from "./flow-restrictor.mjs";
-export const version = "v1.3.16";
+export const version = "v1.4.2";

package/esm/object.mjs

@@ -14,6 +14,26 @@ import * as core from "./core.mjs";
 import { Deque } from "./deque.mjs";
 const a = core.acquire;
 const r = core.release;
+const aa = core.acquireWithAbort;
+const ra = core.releaseWithAbort;
+/**
+ * @template {core.IFlowableLock & { q: Deque<unknown>}} T
+ * @param {number} capacity
+ * @returns
+ */
+const createBase = (capacity) => {
+    return /** @type {T} */ ({
+        capacity,
+        limit: capacity,
+        q: new Deque(capacity),
+        /**
+         * @param {number} restriction
+         */
+        setRestriction(restriction) {
+            this.limit = this.capacity = restriction;
+        },
+    });
+};
 /**
  * object implementation of `IFlowableLock`
  *
@@ -24,10 +44,13 @@ const r = core.release;
  * @version 1.0
  */
 export const create = (capacity) => {
+    /** @type {core.TFlowableLock} */
+    const base = createBase(capacity);
     return /** @satisfies {core.TFlowableLock} */ ({
-        capacity,
-        limit: capacity,
-        q: new Deque(capacity),
+        ...base,
+        get pending() {
+            return this.q.length;
+        },
         /**
          *
          * @param {boolean} [lazy]
@@ -40,28 +63,75 @@ export const create = (capacity) => {
             r(this);
         },
         /**
-         * @param {number} restriction
+         * @template {any} T
+         * @param {() => Promise<T>} process
+         * @param {boolean} [lazy]
+         * @returns {Promise<T>}
          */
-        setRestriction(restriction) {
-            this.limit = this.capacity = restriction;
-        },
+        async flow(process, lazy) {
+            await a(this, lazy);
+            try {
+                return await process();
+            }
+            finally {
+                r(this);
+            }
+        }
+    });
+};
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ *
+ *   + constructs a semaphore object limited at `capacity`
+ *
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export const createWithAbort = (capacity) => {
+    /** @type {core.TFlowableLockWithAbort} */
+    const base = createBase(capacity);
+    return /** @satisfies {core.TFlowableLockWithAbort} */ ({
+        ...base,
         get pending() {
             return this.q.length;
         },
+        /**
+         * @returns {Promise<void>}
+         */
+        acquire() {
+            return aa(this);
+        },
+        release() {
+            ra(this);
+        },
         /**
          * @template {any} T
          * @param {() => Promise<T>} process
-         * @param {boolean} [lazy]
          * @returns {Promise<T>}
          */
-        async flow(process, lazy) {
-            await a(this, lazy);
+        async flow(process) {
+            await aa(this);
             try {
                 return await process();
             }
             finally {
-                r(this);
+                ra(this);
+            }
+        },
+        /**
+         * @throws {AggregateError} description
+         */
+        abort() {
+            const dq = this.q;
+            let resolver;
+            const reason = {
+                message: "Process Aborted"
+            };
+            while (resolver = dq.shift()) {
+                resolver.reject(reason);
             }
+            this.capacity = this.limit;
         }
     });
 };

package/index.d.ts

@@ -7,23 +7,24 @@
 export declare class Deque<T extends any> {
     /**
      * capacity
-     * @type {number}
+     * @internal
      */
     _c: number;
     /**
      * current length (size
-     * @type {number}
+     * @internal
      */
     _l: number;
     /**
      * current front position
-     * @type {number}
+     * @internal
      */
     _f: number;
     /**
-     * @type {T[]}
+     * @internal
      */
     _a: T[];
+
     /**
      * default capacity `16`
      * @param ic initial capacity
@@ -35,7 +36,7 @@ export declare class Deque<T extends any> {
     push(s: T): void;
     shift(): T | undefined;
     // clear(): void;
-    get length(): number;
+    readonly length: number;
 }
 
 /**
@@ -95,6 +96,14 @@ export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
 };
 export declare type TVoidFunction = () => void;
 
+export declare type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export declare type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+};
 
 /**
  * #### Mini Semaphore
@@ -160,7 +169,7 @@ export declare class MiniSemaphore implements TFlowableLock {
 }
 
 /**
- * object implementation of `IFlowableLock`
+ * object implementation of `TFlowableLock`
  *
  *   + constructs a semaphore object limited at `capacity`
  *
@@ -168,7 +177,18 @@ export declare class MiniSemaphore implements TFlowableLock {
  * @date 2020/2/7
  * @version 1.0
  */
-export declare const create: (capacity: number) => IFlowableLock;
+export declare const create: (capacity: number) => TFlowableLock;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ * 
+ *   + constructs a semaphore object limited at `capacity`
+ * 
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
+
 
 declare namespace fr {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mini-semaphore",
-  "version": "1.3.16",
+  "version": "1.4.2",
   "description": "A lightweight version of Semaphore",
   "private": false,
   "main": "./cjs/index.js",

package/umd/index.d.ts

@@ -7,23 +7,24 @@
 export declare class Deque<T extends any> {
     /**
      * capacity
-     * @type {number}
+     * @internal
      */
     _c: number;
     /**
      * current length (size
-     * @type {number}
+     * @internal
      */
     _l: number;
     /**
      * current front position
-     * @type {number}
+     * @internal
      */
     _f: number;
     /**
-     * @type {T[]}
+     * @internal
      */
     _a: T[];
+
     /**
      * default capacity `16`
      * @param ic initial capacity
@@ -35,7 +36,7 @@ export declare class Deque<T extends any> {
     push(s: T): void;
     shift(): T | undefined;
     // clear(): void;
-    get length(): number;
+    readonly length: number;
 }
 
 /**
@@ -95,6 +96,14 @@ export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
 };
 export declare type TVoidFunction = () => void;
 
+export declare type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export declare type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+};
 
 /**
  * #### Mini Semaphore
@@ -160,7 +169,7 @@ export declare class MiniSemaphore implements TFlowableLock {
 }
 
 /**
- * object implementation of `IFlowableLock`
+ * object implementation of `TFlowableLock`
  *
  *   + constructs a semaphore object limited at `capacity`
  *
@@ -168,7 +177,18 @@ export declare class MiniSemaphore implements TFlowableLock {
  * @date 2020/2/7
  * @version 1.0
  */
-export declare const create: (capacity: number) => IFlowableLock;
+export declare const create: (capacity: number) => TFlowableLock;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ * 
+ *   + constructs a semaphore object limited at `capacity`
+ * 
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
+
 
 declare namespace fr {
     /**

package/umd/index.js

@@ -1,7 +1,7 @@
 /*! For license information please see index.js.LICENSE.txt */
-((e,t)=>{'object'==typeof exports&&'object'==typeof module?module.exports=t():'function'==typeof define&&define.amd?define([],t):'object'==typeof exports?exports.MiniSema=t():e.MiniSema=t()})(globalThis,(()=>(()=>{"use strict";var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.create=void 0;const r=i(461),n=i(761),s=r.acquire,o=r.release;t.create=e=>({capacity:e,limit:e,q:new n.Deque(e),acquire(e){return s(this,e)},release(){o(this)},setRestriction(e){this.limit=this.capacity=e},get pending(){return this.q.length},async flow(e,t){await s(this,t);try{return await e()}finally{o(this)}}})},461:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.release=t.acquire=void 0;const i=()=>{
-throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise((i=>{t?setTimeout((()=>r(e,i)),4):r(e,i)}));t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)}},464:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const o=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),
-new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),a=o.flow(s);return o.last=Date.now(),a}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1);const n=i,s=Object.create(null),o=Object.keys(n);let a,c=0;!e&&(e=1),e*=1e3,r&&(a=[]);for(let t=0,i=o.length;t<i;){const i=o[t++],l=n[i];l.last&&Date.now()-l.last>=e?(c++,r&&a.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${a.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),c},multi:n,one:async function(e,t){return n(e,1,t)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0
-;const r=i(461),n=i(761),s=r.acquire,o=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){o(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{o(this)}}}},761:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e-=1,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e),this._l=0,this._f=0,this._a=[]}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t]
-;return this._a[t]=void 0,this._f=t+1&this._c-1,this._l=e-1,i}get length(){return this._l}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}};return e[r](s,s.exports,i),s.exports}var r={};return(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.create=e.MiniSemaphore=void 0;var t=i(518);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}});var s=i(761);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){
-return s.Deque}});var o=i(464);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return o.restrictor}}),e.version="v1.3.16"})(),r})()));
+((e,t)=>{'object'==typeof exports&&'object'==typeof module?module.exports=t():'function'==typeof define&&define.amd?define([],t):'object'==typeof exports?exports.MiniSema=t():e.MiniSema=t()})(globalThis,(()=>(()=>{"use strict";var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release,o=r.acquireWithAbort,c=r.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}});t.createWithAbort=e=>({...l(e),get pending(){return this.q.length},acquire(){return o(this)},release(){
+c(this)},async flow(e){await o(this);try{return await e()}finally{c(this)}},abort(){const e=this.q;let t;const i={message:"Process Aborted"};for(;t=e.shift();)t.reject(i);this.capacity=this.limit}})},461:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise((i=>{t?setTimeout((()=>r(e,i)),4):r(e,i)}));t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)};t.acquireWithAbort=e=>new Promise(((t,i)=>{
+e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:i})}));t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e?e.resolve():i()}else e.capacity<e.limit&&e.capacity++}},464:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),o=a.flow(s);return a.last=Date.now(),o}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},
+cleanup:async(e,r)=>{await t.acquire(!1);const n=i,s=Object.create(null),a=Object.keys(n);let o,c=0;!e&&(e=1),e*=1e3,r&&(o=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(c++,r&&o.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${o.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),c},multi:n,one:async function(e,t){return n(e,1,t)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{
+return await e()}finally{a(this)}}}},761:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e||16),this._l=0,this._f=0,this._a=[],this.length=0}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this.length=this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=this._l=e-1,i}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var n=t[r]
+;if(void 0!==n)return n.exports;var s=t[r]={exports:{}};return e[r](s,s.exports,i),s.exports}var r={};return(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=i(518);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=i(761);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(464);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.4.2"})(),r})()));

package/webpack/index.d.ts

@@ -7,23 +7,24 @@
 export declare class Deque<T extends any> {
     /**
      * capacity
-     * @type {number}
+     * @internal
      */
     _c: number;
     /**
      * current length (size
-     * @type {number}
+     * @internal
      */
     _l: number;
     /**
      * current front position
-     * @type {number}
+     * @internal
      */
     _f: number;
     /**
-     * @type {T[]}
+     * @internal
      */
     _a: T[];
+
     /**
      * default capacity `16`
      * @param ic initial capacity
@@ -35,7 +36,7 @@ export declare class Deque<T extends any> {
     push(s: T): void;
     shift(): T | undefined;
     // clear(): void;
-    get length(): number;
+    readonly length: number;
 }
 
 /**
@@ -95,6 +96,14 @@ export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
 };
 export declare type TVoidFunction = () => void;
 
+export declare type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export declare type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+};
 
 /**
  * #### Mini Semaphore
@@ -160,7 +169,7 @@ export declare class MiniSemaphore implements TFlowableLock {
 }
 
 /**
- * object implementation of `IFlowableLock`
+ * object implementation of `TFlowableLock`
  *
  *   + constructs a semaphore object limited at `capacity`
  *
@@ -168,7 +177,18 @@ export declare class MiniSemaphore implements TFlowableLock {
  * @date 2020/2/7
  * @version 1.0
  */
-export declare const create: (capacity: number) => IFlowableLock;
+export declare const create: (capacity: number) => TFlowableLock;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ * 
+ *   + constructs a semaphore object limited at `capacity`
+ * 
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
+
 
 declare namespace fr {
     /**

package/webpack/index.js

@@ -1,6 +1,7 @@
 /*! For license information please see index.js.LICENSE.txt */
-(()=>{"use strict";var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.create=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release;t.create=e=>({capacity:e,limit:e,q:new n.Deque(e),acquire(e){return s(this,e)},release(){a(this)},setRestriction(e){this.limit=this.capacity=e},get pending(){return this.q.length},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}})},461:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise((i=>{t?setTimeout((()=>r(e,i)),4):r(e,i)}));t.release=e=>{let t
-;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)}},464:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),c=a.flow(s);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1)
-;const n=i,s=Object.create(null),a=Object.keys(n);let c,o=0;!e&&(e=1),e*=1e3,r&&(c=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(o++,r&&c.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),o},multi:n,one:async function(e,t){return n(e,1,t)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},
-761:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e-=1,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e),this._l=0,this._f=0,this._a=[]}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this._l=e-1,i}get length(){return this._l}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}}
-;return e[r](s,s.exports,i),s.exports}var r={};(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.restrictor=e.Deque=e.create=e.MiniSemaphore=void 0;var t=i(518);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}});var s=i(761);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(464);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.3.16"})(),module.exports=r})();
+(()=>{"use strict";var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release,c=r.acquireWithAbort,o=r.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new n.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return s(this,e)},release(){a(this)},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}});t.createWithAbort=e=>({...l(e),get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){await c(this);try{return await e()}finally{o(this)}},abort(){const e=this.q;let t;const i={message:"Process Aborted"};for(;t=e.shift();)t.reject(i);this.capacity=this.limit}})},461:(e,t)=>{
+Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise((i=>{t?setTimeout((()=>r(e,i)),4):r(e,i)}));t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)};t.acquireWithAbort=e=>new Promise(((t,i)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:i})}));t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e?e.resolve():i()}else e.capacity<e.limit&&e.capacity++}},464:(e,t,i)=>{
+Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),c=a.flow(s);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1);const n=i,s=Object.create(null),a=Object.keys(n);let c,o=0;!e&&(e=1),e*=1e3,r&&(c=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(o++,
+r&&c.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),o},multi:n,one:async function(e,t){return n(e,1,t)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},761:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,
+1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e||16),this._l=0,this._f=0,this._a=[],this.length=0}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this.length=this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=this._l=e-1,i}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}};return e[r](s,s.exports,i),s.exports}var r={};(()=>{var e=r;Object.defineProperty(e,"__esModule",{value:!0}),
+e.version=e.restrictor=e.Deque=e.createWithAbort=e.create=e.MiniSemaphore=void 0;var t=i(518);Object.defineProperty(e,"MiniSemaphore",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);Object.defineProperty(e,"create",{enumerable:!0,get:function(){return n.create}}),Object.defineProperty(e,"createWithAbort",{enumerable:!0,get:function(){return n.createWithAbort}});var s=i(761);Object.defineProperty(e,"Deque",{enumerable:!0,get:function(){return s.Deque}});var a=i(464);Object.defineProperty(e,"restrictor",{enumerable:!0,get:function(){return a.restrictor}}),e.version="v1.4.2"})(),module.exports=r})();

package/webpack-esm/index.d.mts

@@ -7,23 +7,24 @@
 export declare class Deque<T extends any> {
     /**
      * capacity
-     * @type {number}
+     * @internal
      */
     _c: number;
     /**
      * current length (size
-     * @type {number}
+     * @internal
      */
     _l: number;
     /**
      * current front position
-     * @type {number}
+     * @internal
      */
     _f: number;
     /**
-     * @type {T[]}
+     * @internal
      */
     _a: T[];
+
     /**
      * default capacity `16`
      * @param ic initial capacity
@@ -35,7 +36,7 @@ export declare class Deque<T extends any> {
     push(s: T): void;
     shift(): T | undefined;
     // clear(): void;
-    get length(): number;
+    readonly length: number;
 }
 
 /**
@@ -95,6 +96,14 @@ export declare type TFlowableLock<T = TVoidFunction> = IFlowableLock & {
 };
 export declare type TVoidFunction = () => void;
 
+export declare type TResolver = {
+    resolve: () => void;
+    reject: (reason: any) => void;
+};
+export declare type TFlowableLockWithAbort = IFlowableLock & {
+    readonly q: Deque<TResolver>;
+    abort(): void;
+};
 
 /**
  * #### Mini Semaphore
@@ -160,7 +169,7 @@ export declare class MiniSemaphore implements TFlowableLock {
 }
 
 /**
- * object implementation of `IFlowableLock`
+ * object implementation of `TFlowableLock`
  *
  *   + constructs a semaphore object limited at `capacity`
  *
@@ -168,7 +177,18 @@ export declare class MiniSemaphore implements TFlowableLock {
  * @date 2020/2/7
  * @version 1.0
  */
-export declare const create: (capacity: number) => IFlowableLock;
+export declare const create: (capacity: number) => TFlowableLock;
+/**
+ * object implementation of `TFlowableLockWithAbort`
+ * 
+ *   + constructs a semaphore object limited at `capacity`
+ * 
+ * @param {number} capacity limitation of concurrent async by `capacity`
+ * @date 2025/5/12
+ * @version 1.4
+ */
+export declare const createWithAbort: (capacity: number) => TFlowableLockWithAbort;
+
 
 declare namespace fr {
     /**

package/webpack-esm/index.mjs

@@ -1,6 +1,7 @@
 /*! For license information please see index.js.LICENSE.txt */
-var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.create=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release;t.create=e=>({capacity:e,limit:e,q:new n.Deque(e),acquire(e){return s(this,e)},release(){a(this)},setRestriction(e){this.limit=this.capacity=e},get pending(){return this.q.length},async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}})},461:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise((i=>{t?setTimeout((()=>r(e,i)),4):r(e,i)}));t.release=e=>{let t
-;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)}},464:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function n(r,n,s){const a=await(async(r,n)=>{await t.acquire(!1);let s=i[r];if(s||(i[r]=s=new e(n)),s.limit!==n)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${s.limit} <-> restriction: ${n},`);return t.release(),s})(r,n),c=a.flow(s);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1)
-;const n=i,s=Object.create(null),a=Object.keys(n);let c,o=0;!e&&(e=1),e*=1e3,r&&(c=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=n[i];l.last&&Date.now()-l.last>=e?(o++,r&&c.push(i)):s[i]=l}return i=s,t.release(),r&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(s).join(",\n")}\n]`),o},multi:n,one:async function(e,t){return n(e,1,t)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),n=i(761),s=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new n.Deque(e)}acquire(e){return s(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await s(this,t);try{return await e()}finally{a(this)}}}},
-761:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e-=1,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e),this._l=0,this._f=0,this._a=[]}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const n=this._f+t&this._c-1;this._a[n]=e,this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this._l=e-1,i}get length(){return this._l}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,n)=>{for(let s=0;s<n;++s)i[s+r]=e[s+t],e[s+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var n=t[r];if(void 0!==n)return n.exports;var s=t[r]={exports:{}}
-;return e[r](s,s.exports,i),s.exports}var r={};(()=>{var e=r;Object.defineProperty(e,"BJ",{value:!0}),e.rE=e.Ws=e.Jj=e.vt=e.C=void 0;var t=i(518);Object.defineProperty(e,"C",{enumerable:!0,get:function(){return t.MiniSemaphore}});var n=i(139);Object.defineProperty(e,"vt",{enumerable:!0,get:function(){return n.create}});var s=i(761);Object.defineProperty(e,"Jj",{enumerable:!0,get:function(){return s.Deque}});var a=i(464);Object.defineProperty(e,"Ws",{enumerable:!0,get:function(){return a.restrictor}}),e.rE="v1.3.16"})();const n=r.Jj,s=r.C,a=r.BJ,c=r.vt,o=r.Ws,l=r.rE;export{n as Deque,s as MiniSemaphore,a as __esModule,c as create,o as restrictor,l as version};
+var e={139:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.createWithAbort=t.create=void 0;const r=i(461),s=i(761),n=r.acquire,a=r.release,c=r.acquireWithAbort,o=r.releaseWithAbort,l=e=>({capacity:e,limit:e,q:new s.Deque(e),setRestriction(e){this.limit=this.capacity=e}});t.create=e=>({...l(e),get pending(){return this.q.length},acquire(e){return n(this,e)},release(){a(this)},async flow(e,t){await n(this,t);try{return await e()}finally{a(this)}}});t.createWithAbort=e=>({...l(e),get pending(){return this.q.length},acquire(){return c(this)},release(){o(this)},async flow(e){await c(this);try{return await e()}finally{o(this)}},abort(){const e=this.q;let t;const i={message:"Process Aborted"};for(;t=e.shift();)t.reject(i);this.capacity=this.limit}})},461:(e,t)=>{
+Object.defineProperty(t,"__esModule",{value:!0}),t.releaseWithAbort=t.acquireWithAbort=t.release=t.acquire=void 0;const i=()=>{throw new Error("mini-semaphore: Detected an inconsistent state, possibly due to a logic error or unexpected behavior.")},r=(e,t)=>{e.capacity>0?(e.capacity--,t()):e.q.push(t)};t.acquire=(e,t=!0)=>new Promise((i=>{t?setTimeout((()=>r(e,i)),4):r(e,i)}));t.release=e=>{let t;(t=e.q).length?(t.shift()||i)():e.capacity++,e.capacity>e.limit&&(console.warn("inconsistent release!"),e.capacity=e.limit)};t.acquireWithAbort=e=>new Promise(((t,i)=>{e.capacity>0?(e.capacity--,t()):e.q.push({resolve:t,reject:i})}));t.releaseWithAbort=e=>{let t;if((t=e.q).length){const e=t.shift();e?e.resolve():i()}else e.capacity<e.limit&&e.capacity++}},464:(e,t,i)=>{
+Object.defineProperty(t,"__esModule",{value:!0}),t.restrictor=void 0;const r=i(518);t.restrictor=(()=>{const{MiniSemaphore:e}=r,t=new e(1);let i=Object.create(null);async function s(r,s,n){const a=await(async(r,s)=>{await t.acquire(!1);let n=i[r];if(n||(i[r]=n=new e(s)),n.limit!==s)throw t.release(),new ReferenceError(`Cannot get object with different restriction: key: '${String(r)}', lock.limit: ${n.limit} <-> restriction: ${s},`);return t.release(),n})(r,s),c=a.flow(n);return a.last=Date.now(),c}return{getLockByKey:async e=>{await t.acquire(!1);const r=i[e];return t.release(),r},cleanup:async(e,r)=>{await t.acquire(!1);const s=i,n=Object.create(null),a=Object.keys(s);let c,o=0;!e&&(e=1),e*=1e3,r&&(c=[]);for(let t=0,i=a.length;t<i;){const i=a[t++],l=s[i];l.last&&Date.now()-l.last>=e?(o++,
+r&&c.push(i)):n[i]=l}return i=n,t.release(),r&&console.log(`eliminated: [\n${c.join(",\n")}\n]\nlived: [\n${Object.keys(n).join(",\n")}\n]`),o},multi:s,one:async function(e,t){return s(e,1,t)}}})()},518:(e,t,i)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.MiniSemaphore=void 0;const r=i(461),s=i(761),n=r.acquire,a=r.release;t.MiniSemaphore=class{constructor(e){this.limit=this.capacity=e,this.q=new s.Deque(e)}acquire(e){return n(this,e)}release(){a(this)}setRestriction(e){this.limit=this.capacity=e}get pending(){return this.q.length}async flow(e,t){await n(this,t);try{return await e()}finally{a(this)}}}},761:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Deque=void 0;const i=e=>(e=>(e>>>=0,e--,e|=e>>1,e|=e>>2,e|=e>>4,e|=e>>8,
+1+(e|=e>>16)))(Math.min(Math.max(16,0|e),1073741824));t.Deque=class{constructor(e){this._c=i(e||16),this._l=0,this._f=0,this._a=[],this.length=0}push(e){const t=this._l;this._c<t+1&&r(this,i(1.5*this._c+16));const s=this._f+t&this._c-1;this._a[s]=e,this.length=this._l=t+1}shift(){const e=this._l;if(0===e)return;const t=this._f,i=this._a[t];return this._a[t]=void 0,this._f=t+1&this._c-1,this.length=this._l=e-1,i}};const r=(e,t)=>{const i=e._c;e._c=t;const r=e._f+e._l;if(r>i){const t=r&i-1;((e,t,i,r,s)=>{for(let n=0;n<s;++n)i[n+r]=e[n+t],e[n+t]=void 0})(e._a,0,e._a,i,t)}}}},t={};function i(r){var s=t[r];if(void 0!==s)return s.exports;var n=t[r]={exports:{}};return e[r](n,n.exports,i),n.exports}var r={};(()=>{var e=r;Object.defineProperty(e,"BJ",{value:!0}),e.rE=e.Ws=e.Jj=e.Xz=e.vt=e.C=void 0
+;var t=i(518);Object.defineProperty(e,"C",{enumerable:!0,get:function(){return t.MiniSemaphore}});var s=i(139);Object.defineProperty(e,"vt",{enumerable:!0,get:function(){return s.create}}),Object.defineProperty(e,"Xz",{enumerable:!0,get:function(){return s.createWithAbort}});var n=i(761);Object.defineProperty(e,"Jj",{enumerable:!0,get:function(){return n.Deque}});var a=i(464);Object.defineProperty(e,"Ws",{enumerable:!0,get:function(){return a.restrictor}}),e.rE="v1.4.2"})();const s=r.Jj,n=r.C,a=r.BJ,c=r.vt,o=r.Xz,l=r.Ws,h=r.rE;export{s as Deque,n as MiniSemaphore,a as __esModule,c as create,o as createWithAbort,l as restrictor,h as version};