isaacscript-common 9.20.0 → 10.0.2

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 9.20.0
+isaacscript-common 10.0.2
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -304,11 +304,15 @@ local function __TS__ArrayPushArray(self, items)
     return len
 end
 
+local function __TS__CountVarargs(...)
+    return select("#", ...)
+end
+
 local function __TS__ArrayReduce(self, callbackFn, ...)
     local len = #self
     local k = 0
     local accumulator = nil
-    if select("#", ...) ~= 0 then
+    if __TS__CountVarargs(...) ~= 0 then
         accumulator = ...
     elseif len > 0 then
         accumulator = self[1]
@@ -332,7 +336,7 @@ local function __TS__ArrayReduceRight(self, callbackFn, ...)
     local len = #self
     local k = len - 1
     local accumulator = nil
-    if select("#", ...) ~= 0 then
+    if __TS__CountVarargs(...) ~= 0 then
         accumulator = ...
     elseif len > 0 then
         accumulator = self[k + 1]
@@ -448,7 +452,7 @@ end
 local function __TS__ArraySplice(self, ...)
     local args = {...}
     local len = #self
-    local actualArgumentCount = select("#", ...)
+    local actualArgumentCount = __TS__CountVarargs(...)
     local start = args[1]
     local deleteCount = args[2]
     if start < 0 then
@@ -1065,6 +1069,16 @@ local function __TS__DecorateParam(paramIndex, decorator)
     return function(____, target, key) return decorator(nil, target, key, paramIndex) end
 end
 
+local function __TS__StringIncludes(self, searchString, position)
+    if not position then
+        position = 1
+    else
+        position = position + 1
+    end
+    local index = string.find(self, searchString, position, true)
+    return index ~= nil
+end
+
 local Error, RangeError, ReferenceError, SyntaxError, TypeError, URIError
 do
     local function getErrorStack(self, constructor)
@@ -1079,13 +1093,18 @@ do
                 break
             end
         end
-        return debug.traceback(nil, level)
+        if __TS__StringIncludes(_VERSION, "Lua 5.0") then
+            return debug.traceback(("[Level " .. tostring(level)) .. "]")
+        else
+            return debug.traceback(nil, level)
+        end
     end
     local function wrapErrorToString(self, getDescription)
         return function(self)
             local description = getDescription(self)
             local caller = debug.getinfo(3, "f")
-            if _VERSION == "Lua 5.1" or caller and caller.func ~= error then
+            local isClassicLua = __TS__StringIncludes(_VERSION, "Lua 5.0") or _VERSION == "Lua 5.1"
+            if isClassicLua or caller and caller.func ~= error then
                 return description
             else
                 return (tostring(description) .. "\n") .. self.stack
@@ -1234,16 +1253,9 @@ do
     function __TS__Generator(fn)
         return function(...)
             local args = {...}
-            local argsLength = select("#", ...)
+            local argsLength = __TS__CountVarargs(...)
             return {
-                ____coroutine = coroutine.create(function()
-                    local ____fn_1 = fn
-                    local ____unpack_0 = unpack
-                    if ____unpack_0 == nil then
-                        ____unpack_0 = table.unpack
-                    end
-                    return ____fn_1(____unpack_0(args, 1, argsLength))
-                end),
+                ____coroutine = coroutine.create(function() return fn(__TS__Unpack(args, 1, argsLength)) end),
                 [Symbol.iterator] = generatorIterator,
                 next = generatorNext
             }
@@ -1407,8 +1419,12 @@ do
     Map[Symbol.species] = Map
 end
 
+local __TS__Match = string.match
+
 local __TS__MathAtan2 = math.atan2 or math.atan
 
+local __TS__MathModf = math.modf
+
 local function __TS__MathSign(val)
     if val > 0 then
         return 1
@@ -1418,6 +1434,10 @@ local function __TS__MathSign(val)
     return 0
 end
 
+local function __TS__Modulo50(a, b)
+    return a - math.floor(a / b) * b
+end
+
 local function __TS__Number(value)
     local valueType = type(value)
     if valueType == "number" then
@@ -1464,7 +1484,7 @@ do
         if radix < 2 or radix > 36 then
             error("toString() radix argument must be between 2 and 36", 0)
         end
-        local integer, fraction = math.modf(math.abs(self))
+        local integer, fraction = __TS__MathModf(math.abs(self))
         local result = ""
         if radix == 8 then
             result = string.format("%o", integer)
@@ -1620,7 +1640,7 @@ local function __TS__ObjectValues(obj)
 end
 
 local function __TS__ParseFloat(numberString)
-    local infinityMatch = string.match(numberString, "^%s*(-?Infinity)")
+    local infinityMatch = __TS__Match(numberString, "^%s*(-?Infinity)")
     if infinityMatch then
         local ____temp_0
         if __TS__StringAccess(infinityMatch, 0) == "-" then
@@ -1630,7 +1650,7 @@ local function __TS__ParseFloat(numberString)
         end
         return ____temp_0
     end
-    local number = tonumber(string.match(numberString, "^%s*(-?%d+%.?%d*)"))
+    local number = tonumber(__TS__Match(numberString, "^%s*(-?%d+%.?%d*)"))
     local ____number_1 = number
     if ____number_1 == nil then
         ____number_1 = 0 / 0
@@ -1678,16 +1698,16 @@ do
     function __TS__ParseInt(numberString, base)
         if base == nil then
             base = 10
-            local hexMatch = string.match(numberString, "^%s*-?0[xX]")
+            local hexMatch = __TS__Match(numberString, "^%s*-?0[xX]")
             if hexMatch then
                 base = 16
-                local ____string_match_result__0_0
-                if string.match(hexMatch, "-") then
-                    ____string_match_result__0_0 = "-" .. __TS__StringSubstr(numberString, #hexMatch)
+                local ____TS__Match_result__0_0
+                if __TS__Match(hexMatch, "-") then
+                    ____TS__Match_result__0_0 = "-" .. __TS__StringSubstr(numberString, #hexMatch)
                 else
-                    ____string_match_result__0_0 = __TS__StringSubstr(numberString, #hexMatch)
+                    ____TS__Match_result__0_0 = __TS__StringSubstr(numberString, #hexMatch)
                 end
-                numberString = ____string_match_result__0_0
+                numberString = ____TS__Match_result__0_0
             end
         end
         if base < 2 or base > 36 then
@@ -1702,7 +1722,7 @@ do
         local allowedDigits = ____temp_1
         local pattern = ("^%s*(-?[" .. allowedDigits) .. "]*)"
         local number = tonumber(
-            string.match(numberString, pattern),
+            __TS__Match(numberString, pattern),
             base
         )
         if number == nil then
@@ -2014,13 +2034,13 @@ end
 
 local function __TS__SparseArrayNew(...)
     local sparseArray = {...}
-    sparseArray.sparseLength = select("#", ...)
+    sparseArray.sparseLength = __TS__CountVarargs(...)
     return sparseArray
 end
 
 local function __TS__SparseArrayPush(sparseArray, ...)
     local args = {...}
-    local argsLen = select("#", ...)
+    local argsLen = __TS__CountVarargs(...)
     local listLen = sparseArray.sparseLength
     for i = 1, argsLen do
         sparseArray[listLen + i] = args[i]
@@ -2135,6 +2155,8 @@ local function __TS__SourceMapTraceBack(fileName, sourceMap)
             local trace
             if thread == nil and message == nil and level == nil then
                 trace = originalTraceback()
+            elseif __TS__StringIncludes(_VERSION, "Lua 5.0") then
+                trace = originalTraceback((("[Level " .. tostring(level)) .. "] ") .. message)
             else
                 trace = originalTraceback(thread, message, level)
             end
@@ -2160,7 +2182,7 @@ local function __TS__SourceMapTraceBack(fileName, sourceMap)
             local function stringReplacer(____, file, line)
                 local fileSourceMap = _G.__TS__sourcemap[file]
                 if fileSourceMap and fileSourceMap[line] then
-                    local chunkName = string.match(file, "%[string \"([^\"]+)\"%]")
+                    local chunkName = __TS__Match(file, "%[string \"([^\"]+)\"%]")
                     local sourceName = string.gsub(chunkName, ".lua$", ".ts")
                     local data = fileSourceMap[line]
                     if type(data) == "number" then
@@ -2227,16 +2249,6 @@ local function __TS__StringEndsWith(self, searchString, endPosition)
     return string.sub(self, endPosition - #searchString + 1, endPosition) == searchString
 end
 
-local function __TS__StringIncludes(self, searchString, position)
-    if not position then
-        position = 1
-    else
-        position = position + 1
-    end
-    local index = string.find(self, searchString, position, true)
-    return index ~= nil
-end
-
 local function __TS__StringPadEnd(self, maxLength, fillString)
     if fillString == nil then
         fillString = " "
@@ -2492,6 +2504,7 @@ return {
   __TS__Class = __TS__Class,
   __TS__ClassExtends = __TS__ClassExtends,
   __TS__CloneDescriptor = __TS__CloneDescriptor,
+  __TS__CountVarargs = __TS__CountVarargs,
   __TS__Decorate = __TS__Decorate,
   __TS__DecorateParam = __TS__DecorateParam,
   __TS__Delete = __TS__Delete,
@@ -2509,8 +2522,11 @@ return {
   __TS__Iterator = __TS__Iterator,
   __TS__LuaIteratorSpread = __TS__LuaIteratorSpread,
   Map = Map,
+  __TS__Match = __TS__Match,
   __TS__MathAtan2 = __TS__MathAtan2,
+  __TS__MathModf = __TS__MathModf,
   __TS__MathSign = __TS__MathSign,
+  __TS__Modulo50 = __TS__Modulo50,
   __TS__New = __TS__New,
   __TS__Number = __TS__Number,
   __TS__NumberIsFinite = __TS__NumberIsFinite,
@@ -4252,6 +4268,14 @@ do
         end
     end
 end
+do
+    local ____export = require("lua_modules.isaac-typescript-definitions.dist.src.enums.CopyableIsaacAPIClassType")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("lua_modules.isaac-typescript-definitions.dist.src.enums.CurseID")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -4837,7 +4861,7 @@ return ____exports
 ["lua_modules.isaac-typescript-definitions.dist.package"] = function(...) 
 return {
     name = "isaac-typescript-definitions",
-    version = "6.0.0",
+    version = "7.2.0",
     description = "TypeScript definitions for The Binding of Isaac: Repentance.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",
@@ -4848,7 +4872,7 @@ return {
     type = "commonjs",
     main = "dist/src/index",
     types = "dist/src/index.d.ts",
-    dependencies = {["lua-types"] = "^2.12.2"}
+    dependencies = {["lua-types"] = "^2.13.0"}
 }
  end,
 ["lua_modules.isaac-typescript-definitions.dist.src.enums.ActiveSlot"] = function(...) 
@@ -9991,7 +10015,7 @@ ____exports.SwingerVariant.SWINGER = 0
 ____exports.SwingerVariant[____exports.SwingerVariant.SWINGER] = "SWINGER"
 ____exports.SwingerVariant.SWINGER_HEAD = 1
 ____exports.SwingerVariant[____exports.SwingerVariant.SWINGER_HEAD] = "SWINGER_HEAD"
-____exports.SwingerVariant.SWINGER_NECK = 2
+____exports.SwingerVariant.SWINGER_NECK = 10
 ____exports.SwingerVariant[____exports.SwingerVariant.SWINGER_NECK] = "SWINGER_NECK"
 --- For `EntityType.DIP` (217).
 ____exports.DipVariant = {}
@@ -10996,6 +11020,17 @@ ____exports.ControllerIndex.CONTROLLER_2 = 2
 ____exports.ControllerIndex[____exports.ControllerIndex.CONTROLLER_2] = "CONTROLLER_2"
 ____exports.ControllerIndex.CONTROLLER_3 = 3
 ____exports.ControllerIndex[____exports.ControllerIndex.CONTROLLER_3] = "CONTROLLER_3"
+return ____exports
+ end,
+["lua_modules.isaac-typescript-definitions.dist.src.enums.CopyableIsaacAPIClassType"] = function(...) 
+local ____exports = {}
+--- An enum containing the Isaac API classes that can be safely copied / serialized.
+____exports.CopyableIsaacAPIClassType = {}
+____exports.CopyableIsaacAPIClassType.BIT_SET_128 = "BitSet128"
+____exports.CopyableIsaacAPIClassType.COLOR = "Color"
+____exports.CopyableIsaacAPIClassType.K_COLOR = "KColor"
+____exports.CopyableIsaacAPIClassType.RNG = "RNG"
+____exports.CopyableIsaacAPIClassType.VECTOR = "Vector"
 return ____exports
  end,
 ["lua_modules.isaac-typescript-definitions.dist.src.enums.CurseID"] = function(...) 
@@ -18391,6 +18426,7 @@ local ____types = require("src.functions.types")
 local isBoolean = ____types.isBoolean
 local isNumber = ____types.isNumber
 local isString = ____types.isString
+local isUserdata = ____types.isUserdata
 --- In a `Map`, you can use the `clear` method to delete every element. However, in a `LuaMap`, the
 -- `clear` method does not exist. Use this helper function as a drop-in replacement for this.
 function ____exports.clearTable(self, luaMap)
@@ -18398,11 +18434,14 @@ function ____exports.clearTable(self, luaMap)
         luaMap[key] = nil
     end
 end
---- Helper function to copy specific values from a object to a table.
-function ____exports.copyValuesToTable(self, object, keys, luaMap)
-    local otherTable = object
+--- Helper function to copy specific values from a userdata object (e.g. `Vector`) to a table.
+function ____exports.copyUserdataValuesToTable(self, object, keys, luaMap)
+    if not isUserdata(nil, object) then
+        error("Failed to copy an object values to a table, since the object was of type: " .. type(object))
+    end
+    local userdata = object
     for ____, key in ipairs(keys) do
-        local value = otherTable[key]
+        local value = userdata[key]
         luaMap[key] = value
     end
 end
@@ -20182,7 +20221,7 @@ local getRandomSeed = ____rng.getRandomSeed
 local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____table = require("src.functions.table")
-local copyValuesToTable = ____table.copyValuesToTable
+local copyUserdataValuesToTable = ____table.copyUserdataValuesToTable
 local getNumbersFromTable = ____table.getNumbersFromTable
 local tableHasKeys = ____table.tableHasKeys
 local ____types = require("src.functions.types")
@@ -20256,7 +20295,7 @@ function ____exports.serializeVector(self, vector)
         error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
     end
     local vectorTable = {}
-    copyValuesToTable(nil, vector, KEYS, vectorTable)
+    copyUserdataValuesToTable(nil, vector, KEYS, vectorTable)
     vectorTable[SerializationBrand.VECTOR] = ""
     return vectorTable
 end
@@ -24900,7 +24939,7 @@ local getRandomSeed = ____rng.getRandomSeed
 local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____table = require("src.functions.table")
-local copyValuesToTable = ____table.copyValuesToTable
+local copyUserdataValuesToTable = ____table.copyUserdataValuesToTable
 local getNumbersFromTable = ____table.getNumbersFromTable
 local tableHasKeys = ____table.tableHasKeys
 local ____types = require("src.functions.types")
@@ -24984,7 +25023,7 @@ function ____exports.serializeKColor(self, kColor)
         error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
     end
     local kColorTable = {}
-    copyValuesToTable(nil, kColor, KEYS, kColorTable)
+    copyUserdataValuesToTable(nil, kColor, KEYS, kColorTable)
     kColorTable[SerializationBrand.K_COLOR] = ""
     return kColorTable
 end
@@ -26728,6 +26767,8 @@ end
 -- @param startingPosition The position to start searching from. If this position is not overlapping
 -- with anything, then it will be returned.
 -- @param avoidActiveEntities Optional. Default is false.
+-- @param minimumDistance Optional. If specified, will ensure that the randomly generated position
+-- is equal to or greater than the distance provided.
 function ____exports.findFreePosition(self, startingPosition, avoidActiveEntities, minimumDistance)
     if avoidActiveEntities == nil then
         avoidActiveEntities = false
@@ -26866,18 +26907,6 @@ ____exports.SerializationType.SERIALIZE = 1
 ____exports.SerializationType[____exports.SerializationType.SERIALIZE] = "SERIALIZE"
 ____exports.SerializationType.DESERIALIZE = 2
 ____exports.SerializationType[____exports.SerializationType.DESERIALIZE] = "DESERIALIZE"
-return ____exports
- end,
-["src.enums.private.CopyableIsaacAPIClassType"] = function(...) 
-local ____exports = {}
---- - This must match the JSDoc comments for `deepCopy` and `merge`.
--- - This must match the `SerializableIsaacAPIClass` type union.
-____exports.CopyableIsaacAPIClassType = {}
-____exports.CopyableIsaacAPIClassType.BIT_SET_128 = "BitSet128"
-____exports.CopyableIsaacAPIClassType.COLOR = "Color"
-____exports.CopyableIsaacAPIClassType.K_COLOR = "KColor"
-____exports.CopyableIsaacAPIClassType.RNG = "RNG"
-____exports.CopyableIsaacAPIClassType.VECTOR = "Vector"
 return ____exports
  end,
 ["src.features.saveDataManager.saveDataManagerConstants"] = function(...) 
@@ -29597,8 +29626,8 @@ return ____exports
  end,
 ["src.objects.isaacAPIClassTypeToBrand"] = function(...) 
 local ____exports = {}
-local ____CopyableIsaacAPIClassType = require("src.enums.private.CopyableIsaacAPIClassType")
-local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local CopyableIsaacAPIClassType = ____isaac_2Dtypescript_2Ddefinitions.CopyableIsaacAPIClassType
 local ____SerializationBrand = require("src.enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 ____exports.ISAAC_API_CLASS_TYPE_TO_BRAND = {
@@ -29618,7 +29647,7 @@ local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____isaacAPIClass = require("src.functions.isaacAPIClass")
 local isIsaacAPIClassOfType = ____isaacAPIClass.isIsaacAPIClassOfType
 local ____table = require("src.functions.table")
-local copyValuesToTable = ____table.copyValuesToTable
+local copyUserdataValuesToTable = ____table.copyUserdataValuesToTable
 local getNumbersFromTable = ____table.getNumbersFromTable
 local tableHasKeys = ____table.tableHasKeys
 local ____types = require("src.functions.types")
@@ -29677,7 +29706,7 @@ function ____exports.serializeBitSet128(self, bitSet128)
         error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
     end
     local bitSet128Table = {}
-    copyValuesToTable(nil, bitSet128, KEYS, bitSet128Table)
+    copyUserdataValuesToTable(nil, bitSet128, KEYS, bitSet128Table)
     bitSet128Table[SerializationBrand.BIT_SET_128] = ""
     return bitSet128Table
 end
@@ -29698,7 +29727,7 @@ local getRandomSeed = ____rng.getRandomSeed
 local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____table = require("src.functions.table")
-local copyValuesToTable = ____table.copyValuesToTable
+local copyUserdataValuesToTable = ____table.copyUserdataValuesToTable
 local getNumbersFromTable = ____table.getNumbersFromTable
 local tableHasKeys = ____table.tableHasKeys
 local ____types = require("src.functions.types")
@@ -29803,7 +29832,7 @@ function ____exports.serializeColor(self, color)
         error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
     end
     local colorTable = {}
-    copyValuesToTable(nil, color, KEYS, colorTable)
+    copyUserdataValuesToTable(nil, color, KEYS, colorTable)
     colorTable[SerializationBrand.COLOR] = ""
     return colorTable
 end
@@ -29811,44 +29840,75 @@ return ____exports
  end,
 ["src.objects.isaacAPIClassTypeToFunctions"] = function(...) 
 local ____exports = {}
-local ____CopyableIsaacAPIClassType = require("src.enums.private.CopyableIsaacAPIClassType")
-local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local CopyableIsaacAPIClassType = ____isaac_2Dtypescript_2Ddefinitions.CopyableIsaacAPIClassType
 local ____bitSet128 = require("src.functions.bitSet128")
 local copyBitSet128 = ____bitSet128.copyBitSet128
 local deserializeBitSet128 = ____bitSet128.deserializeBitSet128
+local isBitSet128 = ____bitSet128.isBitSet128
 local isSerializedBitSet128 = ____bitSet128.isSerializedBitSet128
 local serializeBitSet128 = ____bitSet128.serializeBitSet128
 local ____color = require("src.functions.color")
 local copyColor = ____color.copyColor
 local deserializeColor = ____color.deserializeColor
+local isColor = ____color.isColor
 local isSerializedColor = ____color.isSerializedColor
 local serializeColor = ____color.serializeColor
 local ____kColor = require("src.functions.kColor")
 local copyKColor = ____kColor.copyKColor
 local deserializeKColor = ____kColor.deserializeKColor
+local isKColor = ____kColor.isKColor
 local isSerializedKColor = ____kColor.isSerializedKColor
 local serializeKColor = ____kColor.serializeKColor
 local ____rng = require("src.functions.rng")
 local copyRNG = ____rng.copyRNG
 local deserializeRNG = ____rng.deserializeRNG
+local isRNG = ____rng.isRNG
 local isSerializedRNG = ____rng.isSerializedRNG
 local serializeRNG = ____rng.serializeRNG
 local ____vector = require("src.functions.vector")
 local copyVector = ____vector.copyVector
 local deserializeVector = ____vector.deserializeVector
 local isSerializedVector = ____vector.isSerializedVector
+local isVector = ____vector.isVector
 local serializeVector = ____vector.serializeVector
 ____exports.ISAAC_API_CLASS_TYPE_TO_FUNCTIONS = {
-    [CopyableIsaacAPIClassType.BIT_SET_128] = {isSerialized = isSerializedBitSet128, copy = copyBitSet128, serialize = serializeBitSet128, deserialize = deserializeBitSet128},
-    [CopyableIsaacAPIClassType.COLOR] = {isSerialized = isSerializedColor, copy = copyColor, serialize = serializeColor, deserialize = deserializeColor},
-    [CopyableIsaacAPIClassType.K_COLOR] = {isSerialized = isSerializedKColor, copy = copyKColor, serialize = serializeKColor, deserialize = deserializeKColor},
-    [CopyableIsaacAPIClassType.RNG] = {isSerialized = isSerializedRNG, copy = copyRNG, serialize = serializeRNG, deserialize = deserializeRNG},
-    [CopyableIsaacAPIClassType.VECTOR] = {isSerialized = isSerializedVector, copy = copyVector, serialize = serializeVector, deserialize = deserializeVector}
+    [CopyableIsaacAPIClassType.BIT_SET_128] = {
+        is = isBitSet128,
+        isSerialized = isSerializedBitSet128,
+        copy = copyBitSet128,
+        serialize = serializeBitSet128,
+        deserialize = deserializeBitSet128
+    },
+    [CopyableIsaacAPIClassType.COLOR] = {
+        is = isColor,
+        isSerialized = isSerializedColor,
+        copy = copyColor,
+        serialize = serializeColor,
+        deserialize = deserializeColor
+    },
+    [CopyableIsaacAPIClassType.K_COLOR] = {
+        is = isKColor,
+        isSerialized = isSerializedKColor,
+        copy = copyKColor,
+        serialize = serializeKColor,
+        deserialize = deserializeKColor
+    },
+    [CopyableIsaacAPIClassType.RNG] = {
+        is = isRNG,
+        isSerialized = isSerializedRNG,
+        copy = copyRNG,
+        serialize = serializeRNG,
+        deserialize = deserializeRNG
+    },
+    [CopyableIsaacAPIClassType.VECTOR] = {
+        is = isVector,
+        isSerialized = isSerializedVector,
+        copy = copyVector,
+        serialize = serializeVector,
+        deserialize = deserializeVector
+    }
 }
-return ____exports
- end,
-["src.types.SerializedIsaacAPIClass"] = function(...) 
-local ____exports = {}
 return ____exports
  end,
 ["src.functions.serialization"] = function(...) 
@@ -29917,6 +29977,21 @@ function ____exports.deserializeIsaacAPIClass(self, serializedIsaacAPIClass)
     end
     return functions:deserialize(serializedIsaacAPIClass)
 end
+--- Helper function to generically check if a given object is a copyable Isaac API class. (This is
+-- used by the save data manager when determining what is safe to copy.)
+-- 
+-- For the list of supported classes, see the `CopyableIsaacAPIClassType` enum.
+function ____exports.isCopyableIsaacAPIClass(self, object)
+    local allFunctions = __TS__ObjectValues(ISAAC_API_CLASS_TYPE_TO_FUNCTIONS)
+    local isFunctions = __TS__ArrayMap(
+        allFunctions,
+        function(____, functions) return functions.is end
+    )
+    return __TS__ArraySome(
+        isFunctions,
+        function(____, identityFunction) return identityFunction(nil, object) end
+    )
+end
 --- Helper function to generically check if a given Lua table is a serialized Isaac API class. (This
 -- is used by the save data manager when reading data from the "save#.dat" file.)
 -- 
@@ -29955,18 +30030,16 @@ return ____exports
  end,
 ["src.functions.deepCopy"] = function(...) 
 local ____lualib = require("lualib_bundle")
-local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local Map = ____lualib.Map
+local Set = ____lualib.Set
 local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
-local deepCopyTable, deepCopyDefaultMap, getNewDefaultMap, deepCopyMap, deepCopySet, deepCopyTSTLClass, deepCopyArray, deepCopyNormalLuaTable, getCopiedEntries, checkMetatable, deepCopyUserdata, COPYABLE_ISAAC_API_CLASS_TYPES_SET
+local deepCopyTable, deepCopyDefaultMap, getNewDefaultMap, deepCopyMap, deepCopySet, deepCopyTSTLClass, deepCopyArray, deepCopyNormalLuaTable, getCopiedEntries, checkMetatable, deepCopyUserdata
 local ____DefaultMap = require("src.classes.DefaultMap")
 local DefaultMap = ____DefaultMap.DefaultMap
-local ____CopyableIsaacAPIClassType = require("src.enums.private.CopyableIsaacAPIClassType")
-local CopyableIsaacAPIClassType = ____CopyableIsaacAPIClassType.CopyableIsaacAPIClassType
 local ____SerializationBrand = require("src.enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____SerializationType = require("src.enums.SerializationType")
@@ -29977,8 +30050,6 @@ local ____serializationBrands = require("src.features.saveDataManager.serializat
 local isSerializationBrand = ____serializationBrands.isSerializationBrand
 local ____array = require("src.functions.array")
 local isArray = ____array.isArray
-local ____enums = require("src.functions.enums")
-local getEnumValues = ____enums.getEnumValues
 local ____isaacAPIClass = require("src.functions.isaacAPIClass")
 local getIsaacAPIClassName = ____isaacAPIClass.getIsaacAPIClassName
 local ____log = require("src.functions.log")
@@ -29986,6 +30057,7 @@ local log = ____log.log
 local ____serialization = require("src.functions.serialization")
 local copyIsaacAPIClass = ____serialization.copyIsaacAPIClass
 local deserializeIsaacAPIClass = ____serialization.deserializeIsaacAPIClass
+local isCopyableIsaacAPIClass = ____serialization.isCopyableIsaacAPIClass
 local isSerializedIsaacAPIClass = ____serialization.isSerializedIsaacAPIClass
 local serializeIsaacAPIClass = ____serialization.serializeIsaacAPIClass
 local ____tstlClass = require("src.functions.tstlClass")
@@ -30069,6 +30141,9 @@ function ____exports.deepCopy(self, value, serializationType, traversalDescripti
                 if serializationType == SerializationType.SERIALIZE then
                     error((("The deep copy function does not support serialization of \"" .. traversalDescription) .. "\", since it is type: ") .. valueType)
                 end
+                if serializationType == SerializationType.DESERIALIZE then
+                    error((("The deep copy function does not support deserialization of \"" .. traversalDescription) .. "\", since it is type: ") .. valueType)
+                end
                 return value
             end
         end
@@ -30220,15 +30295,15 @@ function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescri
 end
 function getNewDefaultMap(self, defaultMap, serializationType, traversalDescription, constructorArg)
     repeat
-        local ____switch34 = serializationType
-        local ____cond34 = ____switch34 == SerializationType.NONE
-        if ____cond34 then
+        local ____switch35 = serializationType
+        local ____cond35 = ____switch35 == SerializationType.NONE
+        if ____cond35 then
             do
                 return __TS__New(DefaultMap, constructorArg)
             end
         end
-        ____cond34 = ____cond34 or ____switch34 == SerializationType.SERIALIZE
-        if ____cond34 then
+        ____cond35 = ____cond35 or ____switch35 == SerializationType.SERIALIZE
+        if ____cond35 then
             do
                 local newDefaultMap = {}
                 newDefaultMap[SerializationBrand.DEFAULT_MAP] = ""
@@ -30236,8 +30311,8 @@ function getNewDefaultMap(self, defaultMap, serializationType, traversalDescript
                 return newDefaultMap
             end
         end
-        ____cond34 = ____cond34 or ____switch34 == SerializationType.DESERIALIZE
-        if ____cond34 then
+        ____cond35 = ____cond35 or ____switch35 == SerializationType.DESERIALIZE
+        if ____cond35 then
             do
                 if isDefaultMap(nil, defaultMap) then
                     error(("The deep copy function failed to deserialize a default map of \"" .. traversalDescription) .. "\", since it was not a Lua table.")
@@ -30437,7 +30512,7 @@ function getCopiedEntries(self, object, serializationType, traversalDescription,
         local value = ____value[2]
         do
             if isSerializationBrand(nil, key) then
-                goto __continue87
+                goto __continue88
             end
             traversalDescription = getTraversalDescription(nil, key, traversalDescription)
             local newValue = ____exports.deepCopy(
@@ -30459,7 +30534,7 @@ function getCopiedEntries(self, object, serializationType, traversalDescription,
             end
             copiedEntries[#copiedEntries + 1] = {keyToUse, newValue}
         end
-        ::__continue87::
+        ::__continue88::
     end
     return {entries = copiedEntries, convertedNumberKeysToStrings = convertNumberKeysToStrings}
 end
@@ -30472,15 +30547,12 @@ function checkMetatable(self, luaMap, traversalDescription)
     error(("The deepCopy function detected that " .. tableDescription) .. " has a metatable. Copying tables with metatables is not supported, unless they are explicitly handled by the save data manager. (e.g. TypeScriptToLua Maps, TypeScriptToLua Sets, etc.)")
 end
 function deepCopyUserdata(self, value, serializationType, traversalDescription)
-    if SAVE_DATA_MANAGER_DEBUG then
-        log(nil, "deepCopy is copying userdata.")
-    end
     local classType = getIsaacAPIClassName(nil, value)
     if classType == nil then
         error("The deep copy function was not able to derive the Isaac API class type for: " .. traversalDescription)
     end
-    if not COPYABLE_ISAAC_API_CLASS_TYPES_SET:has(classType) then
-        error((("The deep copy function does not support copying \"" .. traversalDescription) .. "\", since it is an Isaac API class of type: ") .. classType)
+    if not isCopyableIsaacAPIClass(nil, value) then
+        error((("The deep copy function does not support serializing \"" .. traversalDescription) .. "\", since it is an Isaac API class of type: ") .. classType)
     end
     repeat
         local ____switch99 = serializationType
@@ -30499,15 +30571,12 @@ function deepCopyUserdata(self, value, serializationType, traversalDescription)
         ____cond99 = ____cond99 or ____switch99 == SerializationType.DESERIALIZE
         if ____cond99 then
             do
-                return deserializeIsaacAPIClass(nil, value)
+                error(("The deep copy function can not deserialize \"" .. traversalDescription) .. "\", since it is userdata.")
             end
+            break
         end
     until true
 end
-COPYABLE_ISAAC_API_CLASS_TYPES_SET = __TS__New(
-    Set,
-    getEnumValues(nil, CopyableIsaacAPIClassType)
-)
 return ____exports
  end,
 ["src.interfaces.SaveData"] = function(...) 
@@ -31915,7 +31984,7 @@ local ____flag = require("src.functions.flag")
 local hasFlag = ____flag.hasFlag
 --- Helper function to get the actual bit flag for modded curses.
 -- 
--- Will throw a runtime error if the provided curse does not exist.
+-- Will throw a run-time error if the provided curse does not exist.
 -- 
 -- Use this over the `Isaac.GetCurseIdByName` method because that will return an integer instead of
 -- a bit flag.
@@ -45549,16 +45618,21 @@ end
 -- Specifically, this will clear the current room of all entities and grid entities, and then spawn
 -- all of the entries and grid entities in the provided JSON room.
 -- 
+-- You can create JSON rooms by using the `convert-xml-to-json` tool (e.g. `npx convert-xml-to-json
+-- my-rooms.xml`).
+-- 
 -- This function is meant to be used in the `POST_NEW_ROOM` callback.
 -- 
 -- For example:
 -- 
 -- ```ts
 -- 
--- import customRooms from "./customRooms";
+-- import customRooms from "./customRooms.json";
 -- 
--- const firstJSONRoom = customRooms.rooms.room[0];
--- deployJSONRoom(firstJSONRoom);
+-- export function postNewRoom(): void {
+--   const firstJSONRoom = customRooms.rooms.room[0];
+--   deployJSONRoom(firstJSONRoom);
+-- }
 -- ```
 -- 
 -- @param jsonRoom The JSON room to deploy. *
@@ -45596,6 +45670,9 @@ end
 -- Specifically, this will clear the current room of all entities and grid entities, and then spawn
 -- all of the entries and grid entities in one of the provided JSON rooms.
 -- 
+-- You can create JSON rooms by using the `convert-xml-to-json` tool (e.g. `npx convert-xml-to-json
+-- my-rooms.xml`).
+-- 
 -- This function is meant to be used in the `POST_NEW_ROOM` callback.
 -- 
 -- Note that this function does not simply choose a random element in the provided array; it will
@@ -45605,10 +45682,12 @@ end
 -- For example:
 -- 
 -- ```ts
--- import customRooms from "./customRooms";
+-- import customRooms from "./customRooms.json";
 -- 
--- const jsonRooms = customRooms.rooms.room;
--- deployRandomJSONRoom(jsonRooms);
+-- export function postNewRoom(): void {
+--   const jsonRooms = customRooms.rooms.room;
+--   deployRandomJSONRoom(jsonRooms);
+-- }
 -- ```
 -- 
 -- @param jsonRooms An array of JSON rooms to randomly select from. In practice, this will be
@@ -46824,7 +46903,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "9.20.0",
+    version = "10.0.2",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",
@@ -46835,7 +46914,7 @@ return {
     type = "commonjs",
     main = "dist/src/index",
     types = "dist/src/index.d.ts",
-    dependencies = {["isaac-typescript-definitions"] = "^6.0.0"}
+    dependencies = {["isaac-typescript-definitions"] = "^7.2.0"}
 }
  end,
 ["src.functions.map"] = function(...) 
@@ -48312,8 +48391,7 @@ function copiedObjectHasKeyAndValueString(self)
     local keyToLookFor = "abc"
     local valueToLookFor = "def"
     local oldObject = {abc = valueToLookFor}
-    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasKeyAndValueString")
-    local newObject = newTable
+    local newObject = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasKeyAndValueString")
     local value = newObject[keyToLookFor]
     if value == nil then
         error("The copied object did not have a key of: " .. keyToLookFor)
@@ -48330,8 +48408,7 @@ function copiedTableHasKeyAndValueNumber(self)
     local valueToLookFor = 456
     local oldTable = {}
     oldTable[keyToLookFor] = valueToLookFor
-    local newObject = deepCopy(nil, oldTable, SerializationType.NONE, "copiedTableHasKeyAndValueNumber")
-    local newTable = newObject
+    local newTable = deepCopy(nil, oldTable, SerializationType.NONE, "copiedTableHasKeyAndValueNumber")
     local value = newTable[keyToLookFor]
     if value == nil then
         error("The copied object did not have a key of: " .. tostring(keyToLookFor))
@@ -48348,8 +48425,7 @@ function copiedTableDoesNotCoerceTypes(self)
     local valueToLookFor = 456
     local oldTable = {}
     oldTable[keyToLookFor] = valueToLookFor
-    local newObject = deepCopy(nil, oldTable, SerializationType.NONE, "copiedTableDoesNotCoerceTypes")
-    local newTable = newObject
+    local newTable = deepCopy(nil, oldTable, SerializationType.NONE, "copiedTableDoesNotCoerceTypes")
     local keyString = tostring(keyToLookFor)
     local valueString = tostring(valueToLookFor)
     local valueFromString = newTable[keyString]
@@ -48365,8 +48441,7 @@ function copiedObjectHasNoReferencesForPrimitivesForward(self)
     local originalStringValue = "abcdef"
     local originalNumberValue = 123
     local oldObject = {abc = originalStringValue, def = originalNumberValue}
-    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForPrimitivesForward")
-    local newObject = newTable
+    local newObject = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForPrimitivesForward")
     oldObject.abc = "newValue"
     if oldObject.abc == newObject.abc then
         error("The copied object has a string reference going forward.")
@@ -48380,8 +48455,7 @@ function copiedObjectHasNoReferencesForPrimitivesBackward(self)
     local originalStringValue = "abcdef"
     local originalNumberValue = 123
     local oldObject = {abc = originalStringValue, def = originalNumberValue}
-    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForPrimitivesBackward")
-    local newObject = newTable
+    local newObject = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForPrimitivesBackward")
     newObject.abc = "newValue"
     if newObject.abc == oldObject.abc then
         error("The copied object has a string reference going backward.")
@@ -48393,8 +48467,7 @@ function copiedObjectHasNoReferencesForPrimitivesBackward(self)
 end
 function copiedObjectHasNoReferencesForArray(self)
     local oldObject = {abc = {1, 2, 3}}
-    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForArray")
-    local newObject = newTable
+    local newObject = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasNoReferencesForArray")
     if oldObject.abc == newObject.abc then
         error("The copied object has the same point to the child array.")
     end
@@ -48421,8 +48494,7 @@ function copiedObjectHasChildObject(self)
     local keyToLookFor = "def"
     local valueToLookFor = "ghi"
     local oldObject = {abc = {def = valueToLookFor}}
-    local newTable = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasChildObject")
-    local newObject = newTable
+    local newObject = deepCopy(nil, oldObject, SerializationType.NONE, "copiedObjectHasChildObject")
     local childObject = newObject[childObjectIndex]
     if childObject == nil then
         error("Failed to find the child object at index: " .. childObjectIndex)
@@ -48446,8 +48518,7 @@ function copiedMapIsMap(self)
     local valueToLookFor = "def"
     local oldMap = __TS__New(Map)
     oldMap:set(keyToLookFor, valueToLookFor)
-    local newObject = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapIsMap")
-    local newMap = newObject
+    local newMap = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapIsMap")
     if not isTSTLMap(nil, newMap) then
         error("The copied Map was not a Map and has a type of: " .. __TS__TypeOf(newMap))
     end
@@ -48457,8 +48528,7 @@ function copiedMapHasValue(self)
     local valueToLookFor = "def"
     local oldMap = __TS__New(Map)
     oldMap:set(keyToLookFor, valueToLookFor)
-    local newTable = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapHasValue")
-    local newMap = newTable
+    local newMap = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapHasValue")
     if not isTSTLMap(nil, newMap) then
         error("The copied Map was not a Map and has a type of: " .. __TS__TypeOf(newMap))
     end
@@ -48474,8 +48544,7 @@ function copiedSetIsSet(self)
     local valueToLookFor = "abc"
     local oldSet = __TS__New(Set)
     oldSet:add(valueToLookFor)
-    local newTable = deepCopy(nil, oldSet, SerializationType.NONE, "copiedSetIsSet")
-    local newSet = newTable
+    local newSet = deepCopy(nil, oldSet, SerializationType.NONE, "copiedSetIsSet")
     if not isTSTLSet(nil, newSet) then
         error("The copied Set was not a Set and has a type of: " .. __TS__TypeOf(newSet))
     end
@@ -48484,8 +48553,7 @@ function copiedSetHasValue(self)
     local valueToLookFor = "abc"
     local oldSet = __TS__New(Set)
     oldSet:add(valueToLookFor)
-    local newTable = deepCopy(nil, oldSet, SerializationType.NONE, "copiedSetHasValue")
-    local newSet = newTable
+    local newSet = deepCopy(nil, oldSet, SerializationType.NONE, "copiedSetHasValue")
     if not isTSTLSet(nil, newSet) then
         error("The copied Set was not a Set and has a type of: " .. __TS__TypeOf(newSet))
     end
@@ -48502,8 +48570,7 @@ function copiedMapHasChildMap(self)
     local keyToLookFor = "childMap"
     local oldMap = __TS__New(Map)
     oldMap:set(keyToLookFor, oldChildMap)
-    local newTable = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapHasChildMap")
-    local newMap = newTable
+    local newMap = deepCopy(nil, oldMap, SerializationType.NONE, "copiedMapHasChildMap")
     if not isTSTLMap(nil, newMap) then
         error("The copied Map was not a Map and had a type of: " .. __TS__TypeOf(newMap))
     end
@@ -48535,8 +48602,7 @@ function copiedDefaultMapHasChildDefaultMap(self)
     local oldChildMap = oldParentMap:getAndSetDefault(parentMapKey)
     oldChildMap:getAndSetDefault(childMapKey1)
     oldChildMap:set(childMapKey2, childMapCustomValue)
-    local newTable = deepCopy(nil, oldParentMap, SerializationType.NONE, "copiedDefaultMapHasChildDefaultMap")
-    local newParentMap = newTable
+    local newParentMap = deepCopy(nil, oldParentMap, SerializationType.NONE, "copiedDefaultMapHasChildDefaultMap")
     if not isDefaultMap(nil, newParentMap) then
         error("The copied parent DefaultMap was not a DefaultMap and had a type of: " .. __TS__TypeOf(newParentMap))
     end
@@ -54811,6 +54877,47 @@ function ____exports.getVanillaTrinketSet(self)
     lazyInitVanillaTrinketTypes(nil)
     return VANILLA_TRINKET_TYPES_SET
 end
+return ____exports
+ end,
+["src.types.WeightedArray"] = function(...) 
+local ____exports = {}
+return ____exports
+ end,
+["src.functions.weighted"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local ____exports = {}
+local ____array = require("src.functions.array")
+local arrayToString = ____array.arrayToString
+local sumArray = ____array.sumArray
+local ____random = require("src.functions.random")
+local getRandomFloat = ____random.getRandomFloat
+local ____rng = require("src.functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+--- Get a random value from a `WeightedArray`. (The second element in the array is the weight.)
+function ____exports.getRandomFromWeightedArray(self, weightedArray, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if #weightedArray == 0 then
+        error("Failed to get a random element from a weighted array since the provided array was empty.")
+    end
+    local weights = __TS__ArrayMap(
+        weightedArray,
+        function(____, tuple) return tuple[2] end
+    )
+    local totalWeight = sumArray(nil, weights)
+    local randomWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
+    local weightAccumulator = 0
+    for ____, tuple in ipairs(weightedArray) do
+        local element, weight = table.unpack(tuple)
+        weightAccumulator = weightAccumulator + weight
+        if weightAccumulator >= randomWeight then
+            return element
+        end
+    end
+    error("Failed to get a random element from a weighted array: " .. arrayToString(nil, weightedArray))
+end
 return ____exports
  end,
 ["src.objects.colors"] = function(...) 
@@ -56074,6 +56181,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.functions.weighted")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.maps.cardNameToTypeMap")
     for ____exportKey, ____exportValue in pairs(____export) do