Add polyfill for Array.prototype.with()

d2bs/kolbot/libs/Polyfill.js

@@ -676,6 +676,29 @@ if (!Array.prototype.toSpliced) {
   };
 }
 
+/**
+ * @description The with() method of Array instances is the copying version of using the bracket notation to change the value of a given index.
+ * It returns a new array with the element at the given index replaced with the given value.
+ * @param {number} index - Zero-based index at which to change the array, converted to an integer.
+ * @param {*} value - Any value to be assigned to the given index.
+ * @returns {Array} A new array with the element at index replaced with value.
+ * @throws {RangeError} If index >= array.length or index < -array.length.
+ */
+if (!Array.prototype.with) {
+  Array.prototype.with = function (index, value) {
+    const len = this.length;
+    const relativeIndex = index < 0 ? len + index : index;
+
+    if (relativeIndex < 0 || relativeIndex >= len) {
+      throw new RangeError("Index out of range");
+    }
+
+    const newArray = this.slice();
+    newArray[relativeIndex] = value;
+    return newArray;
+  };
+}
+
 /**
  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ //
  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Object Polyfills ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ //

d2bs/kolbot/sdk/globals.d.ts

@@ -81,6 +81,15 @@ declare global {
      * @returns {Array<T>} A new array with the removed elements and optionally added elements.
      */
     toSpliced(start: number, deleteCount?: number, ...items: T[]): T[];
+    /**
+     * @description The with() method of Array instances is the copying version of using the bracket notation to change the value of a given index.
+     * It returns a new array with the element at the given index replaced with the given value.
+     * @param {number} index - Zero-based index at which to change the array, converted to an integer.
+     * @param {*} value - Any value to be assigned to the given index.
+     * @returns {Array} A new array with the element at index replaced with value.
+     * @throws {RangeError} If index >= array.length or index < -array.length.
+     */
+    with(index: number, value: T): T[];
   }
 
   interface String {