isaacscript-common 76.2.0 → 77.0.0

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 76.1.0
+isaacscript-common 76.3.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -16287,81 +16287,6 @@ end
 function ____exports.isUserdata(self, variable)
     return type(variable) == "userdata"
 end
-return ____exports
- end,
-["functions.log"] = function(...) 
-local ____exports = {}
-local ____types = require("functions.types")
-local isNumber = ____types.isNumber
---- Helper function to get the name and the line number of the current calling function.
--- 
--- For this function to work properly, the "--luadebug" flag must be enabled. Otherwise, it will
--- always return undefined.
--- 
--- @param levels Optional. The amount of levels to look backwards in the call stack. Default is 3
--- (because the first level is this function, the second level is the calling
--- function, and the third level is the parent of the calling function).
-function ____exports.getParentFunctionDescription(levels)
-    if levels == nil then
-        levels = 3
-    end
-    if debug ~= nil then
-        local debugTable = debug.getinfo(levels)
-        if debugTable ~= nil then
-            return (tostring(debugTable.name) .. ":") .. tostring(debugTable.linedefined)
-        end
-    end
-    if SandboxGetParentFunctionDescription ~= nil then
-        return SandboxGetParentFunctionDescription(levels)
-    end
-    return nil
-end
---- Helper function to avoid typing out `Isaac.DebugString()`.
--- 
--- If you have the "--luadebug" launch flag turned on, then this function will also prepend the
--- function name and the line number before the string, like this:
--- 
--- ```text
--- [INFO] - Lua Debug: saveToDisk:42494 - The save data manager wrote data to the "save#.dat" file.
--- ```
--- 
--- Subsequently, it is recommended that you turn on the "--luadebug" launch flag when developing
--- your mod so that debugging becomes a little bit easier.
--- 
--- @param msg The message to log.
--- @param includeParentFunction Optional. Whether to prefix the message with the function name and
--- line number, as shown in the above example. Default is true.
-function ____exports.log(msg, includeParentFunction)
-    if includeParentFunction == nil then
-        includeParentFunction = true
-    end
-    if isNumber(nil, msg) then
-        msg = tostring(msg)
-    end
-    local ____includeParentFunction_0
-    if includeParentFunction then
-        ____includeParentFunction_0 = ____exports.getParentFunctionDescription()
-    else
-        ____includeParentFunction_0 = nil
-    end
-    local parentFunctionDescription = ____includeParentFunction_0
-    local debugMsg = parentFunctionDescription == nil and msg or (parentFunctionDescription .. " - ") .. msg
-    Isaac.DebugString(debugMsg)
-end
---- Helper function to log a message to the "log.txt" file and to print it to the screen at the same
--- time.
-function ____exports.logAndPrint(self, msg)
-    ____exports.log(msg)
-    print(msg)
-end
---- Helper function to log an error message and also print it to the console for better visibility.
--- 
--- This is useful in situations where using the `error` function would be dangerous (since it
--- prevents all of the subsequent code in the callback from running).
-function ____exports.logError(msg)
-    local errorMsg = "Error: " .. msg
-    ____exports.logAndPrint(nil, errorMsg)
-end
 return ____exports
  end,
 ["functions.sort"] = function(...) 
@@ -16507,183 +16432,7 @@ function ____exports.stableSort(self, array, sortFunc)
 end
 return ____exports
  end,
-["classes.DefaultMap"] = function(...) 
-local ____lualib = require("lualib_bundle")
-local __TS__Class = ____lualib.__TS__Class
-local Map = ____lualib.Map
-local __TS__ClassExtends = ____lualib.__TS__ClassExtends
-local __TS__TypeOf = ____lualib.__TS__TypeOf
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local ____types = require("functions.types")
-local isFunction = ____types.isFunction
-local isPrimitive = ____types.isPrimitive
---- `DefaultMap` is a data structure that makes working with default values easier. It extends a
--- `Map` and adds additional methods.
--- 
--- It is a common pattern to look up a value in a `Map`, and then, if the value does not exist, set
--- a default value for the key, and then return the default value. `DefaultMap` abstracts this
--- operation away by providing the `getAndSetDefault` method.
--- 
--- Using a `DefaultMap` is nice because it makes code more declarative, since you specify what the
--- default value is alongside the types of the keys/values.
--- 
--- When instantiating a new `DefaultMap`, you must specify default value as the first argument. (The
--- default value is the initial value that will be assigned to every new entry in the
--- `getAndSetDefault` method.) For example:
--- 
--- ```ts
--- // Initializes a new empty DefaultMap with a default value of "foo".
--- const defaultMapWithString = new DefaultMap<string, string>("foo");
--- 
--- const value = defaultMapWithString.getAndSetDefault("bar");
--- // value is now "foo" and an entry for "bar" is now set.
--- ```
--- 
--- Sometimes, instead of having a static initial value for every entry in the map, you will want a
--- dynamic initial value that is contingent upon the key or some other variable. In these cases, you
--- can instead specify that the `DefaultMap` should run a function that will return the initial
--- value. (This is referred to as a "factory function".) For example:
--- 
--- ```ts
--- // Initializes a new empty DefaultMap with a default value based on "someGlobalVariable".
--- const factoryFunction = () => someGlobalVariable ? 0 : 1;
--- const defaultMapWithFactoryFunction = new DefaultMap<string, string>(factoryFunction);
--- ```
--- 
--- Note that in TypeScript and Lua, booleans, numbers, and strings are "passed by value". This means
--- that when the `DefaultMap` creates a new entry, if the default value is one of these 3 types, the
--- values will be copied. On the other hand, arrays and maps and other complex data structures are
--- "passed by reference". This means that when the `DefaultMap` creates a new entry, if the default
--- value is an array, then it would not be copied. Instead, the same shared array would be assigned
--- to every entry. Thus, to solve this problem, any variable that is passed by reference must be
--- created using a factory function to ensure that each copy is unique. For example:
--- 
--- ```ts
--- // Initializes a new empty DefaultMap with a default value of a new empty array.
--- const factoryFunction = () => [];
--- const defaultMapWithArray = new DefaultMap<string, string[]>(factoryFunction);
--- ```
--- 
--- In the previous two examples, the factory functions did not have any arguments. But you can also
--- specify a factory function that takes one or more arguments:
--- 
--- ```ts
--- const factoryFunction = (arg: boolean) => arg ? 0 : 1;
--- const defaultMapWithArg = new DefaultMap<string, string, [arg: boolean]>(factoryFunction);
--- ```
--- 
--- Similar to a normal `Map`, you can also include an initializer list in the constructor as the
--- second argument:
--- 
--- ```ts
--- // Initializes a DefaultMap with a default value of "foo" and some initial values.
--- const defaultMapWithInitialValues = new DefaultMap<string, string>("foo", [
---   ["a1", "a2"],
---   ["b1", "b2"],
--- ], );
--- ```
--- 
--- Finally, note that `DefaultMap` has the following additional utility methods:
--- 
--- - `getAndSetDefault` - The method that is called inside the overridden `get` method. In most
---   cases, you can use the overridden `get` method instead of calling this function directly.
---   However, if a factory function was provided during instantiation, and the factory function has
---   one or more arguments, then you must call this method instead (and provide the corresponding
---   arguments).
--- - `getDefaultValue` - Returns the default value to be used for a new key. (If a factory function
---   was provided during instantiation, this will execute the factory function.)
--- - `getConstructorArg` - Helper method for cloning the map. Returns either the default value or
---   the reference to the factory function.
-____exports.DefaultMap = __TS__Class()
-local DefaultMap = ____exports.DefaultMap
-DefaultMap.name = "DefaultMap"
-__TS__ClassExtends(DefaultMap, Map)
-function DefaultMap.prototype.____constructor(self, defaultValueOrFactoryFunction, initializerArray)
-    local argIsPrimitive = isPrimitive(nil, defaultValueOrFactoryFunction)
-    local argIsFunction = isFunction(nil, defaultValueOrFactoryFunction)
-    if not argIsPrimitive and not argIsFunction then
-        error(("Failed to instantiate a DefaultMap since the provided default value was of type \"" .. __TS__TypeOf(defaultValueOrFactoryFunction)) .. "\". This error usually means that you are trying to use an array (or some other non-primitive data structure that is passed by reference) as the default value. Instead, return the data structure in a factory function, like \"() => []\". See the DefaultMap documentation for more details.")
-    end
-    Map.prototype.____constructor(self, initializerArray)
-    if argIsFunction then
-        self.defaultValue = nil
-        self.defaultValueFactory = defaultValueOrFactoryFunction
-    else
-        self.defaultValue = defaultValueOrFactoryFunction
-        self.defaultValueFactory = nil
-    end
-end
-function DefaultMap.prototype.getAndSetDefault(self, key, ...)
-    local value = Map.prototype.get(self, key)
-    if value ~= nil then
-        return value
-    end
-    local defaultValue = self:getDefaultValue(...)
-    self:set(key, defaultValue)
-    return defaultValue
-end
-function DefaultMap.prototype.getDefaultValue(self, ...)
-    if self.defaultValue ~= nil then
-        return self.defaultValue
-    end
-    if self.defaultValueFactory ~= nil then
-        return self:defaultValueFactory(...)
-    end
-    error("A DefaultMap was incorrectly instantiated.")
-end
-function DefaultMap.prototype.getConstructorArg(self)
-    if self.defaultValue ~= nil then
-        return self.defaultValue
-    end
-    if self.defaultValueFactory ~= nil then
-        return self.defaultValueFactory
-    end
-    error("A DefaultMap was incorrectly instantiated.")
-end
-local function test(self)
-    local myDefaultMapBoolean = __TS__New(____exports.DefaultMap, false)
-    local myDefaultMapBooleanFactory = __TS__New(
-        ____exports.DefaultMap,
-        function() return false end
-    )
-    local myDefaultMapBooleanWithoutParams = __TS__New(____exports.DefaultMap, false)
-    local myDefaultMapNumber = __TS__New(____exports.DefaultMap, 123)
-    local myDefaultMapNumberFactory = __TS__New(
-        ____exports.DefaultMap,
-        function() return 123 end
-    )
-    local myDefaultMapNumberWithoutParams = __TS__New(____exports.DefaultMap, 123)
-    local myDefaultMapString = __TS__New(____exports.DefaultMap, "foo")
-    local myDefaultMapStringFactory = __TS__New(
-        ____exports.DefaultMap,
-        function() return "foo" end
-    )
-    local myDefaultMapStringWithoutParams = __TS__New(____exports.DefaultMap, "foo")
-    local myDefaultMapArray = __TS__New(
-        ____exports.DefaultMap,
-        function() return {} end
-    )
-    local myDefaultMapArrayWithoutParams = __TS__New(
-        ____exports.DefaultMap,
-        function() return {} end
-    )
-    local myDefaultMapMap = __TS__New(
-        ____exports.DefaultMap,
-        function() return __TS__New(Map) end
-    )
-    local myDefaultMapMapWithoutParams = __TS__New(
-        ____exports.DefaultMap,
-        function() return __TS__New(Map) end
-    )
-end
-return ____exports
- end,
-["interfaces.TSTLClassMetatable"] = function(...) 
-local ____exports = {}
-return ____exports
- end,
-["types.TSTLClass"] = function(...) 
+["types.WidenLiteral"] = function(...) 
 local ____exports = {}
 return ____exports
  end,
@@ -16737,6 +16486,24 @@ ____exports.fonts.teamMeatFont12:Load("font/teammeatfont12.fnt")
 ____exports.fonts.teamMeatFont16Bold:Load("font/teammeatfont16bold.fnt")
 ____exports.fonts.terminus:Load("font/terminus.fnt")
 ____exports.fonts.upheaval:Load("font/upheaval.fnt")
+return ____exports
+ end,
+["enums.private.SerializationBrand"] = function(...) 
+local ____exports = {}
+--- During serialization, we write an arbitrary string key to the object with a value of an empty
+-- string. This is used during deserialization to instantiate the correct type of object.
+____exports.SerializationBrand = {}
+____exports.SerializationBrand.DEFAULT_MAP = "__TSTL_DEFAULT_MAP"
+____exports.SerializationBrand.MAP = "__TSTL_MAP"
+____exports.SerializationBrand.SET = "__TSTL_SET"
+____exports.SerializationBrand.BIT_SET_128 = "__BIT_SET_128"
+____exports.SerializationBrand.COLOR = "__COLOR"
+____exports.SerializationBrand.K_COLOR = "__K_COLOR"
+____exports.SerializationBrand.RNG = "__RNG"
+____exports.SerializationBrand.VECTOR = "__VECTOR"
+____exports.SerializationBrand.DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE"
+____exports.SerializationBrand.OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
+____exports.SerializationBrand.TSTL_CLASS = "__TSTL_CLASS"
 return ____exports
  end,
 ["types.PlayerIndex"] = function(...) 
@@ -17129,108 +16896,6 @@ end
 -- @allowEmptyVariadic
 function ____exports.todo(self, ...)
 end
-return ____exports
- end,
-["functions.tstlClass"] = function(...) 
-local ____exports = {}
-local ____types = require("functions.types")
-local isTable = ____types.isTable
-local ____utils = require("functions.utils")
-local assertDefined = ____utils.assertDefined
---- Helper function to get the constructor from an instantiated TypeScriptToLua class, which is
--- located on the metatable.
--- 
--- Returns undefined if passed a non-table or if the provided table does not have a metatable.
-function ____exports.getTSTLClassConstructor(self, object)
-    if not isTable(nil, object) then
-        return nil
-    end
-    local metatable = getmetatable(object)
-    if metatable == nil then
-        return nil
-    end
-    return metatable.constructor
-end
---- Helper function to get the name of a TypeScriptToLua class from the instantiated class object.
--- 
--- TSTL classes are Lua tables created with the `__TS__Class` Lua function from the TSTL lualib.
--- Their name is contained within "constructor.name" metatable key.
--- 
--- For example, a `Map` class is has a name of "Map".
--- 
--- Returns undefined if passed a non-table or if the provided table does not have a metatable.
-function ____exports.getTSTLClassName(self, object)
-    local constructor = ____exports.getTSTLClassConstructor(nil, object)
-    if constructor == nil then
-        return nil
-    end
-    return constructor.name
-end
---- Helper function to determine if a given object is a TypeScriptToLua `Map`.
--- 
--- It is not reliable to use the `instanceof` operator to determine this because each Lua module has
--- their own copies of the entire lualib and thus their own instantiated version of a `Map`.
-function ____exports.isDefaultMap(self, object)
-    local className = ____exports.getTSTLClassName(nil, object)
-    return className == "DefaultMap"
-end
---- Helper function to check if a given table is a class table created by TypeScriptToLua.
-function ____exports.isTSTLClass(self, object)
-    local tstlClassName = ____exports.getTSTLClassName(nil, object)
-    return tstlClassName ~= nil
-end
---- Helper function to determine if a given object is a TypeScriptToLua `Map`.
--- 
--- It is not reliable to use the `instanceof` operator to determine this because each Lua module
--- might have their own copy of the entire lualib and thus their own instantiated version of a
--- `Map`.
-function ____exports.isTSTLMap(self, object)
-    local className = ____exports.getTSTLClassName(nil, object)
-    return className == "Map"
-end
---- Helper function to determine if a given object is a TypeScriptToLua `Set`.
--- 
--- It is not reliable to use the `instanceof` operator to determine this because each Lua module
--- might have their own copy of the entire lualib and thus their own instantiated version of a
--- `Set`.
-function ____exports.isTSTLSet(self, object)
-    local className = ____exports.getTSTLClassName(nil, object)
-    return className == "Set"
-end
---- Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
--- it is. This function requires that you provide an instantiated class of the same type, as it will
--- use the class constructor that is present on the other object's metatable to initialize the new
--- class.
-function ____exports.newTSTLClass(self, oldClass)
-    local constructor = ____exports.getTSTLClassConstructor(nil, oldClass)
-    assertDefined(nil, constructor, "Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable/constructor.")
-    local newClass = {}
-    local newClassMetatable = setmetatable(newClass, constructor.prototype)
-    newClassMetatable:____constructor()
-    return newClass
-end
-return ____exports
- end,
-["types.WidenLiteral"] = function(...) 
-local ____exports = {}
-return ____exports
- end,
-["enums.private.SerializationBrand"] = function(...) 
-local ____exports = {}
---- During serialization, we write an arbitrary string key to the object with a value of an empty
--- string. This is used during deserialization to instantiate the correct type of object.
-____exports.SerializationBrand = {}
-____exports.SerializationBrand.DEFAULT_MAP = "__TSTL_DEFAULT_MAP"
-____exports.SerializationBrand.MAP = "__TSTL_MAP"
-____exports.SerializationBrand.SET = "__TSTL_SET"
-____exports.SerializationBrand.BIT_SET_128 = "__BIT_SET_128"
-____exports.SerializationBrand.COLOR = "__COLOR"
-____exports.SerializationBrand.K_COLOR = "__K_COLOR"
-____exports.SerializationBrand.RNG = "__RNG"
-____exports.SerializationBrand.VECTOR = "__VECTOR"
-____exports.SerializationBrand.DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE"
-____exports.SerializationBrand.OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
-____exports.SerializationBrand.TSTL_CLASS = "__TSTL_CLASS"
 return ____exports
  end,
 ["functions.string"] = function(...) 
@@ -17539,6 +17204,81 @@ function ____exports.isaacAPIClassEquals(self, object1, object2, keys)
         function(____, key) return table1[key] == table2[key] end
     )
 end
+return ____exports
+ end,
+["functions.log"] = function(...) 
+local ____exports = {}
+local ____types = require("functions.types")
+local isNumber = ____types.isNumber
+--- Helper function to get the name and the line number of the current calling function.
+-- 
+-- For this function to work properly, the "--luadebug" flag must be enabled. Otherwise, it will
+-- always return undefined.
+-- 
+-- @param levels Optional. The amount of levels to look backwards in the call stack. Default is 3
+-- (because the first level is this function, the second level is the calling
+-- function, and the third level is the parent of the calling function).
+function ____exports.getParentFunctionDescription(levels)
+    if levels == nil then
+        levels = 3
+    end
+    if debug ~= nil then
+        local debugTable = debug.getinfo(levels)
+        if debugTable ~= nil then
+            return (tostring(debugTable.name) .. ":") .. tostring(debugTable.linedefined)
+        end
+    end
+    if SandboxGetParentFunctionDescription ~= nil then
+        return SandboxGetParentFunctionDescription(levels)
+    end
+    return nil
+end
+--- Helper function to avoid typing out `Isaac.DebugString()`.
+-- 
+-- If you have the "--luadebug" launch flag turned on, then this function will also prepend the
+-- function name and the line number before the string, like this:
+-- 
+-- ```text
+-- [INFO] - Lua Debug: saveToDisk:42494 - The save data manager wrote data to the "save#.dat" file.
+-- ```
+-- 
+-- Subsequently, it is recommended that you turn on the "--luadebug" launch flag when developing
+-- your mod so that debugging becomes a little bit easier.
+-- 
+-- @param msg The message to log.
+-- @param includeParentFunction Optional. Whether to prefix the message with the function name and
+-- line number, as shown in the above example. Default is true.
+function ____exports.log(msg, includeParentFunction)
+    if includeParentFunction == nil then
+        includeParentFunction = true
+    end
+    if isNumber(nil, msg) then
+        msg = tostring(msg)
+    end
+    local ____includeParentFunction_0
+    if includeParentFunction then
+        ____includeParentFunction_0 = ____exports.getParentFunctionDescription()
+    else
+        ____includeParentFunction_0 = nil
+    end
+    local parentFunctionDescription = ____includeParentFunction_0
+    local debugMsg = parentFunctionDescription == nil and msg or (parentFunctionDescription .. " - ") .. msg
+    Isaac.DebugString(debugMsg)
+end
+--- Helper function to log a message to the "log.txt" file and to print it to the screen at the same
+-- time.
+function ____exports.logAndPrint(self, msg)
+    ____exports.log(msg)
+    print(msg)
+end
+--- Helper function to log an error message and also print it to the console for better visibility.
+-- 
+-- This is useful in situations where using the `error` function would be dangerous (since it
+-- prevents all of the subsequent code in the callback from running).
+function ____exports.logError(msg)
+    local errorMsg = "Error: " .. msg
+    ____exports.logAndPrint(nil, errorMsg)
+end
 return ____exports
  end,
 ["functions.table"] = function(...) 
@@ -17924,10 +17664,10 @@ return ____exports
 ["functions.array"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local __TS__New = ____lualib.__TS__New
 local __TS__ArrayIndexOf = ____lualib.__TS__ArrayIndexOf
 local __TS__ArraySplice = ____lualib.__TS__ArraySplice
 local __TS__ArrayPushArray = ____lualib.__TS__ArrayPushArray
-local __TS__New = ____lualib.__TS__New
 local __TS__ArrayEntries = ____lualib.__TS__ArrayEntries
 local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
@@ -17983,28 +17723,6 @@ function ____exports.arrayRemoveAllInPlace(self, array, ...)
     end
     return removedOneOrMoreElements
 end
---- 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 The removed elements. This will be an empty array if no elements were removed.
-function ____exports.arrayRemoveInPlace(self, array, ...)
-    local elementsToRemove = {...}
-    local removedElements = {}
-    for ____, element in ipairs(elementsToRemove) do
-        local index = __TS__ArrayIndexOf(array, element)
-        if index > -1 then
-            local removedElement = __TS__ArraySplice(array, index, 1)
-            __TS__ArrayPushArray(removedElements, removedElement)
-        end
-    end
-    return removedElements
-end
 --- Helper function to perform a shallow copy.
 -- 
 -- @param oldArray The array to copy.
@@ -18115,9 +17833,9 @@ function ____exports.arrayEquals(self, array1, array2)
         end
     )
 end
---- 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.
+--- Builds a new array based on the original array without the specified element(s). Returns the new
+-- 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.
 -- 
@@ -18125,8 +17843,14 @@ end
 -- matching element. If you want to remove all of the elements, use the `arrayRemoveAll` function
 -- instead.
 function ____exports.arrayRemove(self, originalArray, ...)
-    local array = ____exports.copyArray(nil, originalArray)
-    ____exports.arrayRemoveInPlace(nil, array, ...)
+    local elementsToRemove = {...}
+    local elementsToRemoveSet = __TS__New(ReadonlySet, elementsToRemove)
+    local array = {}
+    for ____, element in ipairs(originalArray) do
+        if not elementsToRemoveSet:has(element) then
+            array[#array + 1] = element
+        end
+    end
     return array
 end
 --- Shallow copies and removes the specified element(s) from the array. Returns the copied array. If
@@ -18143,6 +17867,28 @@ function ____exports.arrayRemoveAll(self, originalArray, ...)
     ____exports.arrayRemoveAllInPlace(nil, array, ...)
     return array
 end
+--- 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 The removed elements. This will be an empty array if no elements were removed.
+function ____exports.arrayRemoveInPlace(self, array, ...)
+    local elementsToRemove = {...}
+    local removedElements = {}
+    for ____, element in ipairs(elementsToRemove) do
+        local index = __TS__ArrayIndexOf(array, element)
+        if index > -1 then
+            local removedElement = __TS__ArraySplice(array, index, 1)
+            __TS__ArrayPushArray(removedElements, removedElement)
+        end
+    end
+    return removedElements
+end
 --- 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.
@@ -20126,16 +19872,10 @@ local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local __TS__ArrayFindIndex = ____lualib.__TS__ArrayFindIndex
 local __TS__ArraySplice = ____lualib.__TS__ArraySplice
-local __TS__ArrayEntries = ____lualib.__TS__ArrayEntries
-local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local ____log = require("functions.log")
-local log = ____log.log
 local ____sort = require("functions.sort")
 local sortObjectArrayByKey = ____sort.sortObjectArrayByKey
 local stableSort = ____sort.stableSort
-local ____tstlClass = require("functions.tstlClass")
-local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____Feature = require("classes.private.Feature")
 local Feature = ____Feature.Feature
 --- The base class for a custom callback. Individual custom callbacks (and validation callbacks) will
@@ -20195,19 +19935,6 @@ function CustomCallback.prototype.removeSubscriber(self, callback)
         __TS__ArraySplice(self.subscriptions, subscriptionIndexMatchingCallback, 1)
     end
 end
-function CustomCallback.prototype.logSubscriptions(self)
-    local tstlClassName = getTSTLClassName(nil, self)
-    log("Logging subscriptions for custom callback: " .. tostring(tstlClassName))
-    if #self.subscriptions == 0 then
-        log("- n/a (no subscriptions)")
-    else
-        for ____, ____value in __TS__Iterator(__TS__ArrayEntries(self.subscriptions)) do
-            local i = ____value[1]
-            local subscription = ____value[2]
-            log((("- " .. tostring(i + 1)) .. " - priority: ") .. tostring(subscription.priority))
-        end
-    end
-end
 return ____exports
  end,
 ["classes.callbacks.EntityTakeDmgFilter"] = function(...) 
@@ -20806,6 +20533,178 @@ function ____exports.onRoomFrame(self, roomFrameCount)
     local thisGameFrameCount = room:GetFrameCount()
     return thisGameFrameCount == roomFrameCount
 end
+return ____exports
+ end,
+["classes.DefaultMap"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local Map = ____lualib.Map
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__TypeOf = ____lualib.__TS__TypeOf
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____types = require("functions.types")
+local isFunction = ____types.isFunction
+local isPrimitive = ____types.isPrimitive
+--- `DefaultMap` is a data structure that makes working with default values easier. It extends a
+-- `Map` and adds additional methods.
+-- 
+-- It is a common pattern to look up a value in a `Map`, and then, if the value does not exist, set
+-- a default value for the key, and then return the default value. `DefaultMap` abstracts this
+-- operation away by providing the `getAndSetDefault` method.
+-- 
+-- Using a `DefaultMap` is nice because it makes code more declarative, since you specify what the
+-- default value is alongside the types of the keys/values.
+-- 
+-- When instantiating a new `DefaultMap`, you must specify default value as the first argument. (The
+-- default value is the initial value that will be assigned to every new entry in the
+-- `getAndSetDefault` method.) For example:
+-- 
+-- ```ts
+-- // Initializes a new empty DefaultMap with a default value of "foo".
+-- const defaultMapWithString = new DefaultMap<string, string>("foo");
+-- 
+-- const value = defaultMapWithString.getAndSetDefault("bar");
+-- // value is now "foo" and an entry for "bar" is now set.
+-- ```
+-- 
+-- Sometimes, instead of having a static initial value for every entry in the map, you will want a
+-- dynamic initial value that is contingent upon the key or some other variable. In these cases, you
+-- can instead specify that the `DefaultMap` should run a function that will return the initial
+-- value. (This is referred to as a "factory function".) For example:
+-- 
+-- ```ts
+-- // Initializes a new empty DefaultMap with a default value based on "someGlobalVariable".
+-- const factoryFunction = () => someGlobalVariable ? 0 : 1;
+-- const defaultMapWithFactoryFunction = new DefaultMap<string, string>(factoryFunction);
+-- ```
+-- 
+-- Note that in TypeScript and Lua, booleans, numbers, and strings are "passed by value". This means
+-- that when the `DefaultMap` creates a new entry, if the default value is one of these 3 types, the
+-- values will be copied. On the other hand, arrays and maps and other complex data structures are
+-- "passed by reference". This means that when the `DefaultMap` creates a new entry, if the default
+-- value is an array, then it would not be copied. Instead, the same shared array would be assigned
+-- to every entry. Thus, to solve this problem, any variable that is passed by reference must be
+-- created using a factory function to ensure that each copy is unique. For example:
+-- 
+-- ```ts
+-- // Initializes a new empty DefaultMap with a default value of a new empty array.
+-- const factoryFunction = () => [];
+-- const defaultMapWithArray = new DefaultMap<string, string[]>(factoryFunction);
+-- ```
+-- 
+-- In the previous two examples, the factory functions did not have any arguments. But you can also
+-- specify a factory function that takes one or more arguments:
+-- 
+-- ```ts
+-- const factoryFunction = (arg: boolean) => arg ? 0 : 1;
+-- const defaultMapWithArg = new DefaultMap<string, string, [arg: boolean]>(factoryFunction);
+-- ```
+-- 
+-- Similar to a normal `Map`, you can also include an initializer list in the constructor as the
+-- second argument:
+-- 
+-- ```ts
+-- // Initializes a DefaultMap with a default value of "foo" and some initial values.
+-- const defaultMapWithInitialValues = new DefaultMap<string, string>("foo", [
+--   ["a1", "a2"],
+--   ["b1", "b2"],
+-- ], );
+-- ```
+-- 
+-- Finally, note that `DefaultMap` has the following additional utility methods:
+-- 
+-- - `getAndSetDefault` - The method that is called inside the overridden `get` method. In most
+--   cases, you can use the overridden `get` method instead of calling this function directly.
+--   However, if a factory function was provided during instantiation, and the factory function has
+--   one or more arguments, then you must call this method instead (and provide the corresponding
+--   arguments).
+-- - `getDefaultValue` - Returns the default value to be used for a new key. (If a factory function
+--   was provided during instantiation, this will execute the factory function.)
+-- - `getConstructorArg` - Helper method for cloning the map. Returns either the default value or
+--   the reference to the factory function.
+____exports.DefaultMap = __TS__Class()
+local DefaultMap = ____exports.DefaultMap
+DefaultMap.name = "DefaultMap"
+__TS__ClassExtends(DefaultMap, Map)
+function DefaultMap.prototype.____constructor(self, defaultValueOrFactoryFunction, initializerArray)
+    local argIsPrimitive = isPrimitive(nil, defaultValueOrFactoryFunction)
+    local argIsFunction = isFunction(nil, defaultValueOrFactoryFunction)
+    if not argIsPrimitive and not argIsFunction then
+        error(("Failed to instantiate a DefaultMap since the provided default value was of type \"" .. __TS__TypeOf(defaultValueOrFactoryFunction)) .. "\". This error usually means that you are trying to use an array (or some other non-primitive data structure that is passed by reference) as the default value. Instead, return the data structure in a factory function, like \"() => []\". See the DefaultMap documentation for more details.")
+    end
+    Map.prototype.____constructor(self, initializerArray)
+    if argIsFunction then
+        self.defaultValue = nil
+        self.defaultValueFactory = defaultValueOrFactoryFunction
+    else
+        self.defaultValue = defaultValueOrFactoryFunction
+        self.defaultValueFactory = nil
+    end
+end
+function DefaultMap.prototype.getAndSetDefault(self, key, ...)
+    local value = Map.prototype.get(self, key)
+    if value ~= nil then
+        return value
+    end
+    local defaultValue = self:getDefaultValue(...)
+    self:set(key, defaultValue)
+    return defaultValue
+end
+function DefaultMap.prototype.getDefaultValue(self, ...)
+    if self.defaultValue ~= nil then
+        return self.defaultValue
+    end
+    if self.defaultValueFactory ~= nil then
+        return self:defaultValueFactory(...)
+    end
+    error("A DefaultMap was incorrectly instantiated.")
+end
+function DefaultMap.prototype.getConstructorArg(self)
+    if self.defaultValue ~= nil then
+        return self.defaultValue
+    end
+    if self.defaultValueFactory ~= nil then
+        return self.defaultValueFactory
+    end
+    error("A DefaultMap was incorrectly instantiated.")
+end
+local function test(self)
+    local myDefaultMapBoolean = __TS__New(____exports.DefaultMap, false)
+    local myDefaultMapBooleanFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return false end
+    )
+    local myDefaultMapBooleanWithoutParams = __TS__New(____exports.DefaultMap, false)
+    local myDefaultMapNumber = __TS__New(____exports.DefaultMap, 123)
+    local myDefaultMapNumberFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return 123 end
+    )
+    local myDefaultMapNumberWithoutParams = __TS__New(____exports.DefaultMap, 123)
+    local myDefaultMapString = __TS__New(____exports.DefaultMap, "foo")
+    local myDefaultMapStringFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return "foo" end
+    )
+    local myDefaultMapStringWithoutParams = __TS__New(____exports.DefaultMap, "foo")
+    local myDefaultMapArray = __TS__New(
+        ____exports.DefaultMap,
+        function() return {} end
+    )
+    local myDefaultMapArrayWithoutParams = __TS__New(
+        ____exports.DefaultMap,
+        function() return {} end
+    )
+    local myDefaultMapMap = __TS__New(
+        ____exports.DefaultMap,
+        function() return __TS__New(Map) end
+    )
+    local myDefaultMapMapWithoutParams = __TS__New(
+        ____exports.DefaultMap,
+        function() return __TS__New(Map) end
+    )
+end
 return ____exports
  end,
 ["functions.playerDataStructures"] = function(...) 
@@ -21448,6 +21347,7 @@ local __TS__ArrayAt = ____lualib.__TS__ArrayAt
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
+local isTaintedModded
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
@@ -21489,6 +21389,12 @@ function ____exports.isVanillaPlayer(self, player)
     local character = player:GetPlayerType()
     return isVanillaCharacter(nil, character)
 end
+function isTaintedModded(self, player)
+    local character = player:GetPlayerType()
+    local name = player:GetName()
+    local taintedCharacter = Isaac.GetPlayerTypeByName(name, true)
+    return character == taintedCharacter
+end
 --- Helper function to check to see if any player is holding up an item (from e.g. an active item
 -- activation, a poop from IBS, etc.).
 function ____exports.anyPlayerHoldingItem(self)
@@ -21761,13 +21667,6 @@ function ____exports.isDamageFromPlayer(self, damageSource)
     local indirectPlayer = ____exports.getPlayerFromEntity(nil, damageSource)
     return indirectPlayer ~= nil
 end
---- Not exported since end-users should use the `isTainted` helper function directly.
-local function isTaintedModded(self, player)
-    local character = player:GetPlayerType()
-    local name = player:GetName()
-    local taintedCharacter = Isaac.GetPlayerTypeByName(name, true)
-    return character == taintedCharacter
-end
 --- Helper function for detecting when a player is Eden or Tainted Eden. Useful for situations where
 -- you want to know if the starting stats were randomized, for example.
 function ____exports.isEden(self, player)
@@ -22559,6 +22458,94 @@ function ____exports.setToBitFlags(self, set)
     end
     return flags
 end
+return ____exports
+ end,
+["interfaces.TSTLClassMetatable"] = function(...) 
+local ____exports = {}
+return ____exports
+ end,
+["types.TSTLClass"] = function(...) 
+local ____exports = {}
+return ____exports
+ end,
+["functions.tstlClass"] = function(...) 
+local ____exports = {}
+local ____types = require("functions.types")
+local isTable = ____types.isTable
+local ____utils = require("functions.utils")
+local assertDefined = ____utils.assertDefined
+--- Helper function to get the constructor from an instantiated TypeScriptToLua class, which is
+-- located on the metatable.
+-- 
+-- Returns undefined if passed a non-table or if the provided table does not have a metatable.
+function ____exports.getTSTLClassConstructor(self, object)
+    if not isTable(nil, object) then
+        return nil
+    end
+    local metatable = getmetatable(object)
+    if metatable == nil then
+        return nil
+    end
+    return metatable.constructor
+end
+--- Helper function to get the name of a TypeScriptToLua class from the instantiated class object.
+-- 
+-- TSTL classes are Lua tables created with the `__TS__Class` Lua function from the TSTL lualib.
+-- Their name is contained within "constructor.name" metatable key.
+-- 
+-- For example, a `Map` class is has a name of "Map".
+-- 
+-- Returns undefined if passed a non-table or if the provided table does not have a metatable.
+function ____exports.getTSTLClassName(self, object)
+    local constructor = ____exports.getTSTLClassConstructor(nil, object)
+    if constructor == nil then
+        return nil
+    end
+    return constructor.name
+end
+--- Helper function to determine if a given object is a TypeScriptToLua `Map`.
+-- 
+-- It is not reliable to use the `instanceof` operator to determine this because each Lua module has
+-- their own copies of the entire lualib and thus their own instantiated version of a `Map`.
+function ____exports.isDefaultMap(self, object)
+    local className = ____exports.getTSTLClassName(nil, object)
+    return className == "DefaultMap"
+end
+--- Helper function to check if a given table is a class table created by TypeScriptToLua.
+function ____exports.isTSTLClass(self, object)
+    local tstlClassName = ____exports.getTSTLClassName(nil, object)
+    return tstlClassName ~= nil
+end
+--- Helper function to determine if a given object is a TypeScriptToLua `Map`.
+-- 
+-- It is not reliable to use the `instanceof` operator to determine this because each Lua module
+-- might have their own copy of the entire lualib and thus their own instantiated version of a
+-- `Map`.
+function ____exports.isTSTLMap(self, object)
+    local className = ____exports.getTSTLClassName(nil, object)
+    return className == "Map"
+end
+--- Helper function to determine if a given object is a TypeScriptToLua `Set`.
+-- 
+-- It is not reliable to use the `instanceof` operator to determine this because each Lua module
+-- might have their own copy of the entire lualib and thus their own instantiated version of a
+-- `Set`.
+function ____exports.isTSTLSet(self, object)
+    local className = ____exports.getTSTLClassName(nil, object)
+    return className == "Set"
+end
+--- Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
+-- it is. This function requires that you provide an instantiated class of the same type, as it will
+-- use the class constructor that is present on the other object's metatable to initialize the new
+-- class.
+function ____exports.newTSTLClass(self, oldClass)
+    local constructor = ____exports.getTSTLClassConstructor(nil, oldClass)
+    assertDefined(nil, constructor, "Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable/constructor.")
+    local newClass = {}
+    local newClassMetatable = setmetatable(newClass, constructor.prototype)
+    newClassMetatable:____constructor()
+    return newClass
+end
 return ____exports
  end,
 ["functions.doors"] = function(...) 
@@ -26474,7 +26461,6 @@ return ____exports
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
-local Set = ____lualib.Set
 local ____exports = {}
 local getCollectibleTypeFromArg
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
@@ -26614,14 +26600,14 @@ local GLITCHED_ITEM_THRESHOLD = 4000000000
 local QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP = (function()
     local qualityToCollectibleTypesMap = __TS__New(Map)
     for ____, quality in ipairs(QUALITIES) do
-        local collectibleTypesSet = __TS__New(Set)
+        local collectibleTypes = {}
         for ____, collectibleType in ipairs(VANILLA_COLLECTIBLE_TYPES) do
             local collectibleTypeQuality = ____exports.getCollectibleQuality(nil, collectibleType)
             if collectibleTypeQuality == quality then
-                collectibleTypesSet:add(collectibleType)
+                collectibleTypes[#collectibleTypes + 1] = collectibleType
             end
         end
-        qualityToCollectibleTypesMap:set(quality, collectibleTypesSet)
+        qualityToCollectibleTypesMap:set(quality, collectibleTypes)
     end
     return qualityToCollectibleTypesMap
 end)(nil)
@@ -26812,7 +26798,7 @@ function ____exports.getCollectibleTags(self, collectibleOrCollectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     return itemConfigItem == nil and ItemConfigTagZero or itemConfigItem.Tags
 end
---- Returns a set containing every vanilla collectible type with the given quality.
+--- Returns an array containing every vanilla collectible type with the given quality.
 -- 
 -- Note that this function will only return vanilla collectible types. To handle modded collectible
 -- types, use the `getCollectibleTypesOfQuality` helper function instead.
@@ -43158,7 +43144,7 @@ ____exports.CARD_NAMES = {
 }
 return ____exports
  end,
-["sets.itemConfigCardTypesForCardsSet"] = function(...) 
+["sets.itemConfigCardTypesForCards"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
@@ -43167,7 +43153,7 @@ local ItemConfigCardType = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigCardTy
 local ____ReadonlySet = require("types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
 --- The set of all `ItemConfigCardType` values that are not a rune or special object.
-____exports.ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET = __TS__New(ReadonlySet, {ItemConfigCardType.TAROT, ItemConfigCardType.SUIT, ItemConfigCardType.SPECIAL, ItemConfigCardType.TAROT_REVERSE})
+____exports.ITEM_CONFIG_CARD_TYPES_FOR_CARDS = __TS__New(ReadonlySet, {ItemConfigCardType.TAROT, ItemConfigCardType.SUIT, ItemConfigCardType.SPECIAL, ItemConfigCardType.TAROT_REVERSE})
 return ____exports
  end,
 ["functions.cards"] = function(...) 
@@ -43191,8 +43177,8 @@ local DEFAULT_CARD_DESCRIPTION = ____cardDescriptions.DEFAULT_CARD_DESCRIPTION
 local ____cardNames = require("objects.cardNames")
 local CARD_NAMES = ____cardNames.CARD_NAMES
 local DEFAULT_CARD_NAME = ____cardNames.DEFAULT_CARD_NAME
-local ____itemConfigCardTypesForCardsSet = require("sets.itemConfigCardTypesForCardsSet")
-local ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET = ____itemConfigCardTypesForCardsSet.ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET
+local ____itemConfigCardTypesForCards = require("sets.itemConfigCardTypesForCards")
+local ITEM_CONFIG_CARD_TYPES_FOR_CARDS = ____itemConfigCardTypesForCards.ITEM_CONFIG_CARD_TYPES_FOR_CARDS
 local ____flag = require("functions.flag")
 local addFlag = ____flag.addFlag
 function ____exports.isVanillaCardType(self, cardType)
@@ -43270,7 +43256,7 @@ function ____exports.isCard(self, cardType)
     if itemConfigCardType == nil then
         return false
     end
-    return ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET:has(itemConfigCardType)
+    return ITEM_CONFIG_CARD_TYPES_FOR_CARDS:has(itemConfigCardType)
 end
 --- Returns whether the given card type matches the specified item config card type.
 function ____exports.isCardType(self, cardType, itemConfigCardType)
@@ -43680,7 +43666,6 @@ local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local Set = ____lualib.Set
 local Map = ____lualib.Map
-local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
@@ -43709,6 +43694,9 @@ local ____decorators = require("decorators")
 local Exported = ____decorators.Exported
 local ____ISCFeature = require("enums.ISCFeature")
 local ISCFeature = ____ISCFeature.ISCFeature
+local ____array = require("functions.array")
+local arrayRemove = ____array.arrayRemove
+local getRandomArrayElement = ____array.getRandomArrayElement
 local ____cards = require("functions.cards")
 local getItemConfigCardType = ____cards.getItemConfigCardType
 local ____collectibleTag = require("functions.collectibleTag")
@@ -43722,10 +43710,7 @@ local isPassiveOrFamiliarCollectible = ____collectibles.isPassiveOrFamiliarColle
 local ____flag = require("functions.flag")
 local getFlagName = ____flag.getFlagName
 local ____set = require("functions.set")
-local copySet = ____set.copySet
-local deleteSetsFromSet = ____set.deleteSetsFromSet
 local getRandomSetElement = ____set.getRandomSetElement
-local getSortedSetValues = ____set.getSortedSetValues
 local ____trinkets = require("functions.trinkets")
 local trinketHasCacheFlag = ____trinkets.trinketHasCacheFlag
 local ____types = require("functions.types")
@@ -43737,12 +43722,10 @@ local ____utils = require("functions.utils")
 local assertDefined = ____utils.assertDefined
 local iRange = ____utils.iRange
 local ____repeat = ____utils["repeat"]
-local ____itemConfigCardTypesForCardsSet = require("sets.itemConfigCardTypesForCardsSet")
-local ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET = ____itemConfigCardTypesForCardsSet.ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET
+local ____itemConfigCardTypesForCards = require("sets.itemConfigCardTypesForCards")
+local ITEM_CONFIG_CARD_TYPES_FOR_CARDS = ____itemConfigCardTypesForCards.ITEM_CONFIG_CARD_TYPES_FOR_CARDS
 local ____ReadonlyMap = require("types.ReadonlyMap")
 local ReadonlyMap = ____ReadonlyMap.ReadonlyMap
-local ____ReadonlySet = require("types.ReadonlySet")
-local ReadonlySet = ____ReadonlySet.ReadonlySet
 local ____Feature = require("classes.private.Feature")
 local Feature = ____Feature.Feature
 local CONDITIONAL_FLYING_COLLECTIBLE_TYPES = {CollectibleType.BIBLE, CollectibleType.EMPTY_VESSEL, CollectibleType.ASTRAL_PROJECTION, CollectibleType.RECALL}
@@ -43791,15 +43774,15 @@ function ModdedElementSets.prototype.____constructor(self, moddedElementDetectio
     self.moddedPillEffectsSet = __TS__New(Set)
     self.cacheFlagToCollectibleTypesMap = __TS__New(Map)
     self.cacheFlagToTrinketTypesMap = __TS__New(Map)
-    self.flyingCollectibleTypesSet = __TS__New(Set)
-    self.permanentFlyingCollectibleTypesSet = __TS__New(Set)
-    self.flyingTrinketTypesSet = __TS__New(Set)
+    self.flyingCollectibleTypes = {}
+    self.permanentFlyingCollectibleTypes = {}
+    self.flyingTrinketTypes = {}
     self.tagToCollectibleTypesMap = __TS__New(Map)
     self.edenActiveCollectibleTypesSet = __TS__New(Set)
     self.edenPassiveCollectibleTypesSet = __TS__New(Set)
     self.qualityToCollectibleTypesMap = __TS__New(Map)
     self.itemConfigCardTypeToCardTypeMap = __TS__New(Map)
-    self.cardSet = __TS__New(Set)
+    self.cardTypeCardArray = {}
     self.featuresUsed = {ISCFeature.MODDED_ELEMENT_DETECTION}
     self.moddedElementDetection = moddedElementDetection
 end
@@ -43923,10 +43906,7 @@ function ModdedElementSets.prototype.lazyInitModdedPillEffects(self)
 end
 function ModdedElementSets.prototype.lazyInitTagToCollectibleTypesMap(self)
     for ____, itemConfigTag in ipairs(ITEM_CONFIG_TAG_VALUES) do
-        self.tagToCollectibleTypesMap:set(
-            itemConfigTag,
-            __TS__New(Set)
-        )
+        self.tagToCollectibleTypesMap:set(itemConfigTag, {})
     end
     for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
         for ____, itemConfigTag in ipairs(ITEM_CONFIG_TAG_VALUES) do
@@ -43934,12 +43914,12 @@ function ModdedElementSets.prototype.lazyInitTagToCollectibleTypesMap(self)
                 if not collectibleHasTag(nil, collectibleType, itemConfigTag) then
                     goto __continue37
                 end
-                local collectibleTypesSet = self.tagToCollectibleTypesMap:get(itemConfigTag)
-                if collectibleTypesSet == nil then
+                local collectibleTypes = self.tagToCollectibleTypesMap:get(itemConfigTag)
+                if collectibleTypes == nil then
                     local flagName = getFlagName(nil, itemConfigTag, ItemConfigTag)
                     error("Failed to get the collectible types for item tag: " .. tostring(flagName))
                 end
-                collectibleTypesSet:add(collectibleType)
+                collectibleTypes[#collectibleTypes + 1] = collectibleType
             end
             ::__continue37::
         end
@@ -43947,58 +43927,55 @@ function ModdedElementSets.prototype.lazyInitTagToCollectibleTypesMap(self)
 end
 function ModdedElementSets.prototype.lazyInitCacheFlagToCollectibleTypesMap(self)
     for ____, cacheFlag in ipairs(CACHE_FLAG_VALUES) do
-        local collectibleTypeSet = __TS__New(Set)
+        local collectibleTypes = {}
         for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
             if collectibleHasCacheFlag(nil, collectibleType, cacheFlag) then
-                collectibleTypeSet:add(collectibleType)
+                collectibleTypes[#collectibleTypes + 1] = collectibleType
             end
         end
-        self.cacheFlagToCollectibleTypesMap:set(cacheFlag, collectibleTypeSet)
+        self.cacheFlagToCollectibleTypesMap:set(cacheFlag, collectibleTypes)
     end
 end
 function ModdedElementSets.prototype.lazyInitCacheFlagToTrinketTypesMap(self)
     for ____, cacheFlag in ipairs(CACHE_FLAG_VALUES) do
-        local trinketTypesSet = __TS__New(Set)
+        local trinketTypes = {}
         for ____, trinketType in ipairs(self:getTrinketTypes()) do
             if trinketHasCacheFlag(nil, trinketType, cacheFlag) then
-                trinketTypesSet:add(trinketType)
+                trinketTypes[#trinketTypes + 1] = trinketType
             end
         end
-        self.cacheFlagToTrinketTypesMap:set(cacheFlag, trinketTypesSet)
+        self.cacheFlagToTrinketTypesMap:set(cacheFlag, trinketTypes)
     end
 end
 function ModdedElementSets.prototype.lazyInitFlyingCollectibleTypesSet(self)
-    self.flyingCollectibleTypesSet = copySet(
+    local collectibleTypesWithFlyingCacheFlag = self:getCollectibleTypesWithCacheFlag(CacheFlag.FLYING)
+    local collectibleTypesWithAllCacheFlag = self:getCollectibleTypesWithCacheFlag(CacheFlag.ALL)
+    self.flyingCollectibleTypes = arrayRemove(
         nil,
-        self:getCollectibleTypesWithCacheFlag(CacheFlag.FLYING)
+        collectibleTypesWithFlyingCacheFlag,
+        table.unpack(collectibleTypesWithAllCacheFlag)
     )
-    local collectiblesWithAllCacheFlag = self:getCollectibleTypesWithCacheFlag(CacheFlag.ALL)
-    deleteSetsFromSet(nil, self.flyingCollectibleTypesSet, collectiblesWithAllCacheFlag)
-    local permanentFlyingCollectibleTypes = copySet(nil, self.flyingCollectibleTypesSet)
-    for ____, collectibleType in ipairs(CONDITIONAL_FLYING_COLLECTIBLE_TYPES) do
-        permanentFlyingCollectibleTypes:delete(collectibleType)
-    end
-    for ____, collectibleType in __TS__Iterator(permanentFlyingCollectibleTypes) do
-        self.permanentFlyingCollectibleTypesSet:add(collectibleType)
-    end
-end
-function ModdedElementSets.prototype.lazyInitFlyingTrinketTypesSet(self)
-    self.flyingTrinketTypesSet = copySet(
+    self.permanentFlyingCollectibleTypes = arrayRemove(
         nil,
-        self:getTrinketsTypesWithCacheFlag(CacheFlag.FLYING)
+        self.flyingCollectibleTypes,
+        table.unpack(CONDITIONAL_FLYING_COLLECTIBLE_TYPES)
     )
-    local trinketsWithAllCacheFlag = copySet(
+end
+function ModdedElementSets.prototype.lazyInitFlyingTrinketTypesSet(self)
+    local trinketTypesWithFlyingCacheFlag = self:getTrinketsTypesWithCacheFlag(CacheFlag.FLYING)
+    local trinketTypesWithAllCacheFlag = self:getTrinketsTypesWithCacheFlag(CacheFlag.ALL)
+    local trinketTypesWithAllCacheFlagThatDontGrantFlying = arrayRemove(nil, trinketTypesWithAllCacheFlag, TrinketType.AZAZELS_STUMP)
+    self.flyingTrinketTypes = arrayRemove(
         nil,
-        self:getTrinketsTypesWithCacheFlag(CacheFlag.ALL)
+        trinketTypesWithFlyingCacheFlag,
+        table.unpack(trinketTypesWithAllCacheFlagThatDontGrantFlying)
     )
-    trinketsWithAllCacheFlag:delete(TrinketType.AZAZELS_STUMP)
-    deleteSetsFromSet(nil, self.flyingTrinketTypesSet, trinketsWithAllCacheFlag)
 end
 function ModdedElementSets.prototype.lazyInitEdenCollectibleTypesSet(self)
     for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
         do
             if isHiddenCollectible(nil, collectibleType) or collectibleHasTag(nil, collectibleType, ItemConfigTag.NO_EDEN) then
-                goto __continue61
+                goto __continue57
             end
             if isActiveCollectible(nil, collectibleType) then
                 self.edenActiveCollectibleTypesSet:add(collectibleType)
@@ -44007,40 +43984,38 @@ function ModdedElementSets.prototype.lazyInitEdenCollectibleTypesSet(self)
                 self.edenPassiveCollectibleTypesSet:add(collectibleType)
             end
         end
-        ::__continue61::
+        ::__continue57::
     end
 end
 function ModdedElementSets.prototype.lazyInitQualityToCollectibleTypesMap(self)
     for ____, quality in ipairs(QUALITIES) do
-        local collectibleTypesSet = __TS__New(Set)
+        local collectibleTypes = {}
         for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
             local collectibleTypeQuality = getCollectibleQuality(nil, collectibleType)
             if collectibleTypeQuality == quality then
-                collectibleTypesSet:add(collectibleType)
+                collectibleTypes[#collectibleTypes + 1] = collectibleType
             end
         end
-        self.qualityToCollectibleTypesMap:set(quality, collectibleTypesSet)
+        self.qualityToCollectibleTypesMap:set(quality, collectibleTypes)
     end
 end
 function ModdedElementSets.prototype.lazyInitCardTypes(self)
     for ____, itemConfigCardType in ipairs(ITEM_CONFIG_CARD_TYPE_VALUES) do
-        self.itemConfigCardTypeToCardTypeMap:set(
-            itemConfigCardType,
-            __TS__New(Set)
-        )
+        self.itemConfigCardTypeToCardTypeMap:set(itemConfigCardType, {})
     end
     for ____, cardType in ipairs(self:getCardTypes()) do
         local itemConfigCardType = getItemConfigCardType(nil, cardType)
         if itemConfigCardType ~= nil then
-            local cardTypeSet = self.itemConfigCardTypeToCardTypeMap:get(itemConfigCardType)
+            local cardTypes = self.itemConfigCardTypeToCardTypeMap:get(itemConfigCardType)
             assertDefined(
                 nil,
-                cardTypeSet,
-                "Failed to get the card set for item config card type: " .. tostring(itemConfigCardType)
+                cardTypes,
+                "Failed to get the card types for item config card type: " .. tostring(itemConfigCardType)
             )
-            cardTypeSet:add(cardType)
-            if ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET:has(itemConfigCardType) then
-                self.cardSet:add(cardType)
+            cardTypes[#cardTypes + 1] = cardType
+            if ITEM_CONFIG_CARD_TYPES_FOR_CARDS:has(itemConfigCardType) then
+                local ____self_cardTypeCardArray_12 = self.cardTypeCardArray
+                ____self_cardTypeCardArray_12[#____self_cardTypeCardArray_12 + 1] = cardType
             end
         end
     end
@@ -44157,24 +44132,24 @@ function ModdedElementSets.prototype.getCollectibleTypesWithCacheFlag(self, cach
     self:lazyInit()
     local collectiblesSet = self.cacheFlagToCollectibleTypesMap:get(cacheFlag)
     if collectiblesSet == nil then
-        return __TS__New(ReadonlySet)
+        return {}
     end
     return collectiblesSet
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getCollectibleTypesWithCacheFlag", true)
 function ModdedElementSets.prototype.getTrinketsTypesWithCacheFlag(self, cacheFlag)
     self:lazyInit()
-    local trinketsSet = self.cacheFlagToTrinketTypesMap:get(cacheFlag)
-    if trinketsSet == nil then
-        return __TS__New(ReadonlySet)
+    local trinketTypes = self.cacheFlagToTrinketTypesMap:get(cacheFlag)
+    if trinketTypes == nil then
+        return {}
     end
-    return trinketsSet
+    return trinketTypes
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getTrinketsTypesWithCacheFlag", true)
 function ModdedElementSets.prototype.getPlayerCollectiblesWithCacheFlag(self, player, cacheFlag)
     local collectiblesWithCacheFlag = self:getCollectibleTypesWithCacheFlag(cacheFlag)
     local playerCollectibles = {}
-    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectiblesWithCacheFlag)) do
+    for ____, collectibleType in ipairs(collectiblesWithCacheFlag) do
         local numCollectibles = player:GetCollectibleNum(collectibleType, true)
         ____repeat(
             nil,
@@ -44190,7 +44165,7 @@ __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getPlayerCollecti
 function ModdedElementSets.prototype.getPlayerTrinketsWithCacheFlag(self, player, cacheFlag)
     local trinketTypesWithCacheFlag = self:getTrinketsTypesWithCacheFlag(cacheFlag)
     local playerTrinkets = __TS__New(Map)
-    for ____, trinketType in __TS__Iterator(trinketTypesWithCacheFlag) do
+    for ____, trinketType in ipairs(trinketTypesWithCacheFlag) do
         local trinketMultiplier = player:GetTrinketMultiplier(trinketType)
         if trinketMultiplier > 0 then
             playerTrinkets:set(trinketType, trinketMultiplier)
@@ -44201,12 +44176,12 @@ end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getPlayerTrinketsWithCacheFlag", true)
 function ModdedElementSets.prototype.getFlyingCollectibleTypes(self, includeConditionalItems)
     self:lazyInit()
-    return includeConditionalItems and self.flyingCollectibleTypesSet or self.permanentFlyingCollectibleTypesSet
+    return includeConditionalItems and self.flyingCollectibleTypes or self.permanentFlyingCollectibleTypes
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getFlyingCollectibleTypes", true)
 function ModdedElementSets.prototype.getFlyingTrinketTypes(self)
     self:lazyInit()
-    return self.flyingTrinketTypesSet
+    return self.flyingTrinketTypes
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getFlyingTrinketTypes", true)
 function ModdedElementSets.prototype.getCollectibleTypesWithTag(self, itemConfigTag)
@@ -44223,7 +44198,7 @@ __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getCollectibleTyp
 function ModdedElementSets.prototype.getPlayerCollectiblesWithTag(self, player, itemConfigTag)
     local collectibleTypesWithTag = self:getCollectibleTypesWithTag(itemConfigTag)
     local playerCollectibles = {}
-    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectibleTypesWithTag)) do
+    for ____, collectibleType in ipairs(collectibleTypesWithTag) do
         local numCollectibles = player:GetCollectibleNum(collectibleType, true)
         ____repeat(
             nil,
@@ -44249,7 +44224,7 @@ __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getCollectibleTyp
 function ModdedElementSets.prototype.getPlayerCollectiblesForTransformation(self, player, playerForm)
     local collectibleForTransformation = self:getCollectibleTypesForTransformation(playerForm)
     local playerCollectibles = {}
-    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectibleForTransformation)) do
+    for ____, collectibleType in ipairs(collectibleForTransformation) do
         local numCollectibles = player:GetCollectibleNum(collectibleType, true)
         ____repeat(
             nil,
@@ -44301,33 +44276,33 @@ end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getCollectibleTypesOfQuality", true)
 function ModdedElementSets.prototype.getPlayerCollectiblesOfQuality(self, player, quality)
     local collectibleTypesOfQuality = self:getCollectibleTypesOfQuality(quality)
-    local playerCollectibles = {}
-    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectibleTypesOfQuality)) do
+    local playerCollectibleTypes = {}
+    for ____, collectibleType in ipairs(collectibleTypesOfQuality) do
         local numCollectibles = player:GetCollectibleNum(collectibleType, true)
         ____repeat(
             nil,
             numCollectibles,
             function()
-                playerCollectibles[#playerCollectibles + 1] = collectibleType
+                playerCollectibleTypes[#playerCollectibleTypes + 1] = collectibleType
             end
         )
     end
-    return playerCollectibles
+    return playerCollectibleTypes
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getPlayerCollectiblesOfQuality", true)
 function ModdedElementSets.prototype.getCardTypesOfType(self, ...)
     local itemConfigCardTypes = {...}
     self:lazyInit()
-    local matchingCardTypes = __TS__New(Set)
+    local matchingCardTypes = {}
     for ____, itemConfigCardType in ipairs(itemConfigCardTypes) do
-        local cardTypeSet = self.itemConfigCardTypeToCardTypeMap:get(itemConfigCardType)
+        local cardTypes = self.itemConfigCardTypeToCardTypeMap:get(itemConfigCardType)
         assertDefined(
             nil,
-            cardTypeSet,
-            "Failed to get the card type set for item config type: " .. tostring(itemConfigCardType)
+            cardTypes,
+            "Failed to get the card types for item config type: " .. tostring(itemConfigCardType)
         )
-        for ____, cardType in __TS__Iterator(cardTypeSet) do
-            matchingCardTypes:add(cardType)
+        for ____, cardType in ipairs(cardTypes) do
+            matchingCardTypes[#matchingCardTypes + 1] = cardType
         end
     end
     return matchingCardTypes
@@ -44337,8 +44312,8 @@ function ModdedElementSets.prototype.getRandomCardTypeOfType(self, itemConfigCar
     if exceptions == nil then
         exceptions = {}
     end
-    local cardTypeSet = self:getCardTypesOfType(itemConfigCardType)
-    return getRandomSetElement(nil, cardTypeSet, seedOrRNG, exceptions)
+    local cardTypes = self:getCardTypesOfType(itemConfigCardType)
+    return getRandomArrayElement(nil, cardTypes, seedOrRNG, exceptions)
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getRandomCardTypeOfType", true)
 function ModdedElementSets.prototype.getRandomCard(self, seedOrRNG, exceptions)
@@ -44346,16 +44321,16 @@ function ModdedElementSets.prototype.getRandomCard(self, seedOrRNG, exceptions)
         exceptions = {}
     end
     self:lazyInit()
-    return getRandomSetElement(nil, self.cardSet, seedOrRNG, exceptions)
+    return getRandomArrayElement(nil, self.cardTypeCardArray, seedOrRNG, exceptions)
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getRandomCard", true)
 function ModdedElementSets.prototype.getRandomRune(self, seedOrRNG, exceptions)
     if exceptions == nil then
         exceptions = {}
     end
-    local runesSet = self:getCardTypesOfType(ItemConfigCardType.RUNE)
-    runesSet:delete(CardType.RUNE_SHARD)
-    return getRandomSetElement(nil, runesSet, seedOrRNG, exceptions)
+    local runeCardTypes = self:getCardTypesOfType(ItemConfigCardType.RUNE)
+    exceptions[#exceptions + 1] = CardType.RUNE_SHARD
+    return getRandomArrayElement(nil, runeCardTypes, seedOrRNG, exceptions)
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getRandomRune", true)
 return ____exports
@@ -47196,7 +47171,7 @@ local ____ModCallbackCustom = require("enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____Feature = require("classes.private.Feature")
 local Feature = ____Feature.Feature
-local v = {room = {roomClearGameFrame = nil, roomClearRoomFrame = nil}}
+local v = {room = {roomClearGameFrame = nil, roomClearRenderFrame = nil, roomClearRoomFrame = nil}}
 ____exports.RoomClearFrame = __TS__Class()
 local RoomClearFrame = ____exports.RoomClearFrame
 RoomClearFrame.name = "RoomClearFrame"
@@ -47208,7 +47183,9 @@ function RoomClearFrame.prototype.____constructor(self)
         local gameFrameCount = game:GetFrameCount()
         local room = game:GetRoom()
         local roomFrameCount = room:GetFrameCount()
+        local renderFrameCount = Isaac.GetFrameCount()
         v.room.roomClearGameFrame = gameFrameCount
+        v.room.roomClearRenderFrame = renderFrameCount
         v.room.roomClearRoomFrame = roomFrameCount
     end
     self.customCallbacksUsed = {{ModCallbackCustom.POST_ROOM_CLEAR_CHANGED, self.postRoomClearChangedTrue}}
@@ -47217,8 +47194,12 @@ function RoomClearFrame.prototype.getRoomClearGameFrame(self)
     return v.room.roomClearGameFrame
 end
 __TS__DecorateLegacy({Exported}, RoomClearFrame.prototype, "getRoomClearGameFrame", true)
+function RoomClearFrame.prototype.getRoomClearRenderFrame(self)
+    return v.room.roomClearRenderFrame
+end
+__TS__DecorateLegacy({Exported}, RoomClearFrame.prototype, "getRoomClearRenderFrame", true)
 function RoomClearFrame.prototype.getRoomClearRoomFrame(self)
-    return v.room.roomClearGameFrame
+    return v.room.roomClearRoomFrame
 end
 __TS__DecorateLegacy({Exported}, RoomClearFrame.prototype, "getRoomClearRoomFrame", true)
 return ____exports
@@ -60754,7 +60735,6 @@ return ____exports
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
 local __TS__ClassExtends = ____lualib.__TS__ClassExtends
-local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
@@ -60778,13 +60758,13 @@ end
 function FlyingDetection.prototype.hasFlyingTemporaryEffect(self, player)
     local effects = player:GetEffects()
     local flyingCollectibles = self.moddedElementSets:getFlyingCollectibleTypes(true)
-    for ____, collectibleType in __TS__Iterator(flyingCollectibles) do
+    for ____, collectibleType in ipairs(flyingCollectibles) do
         if effects:HasCollectibleEffect(collectibleType) then
             return true
         end
     end
     local flyingTrinkets = self.moddedElementSets:getFlyingTrinketTypes()
-    for ____, trinketType in __TS__Iterator(flyingTrinkets) do
+    for ____, trinketType in ipairs(flyingTrinkets) do
         if effects:HasTrinketEffect(trinketType) then
             return true
         end