@creejs/commons-collection 2.0.3 → 2.0.5

package/dist/cjs/index-dev.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function a$1(t){return "boolean"==typeof t}function c$1(t){return "function"==typeof t}function l$1(t){return null!=t&&"object"==typeof t&&!A(t)}function y(t){return null==t}function p$1(t){return !!m$1(t)&&t>0}function h$1(t){return !!m$1(t)&&t>=0}function g$1(t){return !!m$1(t)&&t<0}function w$1(t){return null===t}function d$1(t){return void 0===t}function m$1(t){return null!=t&&"number"==typeof t}function b$1(t){return null!=t&&"object"==typeof t}function A(t){return null!==t&&"object"==typeof t&&(t.constructor===Object||void 0===t.constructor)}function E(t){return null!=t&&"function"==typeof t.then}function N(t){return null!=t&&"string"==typeof t}function $(t){return null!=t&&"symbol"==typeof t}function O$1(t){return ArrayBuffer.isView(t)&&t.constructor!==DataView}function v$1(t){return t instanceof Int8Array}function j(t){return t instanceof Uint8Array}function P(t){return t instanceof Uint8ClampedArray}function S(t){return t instanceof Int16Array}function x(t){return t instanceof Uint16Array}function U(t){return t instanceof Int32Array}function T(t){return t instanceof Uint32Array}function I(t){return t instanceof Float32Array}function B(t){return t instanceof Float64Array}function k$1(t){return t instanceof BigInt64Array}function L$1(t){return t instanceof BigUint64Array}function F(t){return t instanceof ArrayBuffer}var C={assertNumber:q,assertPositive:_$1,assertNegative:function(t,r){if(!g$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Negative: ${t}`)},assertNotNegative:J,assertBoolean:function(t,r){if(!a$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Boolean: type=${typeof t} value=${Z(t)}`)},assertObject:R,assertPlainObject:function(t,r){if(!A(t))throw new Error(`${r?'"'+r+'" ':""}Not PlainObject: type=${typeof t} value=${Z(t)}`)},assertSymbol:function(t,r){if(!$(t))throw new Error(`${r?'"'+r+'" ':""}Not Symbol: type=${typeof t} value=${Z(t)}`)},assertFunction:W,assertInstance:function(t,r){if(!l$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Class Instance: type=${typeof t} value=${Z(t)}`)},assertPromise:H,assertNil:function(t,r){if(!y(t))throw new Error(`${r?'"'+r+'" ':""}Neither Null nor Undefined: type=${typeof t} value=${Z(t)}`)},assertNotNil:V,assertNull:function(t,r){if(!w$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Null: type=${typeof t} value=${Z(t)}`)},assertNotNull:function(t,r){if(w$1(t))throw new Error((r?'"'+r+'" ':"")+"Should Not Null")},assertUndefined:function(t,r){if(!d$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Undefined: type=${typeof t} value=${Z(t)}`)},assertString:M,assertArray:D,assertStringOrSymbol:function(t,r){if(!N(t)&&!$(t))throw new Error(`${r?'"'+r+'" ':""}Not String or Symbol: type=${typeof t} value=${Z(t)}`)},assertInt8Array:function(t,r){if(v$1(t))throw new Error((r?'"'+r+'" ':"")+"Not Int8Array")},assertUint8Array:function(t,r){if(j(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint8Array")},assertUint8ClampedArray:function(t,r){if(P(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint8ClampedArray")},assertInt16Array:function(t,r){if(S(t))throw new Error((r?'"'+r+'" ':"")+"Not Int16Array")},assertUint16Array:function(t,r){if(x(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint16Array")},assertInt32Array:function(t,r){if(U(t))throw new Error((r?'"'+r+'" ':"")+"Not Int32Array")},assertUint32Array:function(t,r){if(T(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint32Array")},assertFloat32Array:function(t,r){if(I(t))throw new Error((r?'"'+r+'" ':"")+"Not Float32Array")},assertFloat64Array:function(t,r){if(B(t))throw new Error((r?'"'+r+'" ':"")+"Not Float64Array")},assertBigInt64Array:function(t,r){if(k$1(t))throw new Error((r?'"'+r+'" ':"")+"Not BigInt64Array")},assertBigUint64Array:function(t,r){if(L$1(t))throw new Error((r?'"'+r+'" ':"")+"Not BigUint64Array")},assertTypedArray:function(t,r){if(O$1(t))throw new Error((r?'"'+r+'" ':"")+"Not TypedArray")},assertArrayBuffer:z};function D(t,r){if(!Array.isArray(t))throw new Error(`${r?'"'+r+'" ':""}Not Array: type=${typeof t} value=${Z(t)}`)}function M(t,r){if(!N(t))throw new Error(`${r?'"'+r+'" ':""}Not String: type=${typeof t} value=${Z(t)}`)}function q(t,r){if(!m$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Number: type=${typeof t} value=${Z(t)}`)}function _$1(t,r){if(!p$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Positive: ${t}`)}function J(t,r){if(!h$1(t))throw new Error(`${r?'"'+r+'" ':""}Not "0 or Positive": ${t}`)}function R(t,r){if(!b$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Object: type=${typeof t} value=${Z(t)}`)}function W(t,r){if(!c$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Function: type=${typeof t} value=${Z(t)}`)}function H(t,r){if(!E(t))throw new Error(`${r?'"'+r+'" ':""}Not Promise: type=${typeof t} value=${Z(t)}`)}function V(t,r){if(y(t))throw new Error((r?'"'+r+'" ':"")+"Should Not Nil")}function z(t,r){if(!F(t))throw new Error((r?'"'+r+'" ':"")+"Not ArrayBuffer")}function Z(t){if(null===t)return "null";if(void 0===t)return "undefined";let r;try{r=JSON.stringify(t);}catch(e){r=t.toString();}return r}new TextDecoder;new TextEncoder;const dt=1e6;var mt={s2ns:1e9,ms2ns:dt,timestamp:function(){if("undefined"!=typeof performance&&"number"==typeof performance.timeOrigin){const t=performance.timeOrigin,r=performance.now();return Math.ceil((t+r)/dt)}return Date.now()},timestamp64:bt,lapseNano:At,lapseMillis:Et,timeoutNano:function(t,r){return At(t)>r},timeoutMillis:function(t,r){return Et(t)>r}};function bt(){if("undefined"!=typeof performance&&"number"==typeof performance.timeOrigin){const t=performance.timeOrigin,r=performance.now();return BigInt((t+r)*dt)}return BigInt(Date.now()*dt)}function At(t,r){return (r??bt())-t}function Et(t,r){r=r??bt();return BigInt(r-t)/BigInt(dt)}
+function a$1(t){return "boolean"==typeof t}function c$1(t){return "function"==typeof t}function l$1(t){return null!=t&&"object"==typeof t&&!A(t)}function y(t){return null==t}function p$1(t){return !!m$1(t)&&t>0}function h$1(t){return !!m$1(t)&&t>=0}function g$1(t){return !!m$1(t)&&t<0}function w$1(t){return null===t}function d$1(t){return void 0===t}function m$1(t){return null!=t&&"number"==typeof t}function b$1(t){return null!=t&&"object"==typeof t}function A(t){return null!==t&&"object"==typeof t&&(t.constructor===Object||void 0===t.constructor)}function E(t){return null!=t&&"function"==typeof t.then}function N(t){return null!=t&&"string"==typeof t}function $(t){return null!=t&&"symbol"==typeof t}function O$1(t){return ArrayBuffer.isView(t)&&t.constructor!==DataView}function v$1(t){return t instanceof Int8Array}function P(t){return t instanceof Uint8Array}function j(t){return t instanceof Uint8ClampedArray}function S(t){return t instanceof Int16Array}function x(t){return t instanceof Uint16Array}function U(t){return t instanceof Int32Array}function T(t){return t instanceof Uint32Array}function I(t){return t instanceof Float32Array}function B(t){return t instanceof Float64Array}function k$1(t){return t instanceof BigInt64Array}function L$1(t){return t instanceof BigUint64Array}function F(t){return t instanceof ArrayBuffer}var C={assertNumber:q,assertPositive:_$1,assertNegative:function(t,r){if(!g$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Negative: ${t}`)},assertNotNegative:R,assertBoolean:function(t,r){if(!a$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Boolean: type=${typeof t} value=${Z(t)}`)},assertObject:J,assertPlainObject:function(t,r){if(!A(t))throw new Error(`${r?'"'+r+'" ':""}Not PlainObject: type=${typeof t} value=${Z(t)}`)},assertSymbol:function(t,r){if(!$(t))throw new Error(`${r?'"'+r+'" ':""}Not Symbol: type=${typeof t} value=${Z(t)}`)},assertFunction:W,assertInstance:function(t,r){if(!l$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Class Instance: type=${typeof t} value=${Z(t)}`)},assertPromise:H,assertNil:function(t,r){if(!y(t))throw new Error(`${r?'"'+r+'" ':""}Neither Null nor Undefined: type=${typeof t} value=${Z(t)}`)},assertNotNil:V,assertNull:function(t,r){if(!w$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Null: type=${typeof t} value=${Z(t)}`)},assertNotNull:function(t,r){if(w$1(t))throw new Error((r?'"'+r+'" ':"")+"Should Not Null")},assertUndefined:function(t,r){if(!d$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Undefined: type=${typeof t} value=${Z(t)}`)},assertString:D,assertArray:M,assertStringOrSymbol:function(t,r){if(!N(t)&&!$(t))throw new Error(`${r?'"'+r+'" ':""}Not String or Symbol: type=${typeof t} value=${Z(t)}`)},assertInt8Array:function(t,r){if(v$1(t))throw new Error((r?'"'+r+'" ':"")+"Not Int8Array")},assertUint8Array:function(t,r){if(P(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint8Array")},assertUint8ClampedArray:function(t,r){if(j(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint8ClampedArray")},assertInt16Array:function(t,r){if(S(t))throw new Error((r?'"'+r+'" ':"")+"Not Int16Array")},assertUint16Array:function(t,r){if(x(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint16Array")},assertInt32Array:function(t,r){if(U(t))throw new Error((r?'"'+r+'" ':"")+"Not Int32Array")},assertUint32Array:function(t,r){if(T(t))throw new Error((r?'"'+r+'" ':"")+"Not Uint32Array")},assertFloat32Array:function(t,r){if(I(t))throw new Error((r?'"'+r+'" ':"")+"Not Float32Array")},assertFloat64Array:function(t,r){if(B(t))throw new Error((r?'"'+r+'" ':"")+"Not Float64Array")},assertBigInt64Array:function(t,r){if(k$1(t))throw new Error((r?'"'+r+'" ':"")+"Not BigInt64Array")},assertBigUint64Array:function(t,r){if(L$1(t))throw new Error((r?'"'+r+'" ':"")+"Not BigUint64Array")},assertTypedArray:function(t,r){if(O$1(t))throw new Error((r?'"'+r+'" ':"")+"Not TypedArray")},assertArrayBuffer:z};function M(t,r){if(!Array.isArray(t))throw new Error(`${r?'"'+r+'" ':""}Not Array: type=${typeof t} value=${Z(t)}`)}function D(t,r){if(!N(t))throw new Error(`${r?'"'+r+'" ':""}Not String: type=${typeof t} value=${Z(t)}`)}function q(t,r){if(!m$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Number: type=${typeof t} value=${Z(t)}`)}function _$1(t,r){if(!p$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Positive: ${t}`)}function R(t,r){if(!h$1(t))throw new Error(`${r?'"'+r+'" ':""}Not "0 or Positive": ${t}`)}function J(t,r){if(!b$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Object: type=${typeof t} value=${Z(t)}`)}function W(t,r){if(!c$1(t))throw new Error(`${r?'"'+r+'" ':""}Not Function: type=${typeof t} value=${Z(t)}`)}function H(t,r){if(!E(t))throw new Error(`${r?'"'+r+'" ':""}Not Promise: type=${typeof t} value=${Z(t)}`)}function V(t,r){if(y(t))throw new Error((r?'"'+r+'" ':"")+"Should Not Nil")}function z(t,r){if(!F(t))throw new Error((r?'"'+r+'" ':"")+"Not ArrayBuffer")}var G={isEmpty:K,assertNotEmpty:Y,isBlank:Q,assertNotBlank:function(t,r){if(Q(t))throw new Error(`${r?'"'+r+'" ':""}Is Blank: ${t}`)},capitalize:function(t){if(D(t),0===t.length)return t;const r=t.charAt(0),e=r.toUpperCase();return r===e?t:e+t.slice(1)},decapitalize:function(t){if(D(t),0===t.length)return t;const r=t.charAt(0),e=r.toLowerCase();return r===e?t:e+t.slice(1)},splitWithFixedLength:function(t,r,e=" "){if(D(t),q(r),D(e),0===t.length)return [];if(r<=0)throw new Error("length muse >=0");if(t.length<r)return [t.padEnd(r,e)];const n=[];for(let o=0;o<t.length;o+=r){const i=t.substring(o,o+r);n.push(i.padEnd(r,e));}return n},split:function(t,...r){D(t);if(0===t.length)return [];const e=[...r];0===r.length&&r.push(",");const n=X(t,...e);if(0===n.length)return [];const o=[];let i="",s=0;for(const{marker:r,index:e}of n)i=t.substring(s,e),o.push(i),s=e+r.length;return i=t.substring(s),o.push(i),o},findMarkerPositions:function(t,...r){if(D(t),0===r.length)throw new Error("At least one marker must be provided");const e=[];for(const n of new Set(r)){if(K(n))continue;D(n);let r=t.indexOf(n);for(;-1!==r;)e.push({marker:n,index:r}),r=t.indexOf(n,r+n.length);}return e.sort((t,r)=>t.index-r.index),e},findMarkerPositionsRegex:X,substringBefore:function(t,r){if(D(t),D(r),0===t.length||0===r.length)return;const e=t.indexOf(r);if(-1===e)return;return t.substring(0,e)},substringBeforeLast:function(t,r){if(D(t),D(r),0===t.length||0===r.length)return;const e=t.lastIndexOf(r);if(-1===e)return;return t.substring(0,e)},substringAfter:function(t,r){if(D(t),D(r),0===t.length||0===r.length)return;const e=t.indexOf(r);if(-1===e)return;return t.substring(e+r.length)},substringAfterLast:function(t,r){if(D(t),D(r),0===t.length||0===r.length)return;const e=t.lastIndexOf(r);if(-1===e)return;return t.substring(e+r.length)},substringBetween:function(t,r,e){Y(t),Y(r),Y(e);const n=t.indexOf(r);if(-1===n)return;const o=t.indexOf(e,n+r.length);if(-1===o)return;return t.substring(n+r.length,o)},substringBetweenGreedy:function(t,r,e){Y(t),Y(r),Y(e);const n=t.indexOf(r);if(-1===n)return;const o=t.lastIndexOf(e);if(-1===o||o<=n)return;return t.substring(n+r.length,o)},substringsBetween:function(t,r,e){Y(t),Y(r),Y(e);const n=[];let o=0;for(;;){const i=t.indexOf(r,o);if(-1===i)break;const s=t.indexOf(e,i+r.length);if(-1===s)break;n.push(t.substring(i+r.length,s)),o=s+e.length;}return n},safeToString:Z};function K(t){return null==t||(D(t),0===t.length)}function Y(t,r){if(K(t))throw new Error(`${r?'"'+r+'" ':""}IsEmpty String: ${t}`)}function Q(t){return null==t||(D(t),0===t.trim().length)}function X(t,...r){if(D(t),0===r.length)throw new Error("At least one marker must be provided");const e=[...new Set(r.filter(t=>null!=t))].map(t=>(D(t),t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"))),n=new RegExp(e.map(t=>`(${t})`).join("|"),"g"),o=[];let i=null;for(;null!==(i=n.exec(t));){for(let t=1;t<i.length;t++)if(i[t]){o.push({marker:r[t-1],index:i.index});break}0===i[0].length&&n.lastIndex++;}return o}function Z(t){if(null===t)return "null";if(void 0===t)return "undefined";const r=typeof t;if("string"===r)return t;if("symbol"===r)return `Symbol(${t.description})`;if("function"===r)return `Function ${t.name}(){}`;if(t instanceof String)return t.toString();if(Number.isNaN(t))return "NaN";if(t===1/0)return "Infinity";if(t===-1/0)return "-Infinity";if(t instanceof Error)return `${t.constructor.name}: ${t.message}`;if(t instanceof Promise)return "Promise";if(t instanceof Set)return `Set: ${Z(Array.from(t))}`;if(t instanceof Map)return `Map: ${Z(Array.from(t.entries()))}`;if(t instanceof RegExp)return t.toString();if(Array.isArray(t))return `[${t.map(Z).join(", ")}]`;let e;try{e=JSON.stringify(t);}catch(r){e=t.toString();}return e}new TextDecoder;new TextEncoder;const dt=1e6;var mt={s2ns:1e9,ms2ns:dt,timestamp:function(){if("undefined"!=typeof performance&&"number"==typeof performance.timeOrigin){const t=performance.timeOrigin,r=performance.now();return Math.ceil((t+r)/dt)}return Date.now()},timestamp64:bt,lapseNano:At,lapseMillis:Et,timeoutNano:function(t,r){return At(t)>r},timeoutMillis:function(t,r){return Et(t)>r}};function bt(){if("undefined"!=typeof performance&&"number"==typeof performance.timeOrigin){const t=performance.timeOrigin,r=performance.now();return BigInt((t+r)*dt)}return BigInt(Date.now()*dt)}function At(t,r){return (r??bt())-t}function Et(t,r){r=r??bt();return BigInt(r-t)/BigInt(dt)}
 
 // internal
 // owned
@@ -16,7 +16,7 @@ function a$1(t){return "boolean"==typeof t}function c$1(t){return "function"==ty
  */
 
 // module vars
-const { assertPositive } = C;
+const { assertPositive: assertPositive$1 } = C;
 
 /**
  * A set that has a fixed capacity and automatically removes the oldest element when the capacity is reached.
@@ -31,7 +31,7 @@ class CappedSet {
    * @throws {Error} If capacity is less than or equal to 0
    */
   constructor (capacity) {
-    assertPositive(capacity, 'capacity');
+    assertPositive$1(capacity, 'capacity');
     this.capacity = capacity;
     /**
      * 1. key is the Value stored in CappedSet
@@ -184,8 +184,9 @@ var e={isFunction:t,isNil:s};function t(e){return "function"==typeof e}function
 /**
  * @typedef {number} Timestamp
  * @typedef {{
- *  tickInterval: number, // ms
- *  tickCount: number // ms
+ *  autoStart?:boolean, // default true
+ *  tickInterval?: number, // ms
+ *  tickCount?: number // ms
  * }} TimeWheelCacheOptions
  */
 
@@ -222,6 +223,11 @@ class TimeWheelCache extends k {
      * How many Ticks does the Wheel have
      */
     this._tickCount = this.options.tickCount ?? 60;
+    /**
+     * Whether auto start "AutoEvict"
+     * @type {boolean}
+     */
+    this._autoStart = this.options.autoStart ?? true;
     /**
      * Slots, one Tick owns one Slot to store key and expire timestamp
      * @type {Map<any, {value: any, slotIndex: number, expireTimestamp: number}>[]}
@@ -237,7 +243,7 @@ class TimeWheelCache extends k {
     this._timer = undefined;
 
     // must start it immediately
-    this._startAutoEvict();
+    this._autoStart && this._startAutoEvict();
   }
 
   get tickInterval () {
@@ -269,6 +275,10 @@ class TimeWheelCache extends k {
     return this._timer != null
   }
 
+  get autoStart () {
+    return this._autoStart
+  }
+
   _startAutoEvict () {
     this._timer = setInterval(() => this._advance(), this._tickInterval);
   }
@@ -388,7 +398,7 @@ class TimeWheelCache extends k {
     }
     if (wrapped.expireTimestamp <= mt.timestamp()) {
       this.delete(key);
-      this.emit('expired', key, wrapped.value, wrapped.expireTimestamp);
+      this.emit(Event$1.Expired, key, wrapped.value, wrapped.expireTimestamp);
       return false
     }
     return true
@@ -478,8 +488,9 @@ class Hour24TimeWheelCache extends k {
   /**
    *
    */
-  constructor () {
+  constructor (autoStart = true) {
     super();
+    this._autoStart = autoStart ?? true;
     /**
      * Second Wheel:
      * 1. 1 Tick Mark is 1 Second, is 1000 Milliseconds
@@ -490,7 +501,7 @@ class Hour24TimeWheelCache extends k {
      *   * 60   00:00:59.XXX -> 00:00:59.XXX   in   Slot60  Index59
      * @type {TimeWheelCache}
      */
-    this._secondWheel = new TimeWheelCache({ tickInterval: SecondInMillisecond, tickCount: 60 });
+    this._secondWheel = new TimeWheelCache({ tickInterval: SecondInMillisecond, tickCount: 60, autoStart });
     /**
      * Minute Wheel:
      * 1. 1 Tick Mark is 1 Minute, is 60 * 1000 Milliseconds
@@ -500,7 +511,7 @@ class Hour24TimeWheelCache extends k {
      *   * 60   00:59:00 -> 00:59:59   in   Slot60    Index59
      * @type {TimeWheelCache}
      */
-    this._minuteWheel = new TimeWheelCache({ tickInterval: MinuteInMillisecond, tickCount: 60 });
+    this._minuteWheel = new TimeWheelCache({ tickInterval: MinuteInMillisecond, tickCount: 60, autoStart });
     /**
      * Hour Wheel:
      * 1. 1 Tick Mark is 1 Hour, is 60 * 60 * 1000 Milliseconds
@@ -510,7 +521,7 @@ class Hour24TimeWheelCache extends k {
      *   * 24 23:00:00 -> 23:59:59   in   Slot23    Index23
      * @type {TimeWheelCache}
      */
-    this._hourWheel = new TimeWheelCache({ tickInterval: HourInMillisecond, tickCount: 24 });
+    this._hourWheel = new TimeWheelCache({ tickInterval: HourInMillisecond, tickCount: 24, autoStart });
     /**
      * @type {Map<any, TimeWheelCache>}
      */
@@ -530,6 +541,10 @@ class Hour24TimeWheelCache extends k {
     return this._secondWheel.autoEvictRunning || this._minuteWheel.autoEvictRunning || this._hourWheel.autoEvictRunning
   }
 
+  get autoStart () {
+    return this._autoStart
+  }
+
   _init () {
     /**
      * 1. We don't store "Timetick: < 00:00:01 -> 00:59:59" into HourWheel, instead, we store them into MinuteWheel
@@ -707,10 +722,639 @@ class Hour24TimeWheelCache extends k {
   }
 }
 
-var index = { CappedSet, TimeWheelCache, Hour24TimeWheelCache };
+// internal
+// owned
+
+/**
+ * @typedef {{
+ *   value: any,
+ *   prev: Node|undefined,
+ *   next: Node|undefined
+ * }} Node
+ */
+
+// module vars
+const { assertNotNegative } = C;
+
+/**
+ * A doubly linked list implementation.
+ *
+ * @class LinkedList
+ */
+class LinkedList {
+  /**
+   * Creates a new LinkedList instance.
+   * @constructor
+   */
+  constructor () {
+    /**
+     * @type {Node|undefined}
+     */
+    this._head = undefined;
+    /**
+     * @type {Node|undefined}
+     */
+    this._tail = undefined;
+    /**
+     * @type {number}
+     */
+    this._size = 0;
+  }
+
+  get size () {
+    return this._size
+  }
+
+  /**
+   * get the first element
+   */
+  get first () {
+    return this._head?.value
+  }
+
+  /**
+   * get the last element
+   */
+  get last () {
+    return this._tail?.value
+  }
+
+  [Symbol.iterator] () {
+    let current = this._head;
+    const iterator = {
+      next () {
+        if (current) {
+          const value = current.value;
+          current = current.next;
+          return { value, done: false }
+        }
+        return { value: undefined, done: true }
+      },
+      [Symbol.iterator] () {
+        return this
+      }
+    };
+    return iterator
+  }
+
+  /**
+   * Adds a value to the beginning of the linked list.
+   * @param {*} value - The value to add
+   * @returns {LinkedList} This linked list instance for chaining
+   */
+  addFirst (value) {
+    /**
+     * @type {Node}
+     */
+    const node = { value, prev: undefined, next: this._head };
+
+    if (this._head) {
+      this._head.prev = node;
+    } else {
+      this._tail = node;
+    }
+
+    this._head = node;
+    this._size++;
+    return this
+  }
+
+  /**
+   * Adds a value to the end of the linked list.
+   * @param {*} value - The value to add
+   * @returns {LinkedList} This linked list instance for chaining
+   */
+  addLast (value) {
+    /**
+     * @type {Node}
+     */
+    const node = { value, prev: this._tail, next: undefined };
+
+    if (this._tail) {
+      this._tail.next = node;
+    } else {
+      this._head = node;
+    }
+
+    this._tail = node;
+    this._size++;
+    return this
+  }
+
+  /**
+   * Adds a value to the end of the linked list.
+   * @param {*} value - The value to add
+   * @returns {LinkedList} This linked list instance for chaining
+   */
+  add (value) {
+    return this.addLast(value)
+  }
+
+  /**
+   * Removes and returns the first element from the linked list.
+   * @returns {*} The removed value, or undefined if the list is empty
+   */
+  removeFirst () {
+    if (!this._head) {
+      return undefined
+    }
+
+    const value = this._head.value;
+    this._head = this._head.next;
+
+    if (this._head) {
+      this._head.prev = undefined;
+    } else {
+      this._tail = undefined;
+    }
+
+    this._size--;
+    return value
+  }
+
+  /**
+   * Removes and returns the last element from the linked list.
+   * @returns {*} The removed value, or undefined if the list is empty
+   */
+  removeLast () {
+    if (!this._tail) {
+      return undefined
+    }
+
+    const value = this._tail.value;
+    this._tail = this._tail.prev;
+
+    if (this._tail) {
+      this._tail.next = undefined;
+    } else {
+      this._head = undefined;
+    }
+
+    this._size--;
+    return value
+  }
+
+  /**
+   * Removes the first occurrence of the specified value from the linked list.
+   * @param {*} value - The value to remove
+   * @param {function(*, *): boolean} [comparator] - Optional comparison function (a, b) => boolean
+   * @returns {boolean} True if the value was found and removed, false otherwise
+   */
+  remove (value, comparator) {
+    const compare = comparator || this._defaultComparator;
+    let current = this._head;
+
+    while (current) {
+      if (compare(current.value, value)) {
+        this._removeNode(current);
+        return true
+      }
+      current = current.next;
+    }
+
+    return false
+  }
+
+  /**
+   * Removes all occurrences of the specified value from the linked list.
+   * @param {*} value - The value to remove
+   * @param {function(*, *): boolean} [comparator] - Optional comparison function (a, b) => boolean
+   * @returns {number} The number of elements removed
+   */
+  removeAll (value, comparator) {
+    const compare = comparator || this._defaultComparator;
+    let removedCount = 0;
+    let current = this._head;
+
+    while (current) {
+      const next = current.next; // Store next before potential removal
+      if (compare(current.value, value)) {
+        this._removeNode(current);
+        removedCount++;
+      }
+      current = next;
+    }
+
+    return removedCount
+  }
+
+  /**
+   * Removes the element at the specified index.
+   * @param {number} index - The index of the element to remove
+   * @returns {*} The removed value, or undefined if index is out of bounds
+   */
+  removeAt (index) {
+    assertNotNegative(index, 'index');
+
+    if (index >= this._size) {
+      return undefined
+    }
+
+    if (index === 0) {
+      return this.removeFirst()
+    }
+
+    if (index === this._size - 1) {
+      return this.removeLast()
+    }
+
+    let current = this._head;
+    for (let i = 0; i < index; i++) {
+      current = current?.next;
+    }
+
+    if (current) {
+      const value = current.value;
+      this._removeNode(current);
+      return value
+    }
+
+    return undefined
+  }
+
+  /**
+   * Checks if the linked list contains the specified value.
+   * @param {*} value - The value to check for
+   * @param {function(*, *): boolean} [comparator] - Optional comparison function (a, b) => boolean
+   * @returns {boolean} True if the value exists, false otherwise
+   */
+  contains (value, comparator) {
+    const compare = comparator || this._defaultComparator;
+    let current = this._head;
+    while (current) {
+      if (compare(current.value, value)) {
+        return true
+      }
+      current = current.next;
+    }
+    return false
+  }
+
+  /**
+   * Returns the index of the first occurrence of the specified value.
+   * @param {*} value - The value to find
+   * @param {function(*, *): boolean} [comparator] - Optional comparison function (a, b) => boolean
+   * @returns {number} The index of the value, or -1 if not found
+   */
+  indexOf (value, comparator) {
+    const compare = comparator || this._defaultComparator;
+    let current = this._head;
+    let index = 0;
+    while (current) {
+      if (compare(current.value, value)) {
+        return index
+      }
+      current = current.next;
+      index++;
+    }
+    return -1
+  }
+
+  /**
+   * Returns the index of the last occurrence of the specified value.
+   * @param {*} value - The value to find
+   * @param {function(*, *): boolean} [comparator] - Optional comparison function (a, b) => boolean
+   * @returns {number} The index of the last occurrence, or -1 if not found
+   */
+  indexLastOf (value, comparator) {
+    const compare = comparator || this._defaultComparator;
+    let current = this._tail;
+    let index = this._size - 1;
+    while (current) {
+      if (compare(current.value, value)) {
+        return index
+      }
+      current = current.prev;
+      index--;
+    }
+    return -1
+  }
+
+  /**
+   * Gets the value at the specified index.
+   * @param {number} index - The index of the value to get
+   * @returns {*} The value at the index, or undefined if index is out of bounds
+   */
+  get (index) {
+    assertNotNegative(index, 'index');
+
+    if (index >= this._size) {
+      return undefined
+    }
+
+    let current = this._head;
+    for (let i = 0; i < index; i++) {
+      current = current?.next;
+    }
+
+    return current?.value
+  }
+
+  /**
+   * Inserts a value at the specified index.
+   * @param {number} index - The index at which to insert the value
+   * @param {*} value - The value to insert
+   * @returns {LinkedList} This linked list instance for chaining
+   */
+  insertAt (index, value) {
+    assertNotNegative(index, 'index');
+
+    if (index === 0) {
+      return this.addFirst(value)
+    }
+
+    if (index >= this._size) {
+      return this.addLast(value)
+    }
+
+    let current = this._head;
+    for (let i = 0; i < index - 1; i++) {
+      current = current?.next;
+    }
+
+    if (current) {
+      /**
+       * @type {Node}
+       */
+      const node = { value, prev: current, next: current.next };
+      if (current.next) {
+        current.next.prev = node;
+      }
+      current.next = node;
+      this._size++;
+    }
+
+    return this
+  }
+
+  /**
+   * Removes all elements from the linked list.
+   */
+  clear () {
+    this._head = undefined;
+    this._tail = undefined;
+    this._size = 0;
+  }
+
+  /**
+   * Returns an array containing all the values in the linked list.
+   * @returns {any[]} An array of all values
+   */
+  toArray () {
+    const result = [];
+    let current = this._head;
+    while (current) {
+      result.push(current.value);
+      current = current.next;
+    }
+    return result
+  }
+
+  /**
+   * Returns an iterator of the values in the linked list.
+   * @returns {Iterator<any>} An iterator object that yields the values of the linked list
+   */
+  values () {
+    return this[Symbol.iterator]()
+  }
+
+  /**
+   * Returns a slice of the linked list as an array.
+   * @param {number} [start=0] - The start index (inclusive). If negative, counts from the end.
+   * @param {number} [end=this.size] - The end index (exclusive). If negative, counts from the end.
+   * @returns {any[]} An array containing the sliced elements
+   */
+  slice (start = 0, end = this.size) {
+    // Handle negative indices
+    const normalizedStart = start < 0 ? Math.max(this.size + start, 0) : Math.min(start, this.size);
+    const normalizedEnd = end < 0 ? Math.max(this.size + end, 0) : Math.min(end, this.size);
+
+    if (normalizedStart >= normalizedEnd) {
+      return []
+    }
+
+    if (start < 0) {
+      return this._sliceNegative(normalizedStart, normalizedEnd)
+    } else {
+      return this._slicePositive(normalizedStart, normalizedEnd)
+    }
+  }
+
+  /**
+   * Returns a string representation of the FixedLinkedList.
+   * @returns {string} String representation
+   */
+  toString () {
+    const partialElements = this.slice(0, 3);
+    const partialString = this.size > 3 ? G.safeToString(partialElements) + '...' : G.safeToString(partialElements);
+    return `LinkedList[${this.size}](${partialString})`
+  }
+
+  /**
+   * Slice implementation for positive indices (iterates from head to tail)
+   * @param {number} start - Normalized start index (inclusive)
+   * @param {number} end - Normalized end index (exclusive)
+   * @returns {any[]} An array containing the sliced elements
+   * @private
+   */
+  _slicePositive (start, end) {
+    const result = [];
+    let current = this._head;
+    let index = 0;
+
+    // Move to the starting position
+    while (current && index < start) {
+      current = current.next;
+      index++;
+    }
+
+    // Collect elements from start to end
+    while (current && index < end) {
+      result.push(current.value);
+      current = current.next;
+      index++;
+    }
+
+    return result
+  }
+
+  /**
+   * Slice implementation for negative indices (iterates from tail to head)
+   * @param {number} start - Normalized start index (inclusive)
+   * @param {number} end - Normalized end index (exclusive)
+   * @returns {any[]} An array containing the sliced elements
+   * @private
+   */
+  _sliceNegative (start, end) {
+    const result = [];
+    let current = this._tail;
+    let index = this.size - 1;
+
+    // Move to the starting position
+    while (current && index > start) {
+      current = current.prev;
+      index--;
+    }
+
+    // Collect elements from start to end
+    while (current && index < end) {
+      result.push(current.value);
+      current = current.next;
+      index++;
+    }
+
+    return result
+  }
+
+  /**
+   * Removes a node from the linked list.
+   * @param {Node} node - The node to be removed
+   * @private
+   */
+  _removeNode (node) {
+    if (node.prev) {
+      node.prev.next = node.next;
+    } else {
+      this._head = node.next;
+    }
+
+    if (node.next) {
+      node.next.prev = node.prev;
+    } else {
+      this._tail = node.prev;
+    }
+
+    this._size--;
+  }
+
+  /**
+   * Default comparator for strict equality comparison.
+   * @param {*} a - First value to compare
+   * @param {*} b - Second value to compare
+   * @returns {boolean} True if values are strictly equal
+   * @private
+   */
+  _defaultComparator (a, b) {
+    return a === b
+  }
+}
+
+// internal
+// owned
+
+// module vars
+const { assertPositive } = C;
+
+/**
+ * A fixed-capacity linked list that automatically removes elements when capacity is exceeded.
+ * When adding to the end (addLast), it removes the first element if capacity is full.
+ * When adding to the beginning (addFirst), it removes the last element if capacity is full.
+ *
+ * @class FixedLinkedList
+ * @extends LinkedList
+ */
+class FixedLinkedList extends LinkedList {
+  /**
+   * Creates a new FixedLinkedList instance with a fixed capacity.
+   * @constructor
+   * @param {number} capacity - The maximum number of elements the list can hold (must be > 0)
+   * @throws {Error} If capacity is less than or equal to 0
+   */
+  constructor (capacity) {
+    assertPositive(capacity, 'capacity');
+    super();
+    this.capacity = Math.ceil(capacity);
+  }
+
+  /**
+   * Adds a value to the beginning of the linked list.
+   * If the list is at capacity, removes the last element before adding.
+   * @param {*} value - The value to add
+   * @returns {FixedLinkedList} This linked list instance for chaining
+   */
+  addFirst (value) {
+    if (this.size >= this.capacity) {
+      this.removeLast();
+    }
+    super.addFirst(value);
+    return this
+  }
+
+  /**
+   * Adds a value to the end of the linked list.
+   * If the list is at capacity, removes the first element before adding.
+   * @param {*} value - The value to add
+   * @returns {FixedLinkedList} This linked list instance for chaining
+   */
+  addLast (value) {
+    if (this.size >= this.capacity) {
+      this.removeFirst();
+    }
+    super.addLast(value);
+    return this
+  }
+
+  /**
+   * Adds a value to the end of the linked list.
+   * If the list is at capacity, removes the first element before adding.
+   * @param {*} value - The value to add
+   * @returns {FixedLinkedList} This linked list instance for chaining
+   */
+  add (value) {
+    return this.addLast(value)
+  }
+
+  /**
+   * Inserts a value at the specified index.
+   * If the list is at capacity and index is not at the end, removes the first element before adding.
+   * If the list is at capacity and index is at the end, removes the first element before adding.
+   * @param {number} index - The index at which to insert the value
+   * @param {*} value - The value to insert
+   * @returns {FixedLinkedList} This linked list instance for chaining
+   */
+  insertAt (index, value) {
+    // Remove an element if we're at capacity and not adding beyond current size
+    if (this.size >= this.capacity) {
+      // Always remove first element to maintain capacity
+      this.removeFirst();
+    }
+    super.insertAt(index, value);
+    return this
+  }
+
+  /**
+   * Returns the remaining capacity of the list.
+   * @returns {number} The number of additional elements that can be added
+   */
+  get remainingCapacity () {
+    return this.capacity - this.size
+  }
+
+  /**
+   * Checks if the list is at full capacity.
+   * @returns {boolean} True if the list is full, false otherwise
+   */
+  get isFull () {
+    return this.size >= this.capacity
+  }
+
+  /**
+   * Returns a string representation of the FixedLinkedList.
+   * @returns {string} String representation
+   */
+  toString () {
+    const partialElements = this.slice(0, 3);
+    const partialString = this.size > 3 ? G.safeToString(partialElements) + '...' : G.safeToString(partialElements);
+    return `FixedLinkedList[${this.size}/${this.capacity}](${partialString})`
+  }
+}
+
+var index = { CappedSet, TimeWheelCache, Hour24TimeWheelCache, LinkedList, FixedLinkedList };
 
 exports.CappedSet = CappedSet;
+exports.FixedLinkedList = FixedLinkedList;
 exports.Hour24TimeWheelCache = Hour24TimeWheelCache;
+exports.LinkedList = LinkedList;
 exports.TimeWheelCache = TimeWheelCache;
 exports.default = index;
 //# sourceMappingURL=index-dev.cjs.map