isaacscript-common 6.6.1-dev.1 → 6.6.1-dev.2

package/functions/ambush.js

@@ -0,0 +1,35 @@
+import { SackSubType } from "isaac-typescript-definitions";
+import { runNextGameFrame } from "../features/runInNFrames";
+import { removeEntities } from "./entity";
+import { getCoins, spawnSackWithSeed } from "./pickups";
+/** Hard-coding this makes it easier to clean up the pickups afterwards. */
+const SACK_SEED_THAT_SPAWNS_TWO_COINS = 6;
+/**
+ * Helper function to start a Challenge Room or the Boss Rush.
+ *
+ * Specifically, this is performed by spawning a sack on top of the player, waiting a game frame,
+ * and then removing the sack and the pickups that the sack dropped.
+ */
+export function startAmbush() {
+    const player = Isaac.GetPlayer();
+    const sack = spawnSackWithSeed(SackSubType.NULL, player.Position, SACK_SEED_THAT_SPAWNS_TWO_COINS);
+    // The sack will play the "Appear" animation and the player will not be able to interact with it
+    // while this is occurring. By stopping the animation, it will transition to the "Idle" animation
+    // and be interactable on the next game frame.
+    const sprite = sack.GetSprite();
+    sprite.Stop();
+    const sackPtr = EntityPtr(sack);
+    runNextGameFrame(() => {
+        const futureSack = sackPtr.Ref;
+        if (futureSack === undefined) {
+            return;
+        }
+        futureSack.Remove();
+        const sackPtrHash = GetPtrHash(futureSack);
+        const coins = getCoins();
+        const coinsFromSack = coins.filter((pickup) => pickup.SpawnerEntity !== undefined &&
+            GetPtrHash(pickup.SpawnerEntity) === sackPtrHash);
+        removeEntities(coinsFromSack);
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYW1idXNoLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvYW1idXNoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUM1RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQzFDLE9BQU8sRUFBRSxRQUFRLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFFeEQsMkVBQTJFO0FBQzNFLE1BQU0sK0JBQStCLEdBQUcsQ0FBUyxDQUFDO0FBRWxEOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLFdBQVc7SUFDekIsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ2pDLE1BQU0sSUFBSSxHQUFHLGlCQUFpQixDQUM1QixXQUFXLENBQUMsSUFBSSxFQUNoQixNQUFNLENBQUMsUUFBUSxFQUNmLCtCQUErQixDQUNoQyxDQUFDO0lBRUYsZ0dBQWdHO0lBQ2hHLGlHQUFpRztJQUNqRyw4Q0FBOEM7SUFDOUMsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ2hDLE1BQU0sQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNkLE1BQU0sT0FBTyxHQUFHLFNBQVMsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNoQyxnQkFBZ0IsQ0FBQyxHQUFHLEVBQUU7UUFDcEIsTUFBTSxVQUFVLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQztRQUMvQixJQUFJLFVBQVUsS0FBSyxTQUFTLEVBQUU7WUFDNUIsT0FBTztTQUNSO1FBRUQsVUFBVSxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ3BCLE1BQU0sV0FBVyxHQUFHLFVBQVUsQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUMzQyxNQUFNLEtBQUssR0FBRyxRQUFRLEVBQUUsQ0FBQztRQUN6QixNQUFNLGFBQWEsR0FBRyxLQUFLLENBQUMsTUFBTSxDQUNoQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQ1QsTUFBTSxDQUFDLGFBQWEsS0FBSyxTQUFTO1lBQ2xDLFVBQVUsQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFDLEtBQUssV0FBVyxDQUNuRCxDQUFDO1FBQ0YsY0FBYyxDQUFDLGFBQWEsQ0FBQyxDQUFDO0lBQ2hDLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyJ9

package/functions/array.js

@@ -0,0 +1,423 @@
+import { getRandomInt } from "./random";
+import { getRandomSeed, isRNG, newRNG } from "./rng";
+import { isNumber, isTable } from "./types";
+import { erange, repeat } from "./utils";
+/**
+ * Helper function for determining if two arrays contain the exact same elements. Note that this
+ * only performs a shallow comparison.
+ */
+export function arrayEquals(array1, array2) {
+    if (array1.length !== array2.length) {
+        return false;
+    }
+    return array1.every((array1Element, i) => {
+        const array2Element = array2[i];
+        return array1Element === array2Element;
+    });
+}
+/**
+ * Shallow copies and removes the specified element(s) from the array. Returns the copied array. If
+ * the specified element(s) are not found in the array, it will simply return a shallow copy of the
+ * array.
+ *
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ *
+ * If there is more than one matching element in the array, this function will only remove the first
+ * matching element. If you want to remove all of the elements, use the `arrayRemoveAll` function
+ * instead.
+ */
+export function arrayRemove(originalArray, ...elementsToRemove) {
+    const array = copyArray(originalArray);
+    arrayRemoveInPlace(array, ...elementsToRemove);
+    return array;
+}
+/**
+ * Shallow copies and removes the specified element(s) from the array. Returns the copied array. If
+ * the specified element(s) are not found in the array, it will simply return a shallow copy of the
+ * array.
+ *
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ *
+ * If there is more than one matching element in the array, this function will remove every matching
+ * element. If you want to only remove the first matching element, use the `arrayRemove` function
+ * instead.
+ */
+export function arrayRemoveAll(originalArray, ...elementsToRemove) {
+    const array = copyArray(originalArray);
+    arrayRemoveAllInPlace(array, ...elementsToRemove);
+    return array;
+}
+/**
+ * Removes all of the specified element(s) from the array. If the specified element(s) are not found
+ * in the array, this function will do nothing.
+ *
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ *
+ * If there is more than one matching element in the array, this function will remove every matching
+ * element. If you want to only remove the first matching element, use the `arrayRemoveInPlace`
+ * function instead.
+ *
+ * @returns True if one or more elements were removed, false otherwise.
+ */
+export function arrayRemoveAllInPlace(array, ...elementsToRemove) {
+    let removedOneOrMoreElements = false;
+    for (const element of elementsToRemove) {
+        let index;
+        do {
+            index = array.indexOf(element);
+            if (index > -1) {
+                removedOneOrMoreElements = true;
+                array.splice(index, 1);
+            }
+        } while (index > -1);
+    }
+    return removedOneOrMoreElements;
+}
+/**
+ * Removes the specified element(s) from the array. If the specified element(s) are not found in the
+ * array, this function will do nothing.
+ *
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ *
+ * If there is more than one matching element in the array, this function will only remove the first
+ * matching element. If you want to remove all of the elements, use the `arrayRemoveAllInPlace`
+ * function instead.
+ *
+ * @returns True if one or more elements were removed, false otherwise.
+ */
+export function arrayRemoveInPlace(array, ...elementsToRemove) {
+    let removedOneOrMoreElements = false;
+    for (const element of elementsToRemove) {
+        const index = array.indexOf(element);
+        if (index > -1) {
+            removedOneOrMoreElements = true;
+            array.splice(index, 1);
+        }
+    }
+    return removedOneOrMoreElements;
+}
+/**
+ * Shallow copies and removes the elements at the specified indexes from the array. Returns the
+ * copied array. If the specified indexes are not found in the array, it will simply return a
+ * shallow copy of the array.
+ *
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ */
+export function arrayRemoveIndex(originalArray, ...indexesToRemove) {
+    const indexesToRemoveSet = new Set(indexesToRemove);
+    const array = [];
+    originalArray.forEach((element, i) => {
+        if (!indexesToRemoveSet.has(i)) {
+            array.push(element);
+        }
+    });
+    return array;
+}
+/**
+ * Removes the elements at the specified indexes from the array. If the specified indexes are not
+ * found in the array, this function will do nothing. Returns true if one or more elements were
+ * removed.
+ *
+ * This function is variadic, meaning that you can specify N arguments to remove N elements.
+ *
+ * @returns Whether or not any array elements were removed.
+ */
+export function arrayRemoveIndexInPlace(array, ...indexesToRemove) {
+    const legalIndexes = indexesToRemove.filter((i) => i >= 0 && i < array.length);
+    legalIndexes.sort();
+    if (legalIndexes.length === 0) {
+        return false;
+    }
+    for (let i = array.length - 1; i >= 0; i--) {
+        array.splice(i, 1);
+    }
+    return true;
+}
+export function arrayToString(array) {
+    if (array.length === 0) {
+        return "[]";
+    }
+    const strings = array.map((element) => tostring(element));
+    const commaSeparatedStrings = strings.join(", ");
+    return `[${commaSeparatedStrings}]`;
+}
+/**
+ * Helper function to combine two or more arrays. Returns a new array that is the composition of all
+ * of the specified arrays.
+ *
+ * This function is variadic, meaning that you can specify N arguments to combine N arrays. Note
+ * that this will only perform a shallow copy of the array elements.
+ */
+export function combineArrays(...arrays) {
+    const elements = [];
+    for (const array of arrays) {
+        for (const element of array) {
+            elements.push(element);
+        }
+    }
+    return elements;
+}
+/**
+ * Helper function to perform a shallow copy.
+ *
+ * @param oldArray The array to copy.
+ * @param numElements Optional. If specified, will only copy the first N elements. By default, the
+ *                    entire array will be copied.
+ */
+export function copyArray(oldArray, numElements) {
+    if (numElements === undefined) {
+        numElements = oldArray.length;
+    }
+    const newArray = [];
+    for (let i = 0; i < numElements; i++) {
+        const oldElement = oldArray[i];
+        if (oldElement !== undefined) {
+            newArray.push(oldElement);
+        }
+    }
+    return newArray;
+}
+/** Helper function to remove all of the elements in an array in-place. */
+export function emptyArray(array) {
+    array.splice(0, array.length);
+}
+/**
+ * Helper function to get all possible combinations of the given array. This includes the
+ * combination of an empty array.
+ *
+ * For example, if this function is provided an array containing 1, 2, and 3, then it will return an
+ * array containing the following arrays:
+ *
+ * - [] (if `includeEmptyArray` is set to true)
+ * - [1]
+ * - [2]
+ * - [3]
+ * - [1, 2]
+ * - [1, 3]
+ * - [2, 3]
+ * - [1, 2, 3]
+ *
+ * From: https://github.com/firstandthird/combinations/blob/master/index.js
+ *
+ * @param array The array to get the combinations of.
+ * @param includeEmptyArray Whether or not to include an empty array in the combinations.
+ * @param min Optional. The minimum number of elements to include in each combination. Default is 1.
+ * @param max Optional. The maximum number of elements to include in each combination. Default is
+ *            the length of the array.
+ */
+export function getArrayCombinations(array, includeEmptyArray, min, max) {
+    if (min === undefined || min <= 0) {
+        min = 1;
+    }
+    if (max === undefined || max <= 0) {
+        max = array.length;
+    }
+    const addCombinations = (n, src, got, all) => {
+        if (n === 0) {
+            if (got.length > 0) {
+                all[all.length] = got;
+            }
+            return;
+        }
+        for (let j = 0; j < src.length; j++) {
+            const value = src[j]; // eslint-disable-line @typescript-eslint/no-non-null-assertion
+            addCombinations(n - 1, src.slice(j + 1), got.concat([value]), all);
+        }
+    };
+    const all = [];
+    for (let i = min; i < array.length; i++) {
+        addCombinations(i, array, [], all);
+    }
+    if (array.length === max) {
+        all.push(array);
+    }
+    // Finally, account for the empty array combination.
+    if (includeEmptyArray) {
+        all.unshift([]);
+    }
+    return all;
+}
+/**
+ * Helper function to get an array containing the indexes of an array.
+ *
+ * For example, an array of `["Apple", "Banana"]` would return an array of `[0, 1]`.
+ */
+export function getArrayIndexes(array) {
+    return erange(array.length);
+}
+/**
+ * Helper function to return the last element of an array.
+ *
+ * If the array is empty, this will return undefined.
+ */
+export function getLastElement(array) {
+    return array[array.length - 1];
+}
+/**
+ * Helper function to get a random element from the provided array.
+ *
+ * @param array The array to get an element from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export function getRandomArrayElement(array, seedOrRNG = getRandomSeed(), exceptions = []) {
+    if (array.length === 0) {
+        error("Failed to get a random array element since the provided array is empty.");
+    }
+    const arrayWithoutExceptions = arrayRemove(array, ...exceptions);
+    const randomIndex = getRandomArrayIndex(arrayWithoutExceptions, seedOrRNG);
+    const randomElement = arrayWithoutExceptions[randomIndex];
+    if (randomElement === undefined) {
+        error(`Failed to get a random array element since the random index of ${randomIndex} was not valid.`);
+    }
+    return randomElement;
+}
+/**
+ * Helper function to get a random element from the provided array. Once the random element is
+ * decided, it is then removed from the array (in-place).
+ *
+ * @param array The array to get an element from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export function getRandomArrayElementAndRemove(array, seedOrRNG = getRandomSeed(), exceptions = []) {
+    const randomArrayElement = getRandomArrayElement(array, seedOrRNG, exceptions);
+    arrayRemoveInPlace(array, randomArrayElement);
+    return randomArrayElement;
+}
+/**
+ * Helper function to get a random index from the provided array.
+ *
+ * @param array The array to get the index from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param exceptions Optional. An array of indexes that will be skipped over when getting the random
+ *                   index. Default is an empty array.
+ */
+export function getRandomArrayIndex(array, seedOrRNG = getRandomSeed(), exceptions = []) {
+    if (array.length === 0) {
+        error("Failed to get a random array index since the provided array is empty.");
+    }
+    return getRandomInt(0, array.length - 1, seedOrRNG, exceptions);
+}
+/**
+ * Initializes an array with all elements containing the specified default value.
+ *
+ * For example:
+ *
+ * ```ts
+ * const playerTransformations = initArray(false, PlayerForm.NUM_PLAYER_FORMS - 1);
+ * ```
+ */
+export function initArray(defaultValue, size) {
+    const array = [];
+    repeat(size, () => {
+        array.push(defaultValue);
+    });
+    return array;
+}
+/**
+ * Since Lua uses tables for every non-primitive data structure, it is non-trivial to determine if a
+ * particular table is being used as an array. `isArray` returns true if:
+ *
+ * - the table contains all numerical indexes that are contiguous, starting at 1
+ * - the table has no keys (i.e. an "empty" table)
+ */
+export function isArray(object) {
+    if (!isTable(object)) {
+        return false;
+    }
+    // First, if there is a metatable, this cannot be a simple array and must be a more complex
+    // object.
+    const metatable = getmetatable(object);
+    if (metatable !== undefined) {
+        return false;
+    }
+    // Second, handle the case of non-numerical keys.
+    const keys = Object.keys(object);
+    const hasAllNumberKeys = keys.every((key) => isNumber(key));
+    if (!hasAllNumberKeys) {
+        return false;
+    }
+    const tableLength = object.length();
+    if (tableLength === 0) {
+        return true;
+    }
+    // Third, check for non-contiguous elements. (Lua tables start at an index of 1.)
+    for (let i = 1; i <= tableLength; i++) {
+        const element = object.get(i);
+        if (element === undefined) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Helper function to see if every element in the array is N + 1.
+ *
+ * For example, `[2, 3, 4]` would return true, and `[2, 3, 5]` would return false.
+ */
+export function isArrayContiguous(array) {
+    let lastValue;
+    for (const element of array) {
+        if (lastValue === undefined) {
+            lastValue = element - 1;
+        }
+        if (element !== lastValue - 1) {
+            return false;
+        }
+    }
+    return true;
+}
+/** Checks if an array is in the provided 2-dimensional array. */
+export function isArrayInArray(arrayToMatch, parentArray) {
+    return parentArray.some((element) => arrayEquals(element, arrayToMatch));
+}
+/**
+ * Shallow copies and shuffles the array using the Fisher-Yates algorithm. Returns the copied array.
+ *
+ * From: https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
+ *
+ * @param originalArray The array to shuffle.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ */
+export function shuffleArray(originalArray, seedOrRNG = getRandomSeed()) {
+    const array = copyArray(originalArray);
+    shuffleArrayInPlace(array, seedOrRNG);
+    return array;
+}
+/**
+ * Shuffles the provided array in-place using the Fisher-Yates algorithm.
+ *
+ * From: https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
+ *
+ * @param array The array to shuffle.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ */
+export function shuffleArrayInPlace(array, seedOrRNG = getRandomSeed()) {
+    let currentIndex = array.length;
+    const rng = isRNG(seedOrRNG) ? seedOrRNG : newRNG(seedOrRNG);
+    while (currentIndex > 0) {
+        currentIndex -= 1;
+        const randomIndex = getRandomArrayIndex(array, rng);
+        swapArrayElements(array, currentIndex, randomIndex);
+    }
+}
+/** Helper function to sum every value in an array together. */
+export function sumArray(array) {
+    return array.reduce((accumulator, element) => accumulator + element);
+}
+/**
+ * Helper function to swap two different array elements. (The elements will be swapped in-place.)
+ */
+export function swapArrayElements(array, i, j) {
+    const value1 = array[i]; // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    const value2 = array[j]; // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    array[i] = value2;
+    array[j] = value1;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJyYXkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9hcnJheS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxhQUFhLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLE9BQU8sQ0FBQztBQUNyRCxPQUFPLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUM1QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUV6Qzs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsV0FBVyxDQUN6QixNQUEwQixFQUMxQixNQUEwQjtJQUUxQixJQUFJLE1BQU0sQ0FBQyxNQUFNLEtBQUssTUFBTSxDQUFDLE1BQU0sRUFBRTtRQUNuQyxPQUFPLEtBQUssQ0FBQztLQUNkO0lBRUQsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsYUFBYSxFQUFFLENBQUMsRUFBRSxFQUFFO1FBQ3ZDLE1BQU0sYUFBYSxHQUFHLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUNoQyxPQUFPLGFBQWEsS0FBSyxhQUFhLENBQUM7SUFDekMsQ0FBQyxDQUFDLENBQUM7QUFDTCxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7R0FVRztBQUNILE1BQU0sVUFBVSxXQUFXLENBQ3pCLGFBQWlDLEVBQ2pDLEdBQUcsZ0JBQXFCO0lBRXhCLE1BQU0sS0FBSyxHQUFHLFNBQVMsQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUN2QyxrQkFBa0IsQ0FBQyxLQUFLLEVBQUUsR0FBRyxnQkFBZ0IsQ0FBQyxDQUFDO0lBQy9DLE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQztBQUVEOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFNLFVBQVUsY0FBYyxDQUM1QixhQUFpQyxF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

package/functions/benchmark.js

@@ -0,0 +1,28 @@
+import { log } from "./log";
+/**
+ * Helper function to benchmark the performance of a function.
+ *
+ * This function is variadic, which means that you can supply as many as you want to benchmark.
+ *
+ * @returns An array containing the average time in milliseconds for each function. (This will also
+ *          be printed to the log.)
+ */
+export function benchmark(numTrials, ...functions) {
+    log(`Benchmarking ${functions.length} function(s) with ${numTrials} trials.`);
+    const averages = [];
+    functions.forEach((func, i) => {
+        let totalTimeMilliseconds = 0;
+        for (let j = 0; j < numTrials; j++) {
+            const startTimeMilliseconds = Isaac.GetTime();
+            func();
+            const endTimeMilliseconds = Isaac.GetTime();
+            const elapsedTimeMilliseconds = endTimeMilliseconds - startTimeMilliseconds;
+            totalTimeMilliseconds += elapsedTimeMilliseconds;
+        }
+        const averageTimeMilliseconds = totalTimeMilliseconds / numTrials;
+        log(`The average time of the function at index ${i} is: ${averageTimeMilliseconds} milliseconds`);
+        averages.push(averageTimeMilliseconds);
+    });
+    return averages;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmVuY2htYXJrLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvaXNhYWNzY3JpcHQtY29tbW9uL3NyYy9mdW5jdGlvbnMvYmVuY2htYXJrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSxPQUFPLENBQUM7QUFFNUI7Ozs7Ozs7R0FPRztBQUNILE1BQU0sVUFBVSxTQUFTLENBQ3ZCLFNBQWMsRUFDZCxHQUFHLFNBQTRCO0lBRS9CLEdBQUcsQ0FBQyxnQkFBZ0IsU0FBUyxDQUFDLE1BQU0scUJBQXFCLFNBQVMsVUFBVSxDQUFDLENBQUM7SUFFOUUsTUFBTSxRQUFRLEdBQVUsRUFBRSxDQUFDO0lBQzNCLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxFQUFFLEVBQUU7UUFDNUIsSUFBSSxxQkFBcUIsR0FBRyxDQUFDLENBQUM7UUFDOUIsS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLFNBQVMsRUFBRSxDQUFDLEVBQUUsRUFBRTtZQUNsQyxNQUFNLHFCQUFxQixHQUFHLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUM5QyxJQUFJLEVBQUUsQ0FBQztZQUNQLE1BQU0sbUJBQW1CLEdBQUcsS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQzVDLE1BQU0sdUJBQXVCLEdBQzNCLG1CQUFtQixHQUFHLHFCQUFxQixDQUFDO1lBQzlDLHFCQUFxQixJQUFJLHVCQUF1QixDQUFDO1NBQ2xEO1FBQ0QsTUFBTSx1QkFBdUIsR0FBRyxxQkFBcUIsR0FBRyxTQUFTLENBQUM7UUFDbEUsR0FBRyxDQUNELDZDQUE2QyxDQUFDLFFBQVEsdUJBQXVCLGVBQWUsQ0FDN0YsQ0FBQztRQUNGLFFBQVEsQ0FBQyxJQUFJLENBQUMsdUJBQXVCLENBQUMsQ0FBQztJQUN6QyxDQUFDLENBQUMsQ0FBQztJQUVILE9BQU8sUUFBUSxDQUFDO0FBQ2xCLENBQUMifQ==

package/functions/bitwise.js

@@ -0,0 +1,74 @@
+import { addFlag } from "./flag";
+/** Helper function to convert a set of flags to a single `BitFlags` object. */
+export function arrayToBitFlags(array) {
+    let flags = 0;
+    for (const flag of array) {
+        flags = addFlag(flags, flag);
+    }
+    return flags;
+}
+/** Helper function to convert an array of bits to the resulting decimal number. */
+export function convertBinaryToDecimal(bits) {
+    const bitsString = bits.join("");
+    return parseInt(bitsString, 2);
+}
+/**
+ * Helper function to convert a number to an array of bits.
+ *
+ * @param number The number to convert.
+ * @param minLength Optional. Equal to the minimum amount of bits that should be returned. If the
+ *                  converted number of bits is below this number, 0's will be padded to the left
+ *                  side until the minimum length is met. Default is undefined (which will not cause
+ *                  any padding).
+ */
+export function convertDecimalToBinary(number, minLength) {
+    const bits = [];
+    const bitsString = number.toString(2);
+    for (const bitString of bitsString) {
+        const bit = tonumber(bitString);
+        if (bit === undefined) {
+            error(`Failed to convert the following number to binary: ${number}`);
+        }
+        bits.push(bit);
+    }
+    if (minLength !== undefined) {
+        while (bits.length < minLength) {
+            bits.unshift(0);
+        }
+    }
+    return bits;
+}
+/**
+ * Helper function to count the number of bits that are set to 1 in a binary representation of a
+ * number.
+ */
+export function countSetBits(n) {
+    let count = 0;
+    while (n > 0) {
+        n &= n - 1;
+        count += 1;
+    }
+    return count;
+}
+/** Helper function to get the value of a specific but in a binary representation of a number. */
+export function getKBitOfN(k, n) {
+    return (n >>> k) & 1;
+}
+/** Helper function to get the number of bits in a binary representation of a number. */
+export function getNumBitsOfN(n) {
+    let numBits = 0;
+    while (n > 0) {
+        numBits += 1;
+        n >>>= 1;
+    }
+    return numBits;
+}
+/** Helper function to convert a set of flags to a single `BitFlags` object. */
+export function setToBitFlags(set) {
+    let flags = 0;
+    for (const flag of set.values()) {
+        flags = addFlag(flags, flag);
+    }
+    return flags;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYml0d2lzZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZnVuY3Rpb25zL2JpdHdpc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFFBQVEsQ0FBQztBQUVqQywrRUFBK0U7QUFDL0UsTUFBTSxVQUFVLGVBQWUsQ0FDN0IsS0FBeUI7SUFFekIsSUFBSSxLQUFLLEdBQUcsQ0FBZ0IsQ0FBQztJQUM3QixLQUFLLE1BQU0sSUFBSSxJQUFJLEtBQUssRUFBRTtRQUN4QixLQUFLLEdBQUcsT0FBTyxDQUFDLEtBQUssRUFBRSxJQUFJLENBQUMsQ0FBQztLQUM5QjtJQUVELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQztBQUVELG1GQUFtRjtBQUNuRixNQUFNLFVBQVUsc0JBQXNCLENBQUMsSUFBVztJQUNoRCxNQUFNLFVBQVUsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ2pDLE9BQU8sUUFBUSxDQUFDLFVBQVUsRUFBRSxDQUFDLENBQUMsQ0FBQztBQUNqQyxDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLFVBQVUsc0JBQXNCLENBQUMsTUFBYyxFQUFFLFNBQWU7SUFDcEUsTUFBTSxJQUFJLEdBQVUsRUFBRSxDQUFDO0lBRXZCLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDdEMsS0FBSyxNQUFNLFNBQVMsSUFBSSxVQUFVLEVBQUU7UUFDbEMsTUFBTSxHQUFHLEdBQUcsUUFBUSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ2hDLElBQUksR0FBRyxLQUFLLFNBQVMsRUFBRTtZQUNyQixLQUFLLENBQUMscURBQXFELE1BQU0sRUFBRSxDQUFDLENBQUM7U0FDdEU7UUFDRCxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0tBQ2hCO0lBRUQsSUFBSSxTQUFTLEtBQUssU0FBUyxFQUFFO1FBQzNCLE9BQU8sSUFBSSxDQUFDLE1BQU0sR0FBRyxTQUFTLEVBQUU7WUFDOUIsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQztTQUNqQjtLQUNGO0lBRUQsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLFlBQVksQ0FBQyxDQUFNO0lBQ2pDLElBQUksS0FBSyxHQUFHLENBQUMsQ0FBQztJQUVkLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRTtRQUNaLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ1gsS0FBSyxJQUFJLENBQUMsQ0FBQztLQUNaO0lBRUQsT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDO0FBRUQsaUdBQWlHO0FBQ2pHLE1BQU0sVUFBVSxVQUFVLENBQUMsQ0FBTSxFQUFFLENBQU07SUFDdkMsT0FBTyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUM7QUFDdkIsQ0FBQztBQUVELHdGQUF3RjtBQUN4RixNQUFNLFVBQVUsYUFBYSxDQUFDLENBQU07SUFDbEMsSUFBSSxPQUFPLEdBQUcsQ0FBQyxDQUFDO0lBQ2hCLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRTtRQUNaLE9BQU8sSUFBSSxDQUFDLENBQUM7UUFDYixDQUFDLE1BQU0sQ0FBQyxDQUFDO0tBQ1Y7SUFFRCxPQUFPLE9BQU8sQ0FBQztBQUNqQixDQUFDO0FBRUQsK0VBQStFO0FBQy9FLE1BQU0sVUFBVSxhQUFhLENBQzNCLEdBQTRCO0lBRTVCLElBQUksS0FBSyxHQUFHLENBQWdCLENBQUM7SUFDN0IsS0FBSyxNQUFNLElBQUksSUFBSSxHQUFHLENBQUMsTUFBTSxFQUFFLEVBQUU7UUFDL0IsS0FBSyxHQUFHLE9BQU8sQ0FBQyxLQUFLLEVBQUUsSUFBSSxDQUFDLENBQUM7S0FDOUI7SUFFRCxPQUFPLEtBQUssQ0FBQztBQUNmLENBQUMifQ==

package/functions/bombs.js

@@ -0,0 +1,11 @@
+/** Helper function to find out how large a bomb explosion is based on the damage inflicted. */
+export function getBombRadiusFromDamage(damage) {
+    if (damage > 175) {
+        return 105;
+    }
+    if (damage <= 140) {
+        return 75;
+    }
+    return 90;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9tYnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2Z1bmN0aW9ucy9ib21icy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwrRkFBK0Y7QUFDL0YsTUFBTSxVQUFVLHVCQUF1QixDQUFDLE1BQWE7SUFDbkQsSUFBSSxNQUFNLEdBQUcsR0FBRyxFQUFFO1FBQ2hCLE9BQU8sR0FBRyxDQUFDO0tBQ1o7SUFFRCxJQUFJLE1BQU0sSUFBSSxHQUFHLEVBQUU7UUFDakIsT0FBTyxFQUFFLENBQUM7S0FDWDtJQUVELE9BQU8sRUFBRSxDQUFDO0FBQ1osQ0FBQyJ9