@byloth/core 2.2.3 → 2.2.4

package/dist/core.esm.js

@@ -1,5 +1,5 @@
-const E = typeof window < "u" && typeof window.document < "u", B = typeof process < "u" && !!process.versions?.node, Y = typeof self == "object" && self.constructor?.name === "DedicatedWorkerGlobalScope";
-class h extends Error {
+const E = typeof window < "u" && typeof window.document < "u", B = typeof process < "u" && !!process.versions?.node, V = typeof self == "object" && self.constructor?.name === "DedicatedWorkerGlobalScope";
+class f extends Error {
   /**
    * A static method to convert a generic caught error, ensuring it's an instance of the {@link Exception} class.
    *
@@ -23,13 +23,13 @@ class h extends Error {
    * @returns An instance of the {@link Exception} class.
    */
   static FromUnknown(e) {
-    if (e instanceof h)
+    if (e instanceof f)
       return e;
     if (e instanceof Error) {
-      const t = new h(e.message);
+      const t = new f(e.message);
       return t.stack = e.stack, t.cause = e.cause, t.name = e.name, t;
     }
-    return new h(`${e}`);
+    return new f(`${e}`);
   }
   /**
    * Initializes a new instance of the {@link Exception} class.
@@ -52,7 +52,7 @@ class h extends Error {
   }
   [Symbol.toStringTag] = "Exception";
 }
-class g extends h {
+class v extends f {
   /**
    * Initializes a new instance of the {@link FatalErrorException} class.
    *
@@ -74,7 +74,7 @@ class g extends h {
   }
   [Symbol.toStringTag] = "FatalErrorException";
 }
-class j extends g {
+class j extends v {
   /**
    * Initializes a new instance of the {@link NotImplementedException} class.
    *
@@ -96,7 +96,7 @@ class j extends g {
   }
   [Symbol.toStringTag] = "NotImplementedException";
 }
-class M extends h {
+class M extends f {
   /**
    * Initializes a new instance of the {@link FileException} class.
    *
@@ -162,7 +162,7 @@ class L extends M {
   }
   [Symbol.toStringTag] = "FileNotFoundException";
 }
-class b extends h {
+class y extends f {
   /**
    * Initializes a new instance of the {@link KeyException} class.
    *
@@ -184,7 +184,7 @@ class b extends h {
   }
   [Symbol.toStringTag] = "KeyException";
 }
-class V extends h {
+class A extends f {
   /**
    * Initializes a new instance of the {@link NetworkException} class.
    *
@@ -206,7 +206,30 @@ class V extends h {
   }
   [Symbol.toStringTag] = "NetworkException";
 }
-class G extends h {
+class G extends A {
+  response;
+  /**
+   * Initializes a new instance of the {@link ResponseException} class.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * throw new ResponseException(response);
+   * ```
+   *
+   * ---
+   *
+   * @param response The response that caused the error.
+   * @param cause The previous caught error that caused this one, if any.
+   * @param name The name of the exception. Default is `"ResponseException"`.
+   */
+  constructor(e, t, n = "ResponseException") {
+    super(`The request failed with the status code ${e.status} (${e.statusText}).`, t, n), this.response = e;
+  }
+  [Symbol.toStringTag] = "ResponseException";
+}
+class K extends f {
   /**
    * Initializes a new instance of the {@link PermissionException} class.
    *
@@ -228,7 +251,7 @@ class G extends h {
   }
   [Symbol.toStringTag] = "PermissionException";
 }
-class k extends h {
+class S extends f {
   /**
    * Initializes a new instance of the {@link ReferenceException} class.
    *
@@ -250,7 +273,7 @@ class k extends h {
   }
   [Symbol.toStringTag] = "ReferenceException";
 }
-class y extends h {
+class b extends f {
   /**
    * Initializes a new instance of the {@link RuntimeException} class.
    *
@@ -272,7 +295,7 @@ class y extends h {
   }
   [Symbol.toStringTag] = "RuntimeException";
 }
-class O extends y {
+class z extends b {
   /**
    * Initializes a new instance of the {@link EnvironmentException} class.
    *
@@ -294,7 +317,7 @@ class O extends y {
   }
   [Symbol.toStringTag] = "EnvironmentException";
 }
-class N extends h {
+class N extends f {
   /**
    * Initializes a new instance of the {@link TimeoutException} class.
    *
@@ -316,7 +339,7 @@ class N extends h {
   }
   [Symbol.toStringTag] = "TimeoutException";
 }
-class K extends h {
+class Q extends f {
   /**
    * Initializes a new instance of the {@link TypeException} class.
    *
@@ -338,7 +361,7 @@ class K extends h {
   }
   [Symbol.toStringTag] = "TypeException";
 }
-class u extends h {
+class c extends f {
   /**
    * Initializes a new instance of the {@link ValueException} class.
    *
@@ -360,7 +383,7 @@ class u extends h {
   }
   [Symbol.toStringTag] = "ValueException";
 }
-class x extends u {
+class x extends c {
   /**
    * Initializes a new instance of the {@link RangeException} class.
    *
@@ -530,7 +553,7 @@ class l {
     if (s === void 0) {
       const r = this._iterator.next();
       if (r.done)
-        throw new u("Cannot reduce an empty iterator without an initial value.");
+        throw new c("Cannot reduce an empty iterator without an initial value.");
       s = r.value, n += 1;
     }
     for (; ; ) {
@@ -993,7 +1016,7 @@ class l {
     return this;
   }
 }
-class c {
+class h {
   /**
    * The internal {@link SmartIterator} object that holds the reduced elements.
    */
@@ -1077,7 +1100,7 @@ class c {
   }
   filter(e) {
     const t = this._elements.enumerate();
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         e(s, r, n) && (yield [s, r]);
     });
@@ -1117,7 +1140,7 @@ class c {
    */
   map(e) {
     const t = this._elements.enumerate();
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [s, e(s, r, n)];
     });
@@ -1127,7 +1150,7 @@ class c {
     if (s === void 0) {
       const r = this._elements.next();
       if (r.done)
-        throw new u("Cannot reduce an empty iterator without an initial value.");
+        throw new c("Cannot reduce an empty iterator without an initial value.");
       s = r.value[1], n += 1;
     }
     for (const [r, o] of this._elements)
@@ -1215,7 +1238,7 @@ class c {
    */
   drop(e) {
     const t = this._elements.enumerate();
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         n >= e && (yield [s, r]);
     });
@@ -1257,7 +1280,7 @@ class c {
    */
   take(e) {
     const t = this._elements.enumerate();
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t) {
         if (n >= e)
           break;
@@ -1327,7 +1350,7 @@ class c {
    */
   unique() {
     const e = this._elements;
-    return new c(function* () {
+    return new h(function* () {
       const t = /* @__PURE__ */ new Set();
       for (const [n, s] of e)
         t.has(s) || (t.add(s), yield [n, s]);
@@ -1601,13 +1624,13 @@ class c {
   }
   [Symbol.toStringTag] = "ReducedIterator";
 }
-class p {
+class _ {
   /**
    * The internal {@link SmartAsyncIterator} object that holds the elements to aggregate.
    */
   _elements;
   constructor(e) {
-    this._elements = new w(e);
+    this._elements = new m(e);
   }
   /**
    * Determines whether all elements of each group of the iterator satisfy a given condition.
@@ -1646,7 +1669,7 @@ class p {
       const [r, o] = t.get(n) ?? [0, !0];
       o && t.set(n, [r + 1, await e(n, s, r)]);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [n, r];
     });
@@ -1688,14 +1711,14 @@ class p {
       const [r, o] = t.get(n) ?? [0, !1];
       o || t.set(n, [r + 1, await e(n, s, r)]);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [n, r];
     });
   }
   filter(e) {
     const t = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const n = /* @__PURE__ */ new Map();
       for await (const [s, r] of t) {
         const o = n.get(s) ?? 0;
@@ -1737,7 +1760,7 @@ class p {
    */
   map(e) {
     const t = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const n = /* @__PURE__ */ new Map();
       for await (const [s, r] of t) {
         const o = n.get(s) ?? 0;
@@ -1759,7 +1782,7 @@ class p {
       }
       n.set(s, [o + 1, await e(s, a, r, o)]);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [s, [r, o]] of n)
         yield [s, o];
     });
@@ -1802,13 +1825,13 @@ class p {
    */
   flatMap(e) {
     const t = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const n = /* @__PURE__ */ new Map();
       for await (const [s, r] of t) {
         const o = n.get(s) ?? 0, a = await e(s, r, o);
         if (a instanceof Array)
-          for (const f of a)
-            yield [s, f];
+          for (const u of a)
+            yield [s, u];
         else
           yield [s, a];
         n.set(s, o + 1);
@@ -1846,7 +1869,7 @@ class p {
    */
   drop(e) {
     const t = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const n = /* @__PURE__ */ new Map();
       for await (const [s, r] of t) {
         const o = n.get(s) ?? 0;
@@ -1889,7 +1912,7 @@ class p {
    */
   take(e) {
     const t = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const n = /* @__PURE__ */ new Map();
       for await (const [s, r] of t) {
         const o = n.get(s) ?? 0;
@@ -1903,7 +1926,7 @@ class p {
       let [r, o] = t.get(n) ?? [0, void 0];
       o === void 0 && (await e(n, s, r) && (o = s), t.set(n, [r + 1, o]));
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [n, r];
     });
@@ -1965,7 +1988,7 @@ class p {
    */
   unique() {
     const e = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const t = /* @__PURE__ */ new Map();
       for await (const [n, s] of e) {
         const r = t.get(n) ?? /* @__PURE__ */ new Set();
@@ -2001,7 +2024,7 @@ class p {
       const n = e.get(t) ?? 0;
       e.set(t, n + 1);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [t, n] of e)
         yield [t, n];
     });
@@ -2072,7 +2095,7 @@ class p {
    */
   reorganizeBy(e) {
     const t = this._elements;
-    return new p(async function* () {
+    return new _(async function* () {
       const n = /* @__PURE__ */ new Map();
       for await (const [s, r] of t) {
         const o = n.get(s) ?? 0;
@@ -2108,7 +2131,7 @@ class p {
    */
   keys() {
     const e = this._elements;
-    return new w(async function* () {
+    return new m(async function* () {
       const t = /* @__PURE__ */ new Set();
       for await (const [n] of e)
         t.has(n) || (t.add(n), yield n);
@@ -2172,7 +2195,7 @@ class p {
    */
   values() {
     const e = this._elements;
-    return new w(async function* () {
+    return new m(async function* () {
       for await (const [t, n] of e)
         yield n;
     });
@@ -2259,7 +2282,7 @@ class p {
   }
   [Symbol.toStringTag] = "AggregatedAsyncIterator";
 }
-class w {
+class m {
   /**
    * The native {@link AsyncIterator} object that is being wrapped by this instance.
    */
@@ -2383,7 +2406,7 @@ class w {
   }
   filter(e) {
     const t = this._iterator;
-    return new w(async function* () {
+    return new m(async function* () {
       let n = 0;
       for (; ; ) {
         const s = await t.next();
@@ -2426,7 +2449,7 @@ class w {
    */
   map(e) {
     const t = this._iterator;
-    return new w(async function* () {
+    return new m(async function* () {
       let n = 0;
       for (; ; ) {
         const s = await t.next();
@@ -2441,7 +2464,7 @@ class w {
     if (s === void 0) {
       const r = await this._iterator.next();
       if (r.done)
-        throw new u("Cannot reduce an empty iterator without an initial value.");
+        throw new c("Cannot reduce an empty iterator without an initial value.");
       s = r.value, n += 1;
     }
     for (; ; ) {
@@ -2484,7 +2507,7 @@ class w {
    */
   flatMap(e) {
     const t = this._iterator;
-    return new w(async function* () {
+    return new m(async function* () {
       let n = 0;
       for (; ; ) {
         const s = await t.next();
@@ -2533,7 +2556,7 @@ class w {
    */
   drop(e) {
     const t = this._iterator;
-    return new w(async function* () {
+    return new m(async function* () {
       let n = 0;
       for (; n < e; ) {
         if ((await t.next()).done)
@@ -2582,7 +2605,7 @@ class w {
    */
   take(e) {
     const t = this._iterator;
-    return new w(async function* () {
+    return new m(async function* () {
       let n = 0;
       for (; n < e; ) {
         const s = await t.next();
@@ -2661,7 +2684,7 @@ class w {
    */
   unique() {
     const e = this._iterator;
-    return new w(async function* () {
+    return new m(async function* () {
       const t = /* @__PURE__ */ new Set();
       for (; ; ) {
         const n = await e.next();
@@ -2878,7 +2901,7 @@ class w {
    * @returns A new instance of the {@link AggregatedAsyncIterator} class containing the grouped elements.
    */
   groupBy(e) {
-    return new p(this.map(async (t, n) => [await e(t, n), t]));
+    return new _(this.map(async (t, n) => [await e(t, n), t]));
   }
   /**
    * Materializes the iterator into an array.  
@@ -2955,7 +2978,7 @@ class d {
       const [r, o] = t.get(n) ?? [0, !0];
       o && t.set(n, [r + 1, e(n, s, r)]);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [n, r];
     });
@@ -2996,7 +3019,7 @@ class d {
       const [r, o] = t.get(n) ?? [0, !1];
       o || t.set(n, [r + 1, e(n, s, r)]);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [n, r];
     });
@@ -3067,7 +3090,7 @@ class d {
       }
       n.set(s, [o + 1, e(s, a, r, o)]);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [s, [r, o]] of n)
         yield [s, o];
     });
@@ -3115,8 +3138,8 @@ class d {
       for (const [s, r] of t) {
         const o = n.get(s) ?? 0, a = e(s, r, o);
         if (a instanceof Array)
-          for (const f of a)
-            yield [s, f];
+          for (const u of a)
+            yield [s, u];
         else
           yield [s, a];
         n.set(s, o + 1);
@@ -3211,7 +3234,7 @@ class d {
       let [r, o] = t.get(n) ?? [0, void 0];
       o === void 0 && (e(n, s, r) && (o = s), t.set(n, [r + 1, o]));
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [n, [s, r]] of t)
         yield [n, r];
     });
@@ -3308,7 +3331,7 @@ class d {
       const n = e.get(t) ?? 0;
       e.set(t, n + 1);
     }
-    return new c(function* () {
+    return new h(function* () {
       for (const [t, n] of e)
         yield [t, n];
     });
@@ -3564,8 +3587,8 @@ class d {
   }
   [Symbol.toStringTag] = "AggregatedIterator";
 }
-const z = Function;
-class R extends z {
+const q = Function;
+class R extends q {
   /**
    * Initializes a new instance of the {@link CallableObject} class.
    */
@@ -3576,7 +3599,7 @@ class R extends z {
   }
   [Symbol.toStringTag] = "CallableObject";
 }
-class Q extends R {
+class H extends R {
   /**
    * The array containing all the functions in the chain.
    */
@@ -3686,7 +3709,7 @@ class Q extends R {
   }
   [Symbol.toStringTag] = "CallbackChain";
 }
-class v {
+class g {
   /**
    * A map containing all the subscribers for each event.
    *
@@ -3742,7 +3765,7 @@ class v {
    */
   // eslint-disable-next-line @typescript-eslint/no-empty-object-type
   createScope() {
-    const e = new v();
+    const e = new g();
     return this.subscribe("__internals__:clear", () => e.clear()), this.subscribe("*", (t, ...n) => {
       e.publish(t, ...n);
     }), e;
@@ -3763,17 +3786,17 @@ class v {
     return n.push(t), this._subscribers.set(e, n), () => {
       const s = n.indexOf(t);
       if (s < 0)
-        throw new k("Unable to unsubscribe the required subscriber. The subscription was already unsubscribed.");
+        throw new S("Unable to unsubscribe the required subscriber. The subscription was already unsubscribed.");
       n.splice(s, 1);
     };
   }
   unsubscribe(e, t) {
     const n = this._subscribers.get(e);
     if (!n)
-      throw new k("Unable to unsubscribe the required subscriber. The subscription was already unsubscribed or was never subscribed.");
+      throw new S("Unable to unsubscribe the required subscriber. The subscription was already unsubscribed or was never subscribed.");
     const s = n.indexOf(t);
     if (s < 0)
-      throw new k("Unable to unsubscribe the required subscriber. The subscription was already unsubscribed or was never subscribed.");
+      throw new S("Unable to unsubscribe the required subscriber. The subscription was already unsubscribed or was never subscribed.");
     n.splice(s, 1), n.length === 0 && this._subscribers.delete(e);
   }
   unsubscribeAll(e) {
@@ -3804,9 +3827,9 @@ class v {
   }
   [Symbol.toStringTag] = "Publisher";
 }
-const A = () => {
+const I = () => {
 };
-class H extends R {
+class X extends R {
   /**
    * The currently selected implementation of the callback.
    */
@@ -3884,16 +3907,16 @@ class H extends R {
   enable(e) {
     if (e === void 0) {
       if (!this._key)
-        throw new b(
+        throw new y(
           "The `SwitchableCallback` has no callback defined yet. Did you forget to call the `register` method?"
         );
       e = this._key;
     } else if (e) {
       if (!this._callbacks.has(e))
-        throw new b(`The key '${e}' doesn't yet have any associated callback.`);
-    } else throw new b("The key must be a non-empty string.");
+        throw new y(`The key '${e}' doesn't yet have any associated callback.`);
+    } else throw new y("The key must be a non-empty string.");
     if (this._isEnabled)
-      throw new y("The `SwitchableCallback` is already enabled.");
+      throw new b("The `SwitchableCallback` is already enabled.");
     this._callback = this._callbacks.get(e), this._isEnabled = !0;
   }
   /**
@@ -3911,8 +3934,8 @@ class H extends R {
    */
   disable() {
     if (!this._isEnabled)
-      throw new y("The `SwitchableCallback` is already disabled.");
-    this._callback = A, this._isEnabled = !1;
+      throw new b("The `SwitchableCallback` is already disabled.");
+    this._callback = I, this._isEnabled = !1;
   }
   /**
    * Registers a new implementation for the callback.
@@ -3938,7 +3961,7 @@ class H extends R {
     if (this._callbacks.size === 0)
       this._key = e, this._callback = t;
     else if (this._callbacks.has(e))
-      throw new b(`The key '${e}' has already been used for another callback.`);
+      throw new y(`The key '${e}' has already been used for another callback.`);
     this._callbacks.set(e, t);
   }
   /**
@@ -3961,9 +3984,9 @@ class H extends R {
    */
   unregister(e) {
     if (this._key === e)
-      throw new b("Unable to unregister the currently selected callback.");
+      throw new y("Unable to unregister the currently selected callback.");
     if (!this._callbacks.has(e))
-      throw new b(`The key '${e}' doesn't yet have any associated callback.`);
+      throw new y(`The key '${e}' doesn't yet have any associated callback.`);
     this._callbacks.delete(e);
   }
   /**
@@ -3986,12 +4009,231 @@ class H extends R {
    */
   switch(e) {
     if (!this._callbacks.has(e))
-      throw new b(`The key '${e}' doesn't yet have any associated callback.`);
+      throw new y(`The key '${e}' doesn't yet have any associated callback.`);
     this._key !== e && (this._key = e, this._isEnabled && (this._callback = this._callbacks.get(e)));
   }
   [Symbol.toStringTag] = "SwitchableCallback";
 }
-class X extends Map {
+class Z extends Array {
+  /**
+   * The internal {@link Publisher} instance used to publish events.
+   */
+  _publisher;
+  constructor(...e) {
+    super(...e), this._publisher = new g();
+  }
+  /**
+   * Appends new elements to the end of the {@link Array} and returns the new length of the array.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * const array = new ArrayView<number>();
+   * array.push(2, 4, 8);
+   *
+   * console.log(array); // ArrayView(3) [2, 4, 8]
+   * ```
+   *
+   * ---
+   *
+   * @param items New elements to add to the array.
+   *
+   * @returns The new length of the array.
+   */
+  push(...e) {
+    const t = this.length, n = super.push(...e);
+    for (let s = 0; s < e.length; s += 1)
+      this._publisher.publish("add", e[s], t + s);
+    return n;
+  }
+  /**
+   * Removes the last element from the {@link Array} and returns it.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * const array = new ArrayView<number>(2, 4, 8);
+   * array.pop(); // 8
+   *
+   * console.log(array); // ArrayView(2) [2, 4]
+   * ```
+   *
+   * ---
+   *
+   * @returns The removed element, or `undefined` if the array is empty.
+   */
+  pop() {
+    const e = this.length - 1;
+    if (e < 0)
+      return;
+    const t = super.pop();
+    return this._publisher.publish("remove", t, e), t;
+  }
+  /**
+   * Removes the first element from the {@link Array} and returns it.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * const array = new ArrayView<number>(2, 4, 8);
+   * array.shift(); // 2
+   *
+   * console.log(array); // ArrayView(2) [4, 8]
+   * ```
+   *
+   * ---
+   *
+   * @returns The removed element, or `undefined` if the array is empty.
+   */
+  shift() {
+    if (this.length === 0)
+      return;
+    const e = super.shift();
+    return this._publisher.publish("remove", e, 0), e;
+  }
+  /**
+   * Inserts new elements at the start of the {@link Array} and returns the new length of the array.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * const array = new ArrayView<number>(4, 8);
+   * array.unshift(2);
+   *
+   * console.log(array); // ArrayView(3) [2, 4, 8]
+   * ```
+   *
+   * ---
+   *
+   * @param items Elements to insert at the start of the array.
+   *
+   * @returns The new length of the array.
+   */
+  unshift(...e) {
+    const t = super.unshift(...e);
+    for (let n = 0; n < e.length; n += 1)
+      this._publisher.publish("add", e[n], n);
+    return t;
+  }
+  /**
+   * Removes elements from the {@link Array} and, if necessary, inserts new elements in their place,
+   * returning the deleted elements.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * const array = new ArrayView<number>(2, 4, 8, 16);
+   * array.splice(1, 2, 32, 64); // [4, 8]
+   *
+   * console.log(array); // ArrayView(4) [2, 32, 64, 16]
+   * ```
+   *
+   * ---
+   *
+   * @param start The zero-based location in the array from which to start removing elements.
+   * @param deleteCount The number of elements to remove.
+   * @param items Elements to insert into the array in place of the deleted elements.
+   *
+   * @returns An array containing the elements that were deleted.
+   */
+  splice(e, t, ...n) {
+    const s = e < 0 ? Math.max(this.length + e, 0) : Math.min(e, this.length), r = t === void 0 ? this.length - s : Math.min(Math.max(t, 0), this.length - s), o = super.splice(e, r, ...n);
+    for (let a = 0; a < o.length; a += 1)
+      this._publisher.publish("remove", o[a], s + a);
+    for (let a = 0; a < n.length; a += 1)
+      this._publisher.publish("add", n[a], s + a);
+    return o;
+  }
+  /**
+   * Removes all elements from the {@link Array}.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * const array = new ArrayView<number>(2, 4, 8);
+   * array.clear();
+   *
+   * console.log(array); // ArrayView(0) []
+   * ```
+   */
+  clear() {
+    const e = this.length;
+    this.length = 0, e > 0 && this._publisher.publish("clear");
+  }
+  /**
+   * Subscribes to the `add` event of the array with a callback that will be executed when an element is added.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * array.onAdd((value, index) => console.log(`Added ${value} at index ${index}`));
+   *
+   * array.push(2); // "Added 2 at index 0"
+   * array.push(42); // "Added 42 at index 1"
+   * ```
+   *
+   * ---
+   *
+   * @param callback The callback that will be executed when an element is added to the array.
+   *
+   * @returns A function that can be used to unsubscribe from the event.
+   */
+  onAdd(e) {
+    return this._publisher.subscribe("add", e);
+  }
+  /**
+   * Subscribes to the `remove` event of the array with a callback that will be executed when an element is removed.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * array.onRemove((value, index) => console.log(`Removed ${value} at index ${index}`));
+   *
+   * array.pop(); // "Removed 8 at index 2"
+   * array.shift(); // "Removed 2 at index 0"
+   * ```
+   *
+   * ---
+   *
+   * @param callback The callback that will be executed when an element is removed from the array.
+   *
+   * @returns A function that can be used to unsubscribe from the event.
+   */
+  onRemove(e) {
+    return this._publisher.subscribe("remove", e);
+  }
+  /**
+   * Subscribes to the `clear` event of the array with a callback that will be executed when the array is cleared.
+   *
+   * ---
+   *
+   * @example
+   * ```ts
+   * array.onClear(() => console.log("The array has been cleared."));
+   * array.clear(); // "The array has been cleared."
+   * ```
+   *
+   * ---
+   *
+   * @param callback The callback that will be executed when the array is cleared.
+   *
+   * @returns A function that can be used to unsubscribe from the event.
+   */
+  onClear(e) {
+    return this._publisher.subscribe("clear", e);
+  }
+  [Symbol.toStringTag] = "ArrayView";
+  static [Symbol.species] = Array;
+}
+class W extends Map {
   /**
    * The internal {@link Publisher} instance used to publish events.
    */
@@ -4011,9 +4253,9 @@ class X extends Map {
    * @param iterable An optional iterable of key-value pairs to initialize the {@link Map} with.
    */
   constructor(e) {
-    if (super(), this._publisher = new v(), e)
+    if (super(), this._publisher = new g(), e)
       for (const [t, n] of e)
-        this.set(t, n);
+        super.set(t, n);
   }
   /**
    * Adds a new entry with a specified key and value to the {@link Map}.  
@@ -4148,7 +4390,7 @@ class X extends Map {
   }
   [Symbol.toStringTag] = "MapView";
 }
-class Z extends Set {
+class U extends Set {
   /**
    * The internal {@link Publisher} instance used to publish events.
    */
@@ -4168,9 +4410,9 @@ class Z extends Set {
    * @param iterable An optional iterable of values to initialize the {@link Set} with.
    */
   constructor(e) {
-    if (super(), this._publisher = new v(), e)
+    if (super(), this._publisher = new g(), e)
       for (const t of e)
-        this.add(t);
+        super.add(t);
   }
   /**
    * Appends a new element with a specified value to the end of the {@link Set}.  
@@ -4185,7 +4427,7 @@ class Z extends Set {
    *     .add(4)
    *     .add(8);
    *
-   * console.log(set); // SetView(4) { 2, 4, 8 }
+   * console.log(set); // SetView(3) { 2, 4, 8 }
    * ```
    *
    * ---
@@ -4304,7 +4546,7 @@ class Z extends Set {
   }
   [Symbol.toStringTag] = "SetView";
 }
-class W {
+class ee {
   /**
    * Whether to prefer the {@link localStorage} over the {@link sessionStorage} when calling an ambivalent method.
    *
@@ -4339,7 +4581,7 @@ class W {
    */
   constructor(e = !0) {
     if (!E)
-      throw new O(
+      throw new z(
         "The `JSONStorage` class can only be instantiated within a browser environment."
       );
     this._preferPersistence = e, this._volatile = window.sessionStorage, this._persistent = window.localStorage;
@@ -4612,7 +4854,7 @@ class W {
   }
   [Symbol.toStringTag] = "JSONStorage";
 }
-class m {
+class w {
   /**
    * Wraps a new {@link SmartPromise} object around an existing native {@link Promise} object.
    *
@@ -4637,7 +4879,7 @@ class m {
    * @returns A new {@link SmartPromise} object that wraps the provided promise.
    */
   static FromPromise(e) {
-    return new m((t, n) => e.then(t, n));
+    return new w((t, n) => e.then(t, n));
   }
   /**
    * A flag indicating whether the promise is still pending or not.
@@ -4745,7 +4987,7 @@ class m {
   }
   [Symbol.toStringTag] = "SmartPromise";
 }
-class F extends m {
+class F extends w {
   /**
    * The exposed function that allows to resolve the promise.
    *
@@ -4818,7 +5060,7 @@ class F extends m {
   }
   [Symbol.toStringTag] = "DeferredPromise";
 }
-class q extends m {
+class O extends w {
   /**
    * Initializes a new instance of the {@link TimedPromise} class.
    *
@@ -4843,17 +5085,17 @@ class q extends m {
    */
   constructor(e, t) {
     super((n, s) => {
-      const r = (_) => {
-        clearTimeout(f), n(_);
-      }, o = (_) => {
-        clearTimeout(f), s(_);
-      }, f = setTimeout(() => o(new N("The operation has timed out.")), t);
+      const r = (p) => {
+        clearTimeout(u), n(p);
+      }, o = (p) => {
+        clearTimeout(u), s(p);
+      }, u = setTimeout(() => o(new N("The operation has timed out.")), t);
       e(r, o);
     });
   }
   [Symbol.toStringTag] = "TimedPromise";
 }
-class U extends m {
+class te extends w {
   /**
    * The number of promises currently in the queue.
    */
@@ -4877,7 +5119,7 @@ class U extends m {
    * Accessing this property will always result in a {@link ValueException}.
    */
   get isRejected() {
-    throw new u("`PromiseQueue` doesn't support rejection states.");
+    throw new c("`PromiseQueue` doesn't support rejection states.");
   }
   /**
    * Initializes a new instance of the {@link PromiseQueue} class.
@@ -4897,16 +5139,16 @@ class U extends m {
         this._count -= 1, r(o);
       });
     };
-    return t ? new q(n, t) : new m(n);
+    return t ? new O(n, t) : new w(n);
   }
   [Symbol.toStringTag] = "PromiseQueue";
 }
-var S = /* @__PURE__ */ ((i) => (i[i.Millisecond = 1] = "Millisecond", i[i.Second = 1e3] = "Second", i[i.Minute = 6e4] = "Minute", i[i.Hour = 36e5] = "Hour", i[i.Day = 864e5] = "Day", i[i.Week = 6048e5] = "Week", i[i.Month = 2592e6] = "Month", i[i.Year = 31536e6] = "Year", i))(S || {}), I = /* @__PURE__ */ ((i) => (i[i.Sunday = 0] = "Sunday", i[i.Monday = 1] = "Monday", i[i.Tuesday = 2] = "Tuesday", i[i.Wednesday = 3] = "Wednesday", i[i.Thursday = 4] = "Thursday", i[i.Friday = 5] = "Friday", i[i.Saturday = 6] = "Saturday", i))(I || {});
-function ee(i, e, t = 864e5) {
+var k = /* @__PURE__ */ ((i) => (i[i.Millisecond = 1] = "Millisecond", i[i.Second = 1e3] = "Second", i[i.Minute = 6e4] = "Minute", i[i.Hour = 36e5] = "Hour", i[i.Day = 864e5] = "Day", i[i.Week = 6048e5] = "Week", i[i.Month = 2592e6] = "Month", i[i.Year = 31536e6] = "Year", i))(k || {}), $ = /* @__PURE__ */ ((i) => (i[i.Sunday = 0] = "Sunday", i[i.Monday = 1] = "Monday", i[i.Tuesday = 2] = "Tuesday", i[i.Wednesday = 3] = "Wednesday", i[i.Thursday = 4] = "Thursday", i[i.Friday = 5] = "Friday", i[i.Saturday = 6] = "Saturday", i))($ || {});
+function ne(i, e, t = 864e5) {
   let n;
   return i = new Date(i), e = new Date(e), i < e ? n = Math.floor : n = Math.ceil, n((e.getTime() - i.getTime()) / t);
 }
-function te(i, e, t = 864e5) {
+function se(i, e, t = 864e5) {
   if (i = new Date(i), e = new Date(e), i >= e)
     throw new x("The end date must be greater than the start date.");
   return new l(function* () {
@@ -4916,7 +5158,7 @@ function te(i, e, t = 864e5) {
       yield new Date(s), s += t;
   });
 }
-function $(i, e = 864e5) {
+function D(i, e = 864e5) {
   if (e <= 1)
     throw new x(
       "Rounding a timestamp by milliseconds or less makes no sense.Use the timestamp value directly instead."
@@ -4927,10 +5169,10 @@ function $(i, e = 864e5) {
     );
   return i = new Date(i), new Date(Math.floor(i.getTime() / e) * e);
 }
-function ne(i, e = 0) {
+function re(i, e = 0) {
   i = new Date(i);
   const t = 7 - e, n = (i.getUTCDay() + t) % 7, s = i.getTime() - 864e5 * n;
-  return $(new Date(s));
+  return D(new Date(s));
 }
 class C {
   /**
@@ -5016,7 +5258,7 @@ class C {
       `Not a browser environment detected. Using setInterval@${t}ms instead of requestAnimationFrame...`
     ), this._start = () => {
       this._handle = setInterval(() => e(this.elapsedTime), t);
-    }, this._stop = () => clearInterval(this._handle)), this._publisher = new v();
+    }, this._stop = () => clearInterval(this._handle)), this._publisher = new g();
   }
   /**
    * Starts the execution of the game loop.
@@ -5037,7 +5279,7 @@ class C {
    */
   start(e = 0) {
     if (this._isRunning)
-      throw new y("The game loop has already been started.");
+      throw new b("The game loop has already been started.");
     this._startTime = performance.now() - e, this._start(), this._isRunning = !0, this._publisher.publish("start");
   }
   /**
@@ -5055,9 +5297,9 @@ class C {
    */
   stop() {
     if (!this._isRunning)
-      throw new y("The game loop had already stopped or hadn't yet started.");
+      throw new b("The game loop had already stopped or hadn't yet started.");
     if (!this._handle)
-      throw new g();
+      throw new v();
     this._stop(), this._handle = void 0, this._isRunning = !1, this._publisher.publish("stop");
   }
   /**
@@ -5100,7 +5342,7 @@ class C {
   }
   [Symbol.toStringTag] = "GameLoop";
 }
-class se extends C {
+class ie extends C {
   /**
    * Initializes a new instance of the {@link Clock} class.
    *
@@ -5117,7 +5359,7 @@ class se extends C {
    * The interval in milliseconds at which the clock will tick if the environment is not a browser.  
    * `TimeUnit.Second` by default.
    */
-  constructor(e = S.Second) {
+  constructor(e = k.Second) {
     super((t) => this._publisher.publish("tick", t), e);
   }
   /**
@@ -5139,7 +5381,7 @@ class se extends C {
    */
   start(e = 0) {
     if (this._isRunning)
-      throw new y("The clock has already been started.");
+      throw new b("The clock has already been started.");
     this._startTime = performance.now() - e, this._start(), this._isRunning = !0, this._publisher.publish("start");
   }
   /**
@@ -5157,9 +5399,9 @@ class se extends C {
    */
   stop() {
     if (!this._isRunning)
-      throw new y("The clock had already stopped or hadn't yet started.");
+      throw new b("The clock had already stopped or hadn't yet started.");
     if (!this._handle)
-      throw new g();
+      throw new v();
     this._stop(), this._handle = void 0, this._isRunning = !1, this._publisher.publish("stop");
   }
   /**
@@ -5198,7 +5440,7 @@ class se extends C {
   }
   [Symbol.toStringTag] = "Clock";
 }
-class re extends C {
+class oe extends C {
   /**
    * The total duration of the countdown in milliseconds.
    *
@@ -5242,7 +5484,7 @@ class re extends C {
    * The interval in milliseconds at which the countdown will tick if the environment is not a browser.  
    * `TimeUnit.Second` by default.
    */
-  constructor(e, t = S.Second) {
+  constructor(e, t = k.Second) {
     const n = () => {
       const s = this.remainingTime;
       s <= 0 ? (this._deferrerStop(), this._publisher.publish("tick", 0), this._publisher.publish("expire")) : this._publisher.publish("tick", s);
@@ -5263,9 +5505,9 @@ class re extends C {
    */
   _deferrerStop(e) {
     if (!this._isRunning)
-      throw new y("The countdown hadn't yet started.");
+      throw new b("The countdown hadn't yet started.");
     if (!this._deferrer)
-      throw new g();
+      throw new v();
     this._stop(), this._handle = void 0, this._isRunning = !1, e !== void 0 ? this._deferrer.reject(e) : this._deferrer.resolve(), this._deferrer = void 0;
   }
   /**
@@ -5291,9 +5533,9 @@ class re extends C {
    */
   start(e = this.duration) {
     if (this._isRunning)
-      throw new y("The countdown had already stopped or hadn't yet started.");
+      throw new b("The countdown had already stopped or hadn't yet started.");
     if (this._deferrer)
-      throw new g();
+      throw new v();
     return this._deferrer = new F(), super.start(this.duration - e), this._publisher.publish("start"), this._deferrer;
   }
   /**
@@ -5376,7 +5618,7 @@ class re extends C {
   }
   [Symbol.toStringTag] = "Countdown";
 }
-class ie {
+class ae {
   /**
    * Generates a given number of values following a linear curve.  
    * The values are equally spaced and normalized between 0 and 1.
@@ -5434,7 +5676,7 @@ class ie {
    */
   static Exponential(e, t = 2) {
     if (t < 0)
-      throw new u("The base of the exponential curve cannot be negative.");
+      throw new c("The base of the exponential curve cannot be negative.");
     const n = e - 1;
     return new l(function* () {
       for (let s = 0; s < e; s += 1)
@@ -5493,7 +5735,7 @@ class P {
    */
   static Index(e) {
     if (e.length === 0)
-      throw new u("You must provide at least one element.");
+      throw new c("You must provide at least one element.");
     return this.Integer(e.length);
   }
   /**
@@ -5516,62 +5758,94 @@ class P {
   static Sample(e, t, n) {
     const s = e.length;
     if (s === 0)
-      throw new u("You must provide at least one element.");
+      throw new c("You must provide at least one element.");
     if (t < 0)
-      throw new u("Count must be non-negative.");
+      throw new c("Count must be non-negative.");
     if (t > s)
-      throw new u("Count cannot exceed the number of elements.");
+      throw new c("Count cannot exceed the number of elements.");
     if (t === 0)
       return [];
     if (n === void 0) {
-      const a = [...e], f = new Array(t);
-      for (let _ = 0; _ < t; _ += 1) {
-        const T = this.Integer(_, s);
-        f[_] = a[T], a[T] = a[_];
+      const a = Array.from(e), u = new Array(t);
+      for (let p = 0; p < t; p += 1) {
+        const T = this.Integer(p, s);
+        u[p] = a[T], a[T] = a[p];
       }
-      return f;
+      return u;
     }
     if (n.length !== s)
-      throw new u("Weights array must have the same length as elements array.");
+      throw new c("Weights array must have the same length as elements array.");
     const r = new Array(s);
     for (let a = 0; a < s; a += 1) {
       if (n[a] <= 0)
-        throw new u(`Weight for element #${a} must be greater than zero.`);
+        throw new c(`Weight for element #${a} must be greater than zero.`);
       r[a] = { index: a, key: Math.pow(Math.random(), 1 / n[a]) };
     }
-    r.sort((a, f) => f.key - a.key);
+    r.sort((a, u) => u.key - a.key);
     const o = new Array(t);
     for (let a = 0; a < t; a += 1)
       o[a] = e[r[a].index];
     return o;
   }
+  static #e(e, t) {
+    const n = new Array(t - 1);
+    for (let a = 0; a < n.length; a += 1)
+      n[a] = Math.random() * e;
+    n.sort((a, u) => a - u);
+    const s = [0, ...n, e], r = new Array(t);
+    for (let a = 0; a < t; a += 1)
+      r[a] = Math.floor(s[a + 1] - s[a]);
+    let o = e - r.reduce((a, u) => a + u, 0);
+    for (; o > 0; )
+      r[this.Integer(t)] += 1, o -= 1;
+    return r;
+  }
+  static Split(e, t) {
+    if (t < 1)
+      throw new c("The number of splits must be greater than zero.");
+    if (typeof e == "number") {
+      if (e < 0)
+        throw new c("The total must be a non-negative number.");
+      return this.#e(e, t);
+    }
+    const n = Array.from(e), s = n.length;
+    if (s === 0)
+      throw new c("You must provide at least one element.");
+    if (t > s)
+      throw new c("The number of splits cannot exceed the number of elements.");
+    const r = this.#e(s, t), o = new Array(t);
+    let a = 0;
+    for (let u = 0; u < t; u += 1)
+      o[u] = n.slice(a, a + r[u]), a += r[u];
+    return o;
+  }
   constructor() {
   }
   [Symbol.toStringTag] = "Random";
 }
-function oe(i) {
-  return new m((e) => setTimeout(e, i));
+function le(i) {
+  return new w((e) => setTimeout(e, i));
 }
-function ae() {
-  return new m((i) => requestAnimationFrame(() => i()));
+function ue() {
+  return new w((i) => requestAnimationFrame(() => i()));
 }
-function le() {
-  return new m((i) => setTimeout(i));
+function ce() {
+  return new w((i) => setTimeout(i));
 }
-function ue(i, e = "text/javascript") {
-  return new m((t, n) => {
+function he(i, e = "text/javascript") {
+  return new w((t, n) => {
     const s = document.createElement("script");
     s.async = !0, s.defer = !0, s.src = i, s.type = e, s.onload = (r) => t(), s.onerror = (r) => n(r), document.body.appendChild(s);
   });
 }
-function ce(...i) {
+function fe(...i) {
   return new l(function* () {
     for (const e of i)
       for (const t of e)
         yield t;
   });
 }
-function he(i) {
+function de(i) {
   if (i instanceof Array)
     return i.length;
   let e = 0;
@@ -5579,14 +5853,14 @@ function he(i) {
     e += 1;
   return e;
 }
-function fe(i) {
+function me(i) {
   return new l(function* () {
     let e = 0;
     for (const t of i)
       yield [e, t], e += 1;
   });
 }
-function de(i, e, t = 1) {
+function we(i, e, t = 1) {
   if (t <= 0)
     throw new x(
       "Step must be always a positive number, even when generating numbers in reverse order."
@@ -5599,7 +5873,7 @@ function de(i, e, t = 1) {
       yield n;
   });
 }
-function we(i) {
+function pe(i) {
   const e = Array.from(i);
   for (let t = e.length - 1; t > 0; t -= 1) {
     const n = Math.floor(Math.random() * (t + 1));
@@ -5607,14 +5881,14 @@ function we(i) {
   }
   return e;
 }
-function me(i) {
+function _e(i) {
   return new l(function* () {
     const e = /* @__PURE__ */ new Set();
     for (const t of i)
       e.has(t) || (e.add(t), yield t);
   });
 }
-function D(i, e) {
+function Y(i, e) {
   const t = i[Symbol.iterator](), n = e[Symbol.iterator]();
   return new l(function* () {
     for (; ; ) {
@@ -5625,28 +5899,28 @@ function D(i, e) {
     }
   });
 }
-function _e(i, e) {
+function be(i, e) {
   if (e === void 0) {
     let r = 0, o = 0;
     for (const a of i)
       r += a, o += 1;
     if (o === 0)
-      throw new u("You must provide at least one value.");
+      throw new c("You must provide at least one value.");
     return r / o;
   }
   let t = 0, n = 0, s = 0;
-  for (const [r, o] of D(i, e)) {
+  for (const [r, o] of Y(i, e)) {
     if (o <= 0)
-      throw new u(`The weight for the value #${s} must be greater than zero.`);
+      throw new c(`The weight for the value #${s} must be greater than zero.`);
     t += r * o, n += o, s += 1;
   }
   if (s === 0)
-    throw new u("You must provide at least one value and weight.");
+    throw new c("You must provide at least one value and weight.");
   if (n <= 0)
-    throw new u("The sum of weights must be greater than zero.");
+    throw new c("The sum of weights must be greater than zero.");
   return t / n;
 }
-function pe(i) {
+function ye(i) {
   let e = 0;
   for (let t = 0; t < i.length; t += 1) {
     const n = i.charCodeAt(t);
@@ -5654,78 +5928,80 @@ function pe(i) {
   }
   return e;
 }
-function ye(i) {
+function xe(i) {
   let e = 0;
   for (const t of i)
     e += t;
   return e;
 }
-function be(i) {
+function ge(i) {
   return `${i.charAt(0).toUpperCase()}${i.slice(1)}`;
 }
-const xe = "2.2.3";
+const ve = "2.2.4";
 export {
-  p as AggregatedAsyncIterator,
+  _ as AggregatedAsyncIterator,
   d as AggregatedIterator,
+  Z as ArrayView,
   R as CallableObject,
-  Q as CallbackChain,
-  se as Clock,
-  re as Countdown,
-  ie as Curve,
+  H as CallbackChain,
+  ie as Clock,
+  oe as Countdown,
+  ae as Curve,
   F as DeferredPromise,
-  O as EnvironmentException,
-  h as Exception,
-  g as FatalErrorException,
+  z as EnvironmentException,
+  f as Exception,
+  v as FatalErrorException,
   M as FileException,
   J as FileExistsException,
   L as FileNotFoundException,
   C as GameLoop,
-  W as JSONStorage,
-  b as KeyException,
-  X as MapView,
-  V as NetworkException,
+  ee as JSONStorage,
+  y as KeyException,
+  W as MapView,
+  A as NetworkException,
   j as NotImplementedException,
-  G as PermissionException,
-  U as PromiseQueue,
-  v as Publisher,
+  K as PermissionException,
+  te as PromiseQueue,
+  g as Publisher,
   P as Random,
   x as RangeException,
-  c as ReducedIterator,
-  k as ReferenceException,
-  y as RuntimeException,
-  Z as SetView,
-  w as SmartAsyncIterator,
+  h as ReducedIterator,
+  S as ReferenceException,
+  G as ResponseException,
+  b as RuntimeException,
+  U as SetView,
+  m as SmartAsyncIterator,
   l as SmartIterator,
-  m as SmartPromise,
-  H as SwitchableCallback,
-  S as TimeUnit,
-  q as TimedPromise,
+  w as SmartPromise,
+  X as SwitchableCallback,
+  k as TimeUnit,
+  O as TimedPromise,
   N as TimeoutException,
-  K as TypeException,
-  xe as VERSION,
-  u as ValueException,
-  I as WeekDay,
-  _e as average,
-  be as capitalize,
-  ce as chain,
-  he as count,
-  ee as dateDifference,
-  te as dateRange,
-  $ as dateRound,
-  oe as delay,
-  fe as enumerate,
-  ne as getWeek,
-  pe as hash,
+  Q as TypeException,
+  ve as VERSION,
+  c as ValueException,
+  $ as WeekDay,
+  be as average,
+  ge as capitalize,
+  fe as chain,
+  de as count,
+  ne as dateDifference,
+  se as dateRange,
+  D as dateRound,
+  le as delay,
+  me as enumerate,
+  re as getWeek,
+  ye as hash,
   E as isBrowser,
   B as isNode,
-  Y as isWorker,
-  ue as loadScript,
-  ae as nextAnimationFrame,
-  de as range,
-  we as shuffle,
-  ye as sum,
-  me as unique,
-  le as yieldToEventLoop,
-  D as zip
+  V as isWorker,
+  he as loadScript,
+  ue as nextAnimationFrame,
+  we as range,
+  pe as shuffle,
+  xe as sum,
+  _e as unique,
+  ce as yieldToEventLoop,
+  Y as zip
 };
 //# sourceMappingURL=core.esm.js.map