isaacscript-common 1.0.485 → 1.0.489

package/dist/functions/deepCopyTests.lua

@@ -43,18 +43,14 @@ function copiedTableHasKeyAndValueNumber(self)
     local newTable = newObject
     local value = newTable[keyToLookFor]
     if value == nil then
-        error(
-            "The copied object did not have a key of: " .. tostring(keyToLookFor)
-        )
+        error("The copied object did not have a key of: " .. tostring(keyToLookFor))
     end
     local valueType = type(value)
     if valueType ~= "number" then
         error("The copied object had a value type of: " .. valueType)
     end
     if value ~= valueToLookFor then
-        error(
-            "The copied object had a value of: " .. tostring(value)
-        )
+        error("The copied object had a value of: " .. tostring(value))
     end
 end
 function copiedTableDoesNotCoerceTypes(self)
@@ -115,20 +111,20 @@ function copiedObjectHasNoReferencesForArray(self)
     if not arrayEquals(nil, oldObject.abc, newObject.abc) then
         error("The copied object does not have an equal array.")
     end
-    local ____obj, ____index = oldObject.abc, 0 + 1
-    ____obj[____index] = ____obj[____index] + 1
+    local ____oldObject_abc_0, ____1_1 = oldObject.abc, 1
+    ____oldObject_abc_0[____1_1] = ____oldObject_abc_0[____1_1] + 1
     if arrayEquals(nil, oldObject.abc, newObject.abc) then
         error("The copied object has an equal array after a modification to the old array.")
     end
-    local ____obj, ____index = oldObject.abc, 0 + 1
-    ____obj[____index] = ____obj[____index] - 1
-    local ____obj, ____index = newObject.abc, 0 + 1
-    ____obj[____index] = ____obj[____index] + 1
+    local ____oldObject_abc_2, ____1_3 = oldObject.abc, 1
+    ____oldObject_abc_2[____1_3] = ____oldObject_abc_2[____1_3] - 1
+    local ____newObject_abc_4, ____1_5 = newObject.abc, 1
+    ____newObject_abc_4[____1_5] = ____newObject_abc_4[____1_5] + 1
     if arrayEquals(nil, oldObject.abc, newObject.abc) then
         error("The copied object has an equal array after a modification to the new array.")
     end
-    local ____obj, ____index = newObject.abc, 0 + 1
-    ____obj[____index] = ____obj[____index] - 1
+    local ____newObject_abc_6, ____1_7 = newObject.abc, 1
+    ____newObject_abc_6[____1_7] = ____newObject_abc_6[____1_7] - 1
 end
 function copiedObjectHasChildObject(self)
     local childObjectIndex = "abc"
@@ -235,14 +231,10 @@ function copiedMapHasChildMap(self)
     end
     local value = newChildMap:get(childMapKey)
     if value == nil then
-        error(
-            "The copied child Map did not have a key of: " .. tostring(childMapKey)
-        )
+        error("The copied child Map did not have a key of: " .. tostring(childMapKey))
     end
     if value ~= childMapValue then
-        error(
-            "The copied child Map did not have a value of: " .. tostring(childMapValue)
-        )
+        error("The copied child Map did not have a value of: " .. tostring(childMapValue))
     end
 end
 function ____exports.deepCopyTests(self)

package/dist/functions/doors.lua

@@ -42,18 +42,14 @@ function ____exports.isSecretRoomDoor(self, door)
     return filename == "gfx/grid/Door_08_HoleInWall.anm2"
 end
 function ____exports.closeAllDoors(self)
-    for ____, door in ipairs(
-        ____exports.getDoors(nil)
-    ) do
+    for ____, door in ipairs(____exports.getDoors(nil)) do
         door.State = DoorState.STATE_CLOSED
         local sprite = door:GetSprite()
         sprite:Play("Close", true)
     end
 end
 function ____exports.getAngelRoomDoor(self)
-    for ____, door in ipairs(
-        ____exports.getDoors(nil)
-    ) do
+    for ____, door in ipairs(____exports.getDoors(nil)) do
         if ____exports.isAngelRoomDoor(nil, door) then
             return door
         end
@@ -61,9 +57,7 @@ function ____exports.getAngelRoomDoor(self)
     return nil
 end
 function ____exports.getDevilRoomDoor(self)
-    for ____, door in ipairs(
-        ____exports.getDoors(nil)
-    ) do
+    for ____, door in ipairs(____exports.getDoors(nil)) do
         if ____exports.isDevilRoomDoor(nil, door) then
             return door
         end
@@ -71,9 +65,7 @@ function ____exports.getDevilRoomDoor(self)
     return nil
 end
 function ____exports.getDevilRoomOrAngelRoomDoor(self)
-    for ____, door in ipairs(
-        ____exports.getDoors(nil)
-    ) do
+    for ____, door in ipairs(____exports.getDoors(nil)) do
         if ____exports.isDevilRoomDoor(nil, door) or ____exports.isAngelRoomDoor(nil, door) then
             return door
         end
@@ -81,9 +73,7 @@ function ____exports.getDevilRoomOrAngelRoomDoor(self)
     return nil
 end
 function ____exports.getRepentanceDoor(self)
-    for ____, door in ipairs(
-        ____exports.getDoors(nil)
-    ) do
+    for ____, door in ipairs(____exports.getDoors(nil)) do
         if ____exports.isRepentanceDoor(nil, door) then
             return door
         end
@@ -93,7 +83,7 @@ end
 function ____exports.isHiddenSecretRoomDoor(self, door)
     local sprite = door:GetSprite()
     local animation = sprite:GetAnimation()
-    return ____exports.isSecretRoomDoor(nil, door) and (animation == "Hidden")
+    return ____exports.isSecretRoomDoor(nil, door) and animation == "Hidden"
 end
 function ____exports.isDoorToDownpour(self, door)
     if not ____exports.isRepentanceDoor(nil, door) then
@@ -136,9 +126,7 @@ function ____exports.isDoorToMomsHeart(self, door)
     return filename == "gfx/grid/Door_MomsHeart.anm2"
 end
 function ____exports.openAllDoors(self)
-    for ____, door in ipairs(
-        ____exports.getDoors(nil)
-    ) do
+    for ____, door in ipairs(____exports.getDoors(nil)) do
         door:Open()
     end
 end

package/dist/functions/entity.lua

@@ -298,7 +298,13 @@ function ____exports.setEntityRandomColor(self, entity)
         end
     end
     local color = Color(colorValues[1], colorValues[2], colorValues[3])
-    entity:SetColor(color, 100000, 100000, false, false)
+    entity:SetColor(
+        color,
+        100000,
+        100000,
+        false,
+        false
+    )
 end
 function ____exports.setEntityVelocities(self, entityVelocities, entities)
     if entities == nil then

package/dist/functions/flag.lua

@@ -10,7 +10,7 @@ end
 function ____exports.hasFlag(self, flags, ...)
     local flag = {...}
     for ____, f in ipairs(flag) do
-        if not ((flags & f) == f) then
+        if not (flags & f == f) then
             return false
         end
     end

package/dist/functions/gridEntity.lua

@@ -1,8 +1,8 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 require("lualib_bundle");
 local ____exports = {}
-local ____constants = require("constants")
-local GRID_ENTITY_XML_MAP = ____constants.GRID_ENTITY_XML_MAP
+local ____gridEntityXMLMap = require("maps.gridEntityXMLMap")
+local GRID_ENTITY_XML_MAP = ____gridEntityXMLMap.GRID_ENTITY_XML_MAP
 local ____rooms = require("functions.rooms")
 local roomUpdateSafe = ____rooms.roomUpdateSafe
 function ____exports.removeGridEntity(self, gridEntity, updateRoom)
@@ -36,13 +36,11 @@ function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntit
     end
     local gridEntityArray = GRID_ENTITY_XML_MAP:get(gridEntityXMLType)
     if gridEntityArray == nil then
-        error(
-            "Failed to find an entry in the grid entity map for XML entity type: " .. tostring(gridEntityXMLType)
-        )
+        error("Failed to find an entry in the grid entity map for XML entity type: " .. tostring(gridEntityXMLType))
     end
     local gridEntityType = gridEntityArray[1]
     local gridEntityVariant = gridEntityArray[2]
-    if ((gridEntityType == GridEntityType.GRID_SPIKES_ONOFF) or (gridEntityType == GridEntityType.GRID_PRESSURE_PLATE)) or (gridEntityType == GridEntityType.GRID_TELEPORTER) then
+    if gridEntityType == GridEntityType.GRID_SPIKES_ONOFF or gridEntityType == GridEntityType.GRID_PRESSURE_PLATE or gridEntityType == GridEntityType.GRID_TELEPORTER then
         gridEntityVariant = gridEntityXMLVariant
     end
     return {gridEntityType, gridEntityVariant}
@@ -82,7 +80,16 @@ function ____exports.getSurroundingGridEntities(self, gridEntity)
     local room = game:GetRoom()
     local gridWidth = room:GetGridWidth()
     local gridIndex = gridEntity:GetGridIndex()
-    local surroundingGridIndexes = {gridIndex - 1, gridIndex + 1, (gridIndex - gridWidth) - 1, gridIndex - gridWidth, (gridIndex - gridWidth) + 1, (gridIndex + gridWidth) - 1, gridIndex + gridWidth, (gridIndex + gridWidth) + 1}
+    local surroundingGridIndexes = {
+        gridIndex - 1,
+        gridIndex + 1,
+        gridIndex - gridWidth - 1,
+        gridIndex - gridWidth,
+        gridIndex - gridWidth + 1,
+        gridIndex + gridWidth - 1,
+        gridIndex + gridWidth,
+        gridIndex + gridWidth + 1
+    }
     local surroundingGridEntities = {}
     for ____, surroundingGridIndex in ipairs(surroundingGridIndexes) do
         local surroundingGridEntity = room:GetGridEntity(surroundingGridIndex)
@@ -99,9 +106,7 @@ function ____exports.isAllPressurePlatesPushed(self)
     if not hasPressurePlates then
         return true
     end
-    for ____, gridEntity in ipairs(
-        ____exports.getGridEntities(nil, GridEntityType.GRID_PRESSURE_PLATE)
-    ) do
+    for ____, gridEntity in ipairs(____exports.getGridEntities(nil, GridEntityType.GRID_PRESSURE_PLATE)) do
         local gridEntityDesc = gridEntity:GetSaveState()
         if gridEntityDesc.State ~= 3 then
             return false

package/dist/functions/input.lua

@@ -39,12 +39,10 @@ ControllerLiteral[ControllerLiteral.BUTTON_BACK] = "BUTTON_BACK"
 ControllerLiteral.BUTTON_START = 15
 ControllerLiteral[ControllerLiteral.BUTTON_START] = "BUTTON_START"
 function ____exports.controllerToString(self, controller)
-    for ____, ____value in ipairs(
-        __TS__ObjectEntries(ControllerLiteral)
-    ) do
-        local key
+    local controllerLiteralCode
+    local key
+    for ____, ____value in ipairs(__TS__ObjectEntries(ControllerLiteral)) do
         key = ____value[1]
-        local controllerLiteralCode
         controllerLiteralCode = ____value[2]
         do
             if type(key) ~= "string" then
@@ -55,7 +53,13 @@ function ____exports.controllerToString(self, controller)
                 goto __continue3
             end
             local controllerName = key
-            for ____, prefix in ipairs({"DPAD_", "BUTTON_", "BUMPER_", "TRIGGER_", "STICK_"}) do
+            for ____, prefix in ipairs({
+                "DPAD_",
+                "BUTTON_",
+                "BUMPER_",
+                "TRIGGER_",
+                "STICK_"
+            }) do
                 controllerName = __TS__StringReplace(controllerName, prefix, "")
             end
             return controllerName
@@ -92,9 +96,7 @@ function ____exports.isKeyboardPressed(self, key)
     return Input.IsButtonPressed(key, 0)
 end
 function ____exports.isMoveActionPressedOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(
-        MOVEMENT_ACTIONS:values()
-    ) do
+    for ____, buttonAction in __TS__Iterator(MOVEMENT_ACTIONS:values()) do
         if ____exports.isActionPressedOnAnyInput(nil, buttonAction) then
             return true
         end
@@ -102,9 +104,7 @@ function ____exports.isMoveActionPressedOnAnyInput(self)
     return false
 end
 function ____exports.isMoveActionTriggeredOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(
-        MOVEMENT_ACTIONS:values()
-    ) do
+    for ____, buttonAction in __TS__Iterator(MOVEMENT_ACTIONS:values()) do
         if ____exports.isActionTriggeredOnAnyInput(nil, buttonAction) then
             return true
         end
@@ -112,9 +112,7 @@ function ____exports.isMoveActionTriggeredOnAnyInput(self)
     return false
 end
 function ____exports.isShootActionPressedOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(
-        SHOOTING_ACTIONS:values()
-    ) do
+    for ____, buttonAction in __TS__Iterator(SHOOTING_ACTIONS:values()) do
         if ____exports.isActionPressedOnAnyInput(nil, buttonAction) then
             return true
         end
@@ -122,9 +120,7 @@ function ____exports.isShootActionPressedOnAnyInput(self)
     return false
 end
 function ____exports.isShootActionTriggeredOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(
-        SHOOTING_ACTIONS:values()
-    ) do
+    for ____, buttonAction in __TS__Iterator(SHOOTING_ACTIONS:values()) do
         if ____exports.isActionTriggeredOnAnyInput(nil, buttonAction) then
             return true
         end

package/dist/functions/jsonRoom.lua

@@ -30,9 +30,7 @@ function getJSONRoomWithChosenWeight(self, jsonRooms, chosenWeight)
         end
         chosenWeight = chosenWeight - roomWeight
     end
-    error(
-        "Failed to get a room with chosen weight: " .. tostring(chosenWeight)
-    )
+    error("Failed to get a room with chosen weight: " .. tostring(chosenWeight))
     return jsonRooms[1]
 end
 function ____exports.getJSONRoomOfVariant(self, jsonRooms, variant)
@@ -65,15 +63,11 @@ function ____exports.getRandomJSONRoom(self, jsonRooms, seed, verbose)
     end
     local totalWeight = getTotalWeightOfJSONRooms(nil, jsonRooms)
     if verbose then
-        log(
-            "Total weight of the JSON rooms provided: " .. tostring(totalWeight)
-        )
+        log("Total weight of the JSON rooms provided: " .. tostring(totalWeight))
     end
     local chosenWeight = getRandomFloat(nil, 0, totalWeight, seed)
     if verbose then
-        log(
-            "Randomly chose weight: " .. tostring(chosenWeight)
-        )
+        log("Randomly chose weight: " .. tostring(chosenWeight))
     end
     return getJSONRoomWithChosenWeight(nil, jsonRooms, chosenWeight)
 end

package/dist/functions/language.lua

@@ -1,6 +1,14 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-local LANGUAGE_NAMES = {en = "English", jp = "Japanese", kr = "Korean", zh = "Chinese (Simple)", ru = "Russian", de = "German", es = "Spanish"}
+local LANGUAGE_NAMES = {
+    en = "English",
+    jp = "Japanese",
+    kr = "Korean",
+    zh = "Chinese (Simple)",
+    ru = "Russian",
+    de = "German",
+    es = "Spanish"
+}
 function ____exports.getLanguageName(self)
     local languageAbbreviation = Options.Language
     return LANGUAGE_NAMES[languageAbbreviation]

package/dist/functions/log.lua

@@ -16,9 +16,7 @@ function ____exports.getDebugPrependString(self, msg, numParentFunctions)
         end
     end
     if getParentFunctionDescription ~= nil then
-        return (tostring(
-            getParentFunctionDescription(numParentFunctions + 1)
-        ) .. " - ") .. msg
+        return (tostring(getParentFunctionDescription(numParentFunctions + 1)) .. " - ") .. msg
     end
     return msg
 end
@@ -36,9 +34,7 @@ function ____exports.logAllFlags(flags, flagEnum, description)
     ____exports.log(("Logging all " .. description) .. "flags:")
     for key, value in pairs(flagEnum) do
         if hasFlag(nil, flags, value) then
-            ____exports.log(
-                "- Has flag: " .. tostring(key)
-            )
+            ____exports.log("- Has flag: " .. tostring(key))
         end
     end
 end
@@ -51,12 +47,10 @@ end
 function ____exports.logAllGameStateFlags()
     local game = Game()
     ____exports.log("Logging all game state flags:")
-    for ____, ____value in ipairs(
-        __TS__ObjectEntries(GameStateFlag)
-    ) do
-        local key
+    local value
+    local key
+    for ____, ____value in ipairs(__TS__ObjectEntries(GameStateFlag)) do
         key = ____value[1]
-        local value
         value = ____value[2]
         local gameStateFlag = value
         local flagValue = game:GetStateFlag(gameStateFlag)
@@ -79,62 +73,40 @@ function ____exports.logArray(array)
     ____exports.log("Array: " .. arrayString)
 end
 function ____exports.logColor(color)
-    ____exports.log(
-        (((((((((((("Color: R" .. tostring(color.R)) .. ", G") .. tostring(color.G)) .. ", B") .. tostring(color.B)) .. ", A") .. tostring(color.A)) .. ", RO") .. tostring(color.RO)) .. ", BO") .. tostring(color.BO)) .. ", GO") .. tostring(color.GO)
-    )
+    ____exports.log((((((((((((("Color: R" .. tostring(color.R)) .. ", G") .. tostring(color.G)) .. ", B") .. tostring(color.B)) .. ", A") .. tostring(color.A)) .. ", RO") .. tostring(color.RO)) .. ", BO") .. tostring(color.BO)) .. ", GO") .. tostring(color.GO))
 end
 function ____exports.logEntity(entity)
-    ____exports.log(
-        (((("Entity: " .. tostring(entity.Type)) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType)
-    )
+    ____exports.log((((("Entity: " .. tostring(entity.Type)) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType))
 end
 function ____exports.logKColor(kColor)
-    ____exports.log(
-        (((((("Color: R" .. tostring(kColor.Red)) .. ", G") .. tostring(kColor.Green)) .. ", B") .. tostring(kColor.Blue)) .. ", A") .. tostring(kColor.Alpha)
-    )
+    ____exports.log((((((("Color: R" .. tostring(kColor.Red)) .. ", G") .. tostring(kColor.Green)) .. ", B") .. tostring(kColor.Blue)) .. ", A") .. tostring(kColor.Alpha))
 end
 function ____exports.logMap(map)
     ____exports.log("Printing out a TSTL Map:")
-    for ____, ____value in __TS__Iterator(
-        map:entries()
-    ) do
-        local key
+    local value
+    local key
+    for ____, ____value in __TS__Iterator(map:entries()) do
         key = ____value[1]
-        local value
         value = ____value[2]
-        ____exports.log(
-            (("  Key: " .. tostring(key)) .. ", Value: ") .. tostring(value)
-        )
+        ____exports.log((("  Key: " .. tostring(key)) .. ", Value: ") .. tostring(value))
     end
-    ____exports.log(
-        "The size of the map was: " .. tostring(map.size)
-    )
+    ____exports.log("The size of the map was: " .. tostring(map.size))
 end
 function ____exports.logTable(____table)
     ____exports.log("Printing out a Lua table:")
     for key, value in pairs(____table) do
-        ____exports.log(
-            (("  Key: " .. tostring(key)) .. ", Value: ") .. tostring(value)
-        )
+        ____exports.log((("  Key: " .. tostring(key)) .. ", Value: ") .. tostring(value))
     end
 end
 function ____exports.logSet(set)
     ____exports.log("Printing out a TSTL Set:")
-    for ____, value in __TS__Iterator(
-        set:values()
-    ) do
-        ____exports.log(
-            "  Value: " .. tostring(value)
-        )
+    for ____, value in __TS__Iterator(set:values()) do
+        ____exports.log("  Value: " .. tostring(value))
     end
-    ____exports.log(
-        "The size of the set was: " .. tostring(set.size)
-    )
+    ____exports.log("The size of the set was: " .. tostring(set.size))
 end
 function ____exports.logVector(vector)
-    ____exports.log(
-        ((("Vector: (" .. tostring(vector.X)) .. ", ") .. tostring(vector.Y)) .. ")"
-    )
+    ____exports.log(((("Vector: (" .. tostring(vector.X)) .. ", ") .. tostring(vector.Y)) .. ")")
 end
 function ____exports.setLogFunctionsGlobal(self)
     local globals = _G

package/dist/functions/math.lua

@@ -13,25 +13,25 @@ function getCircleInitialPosition(self, direction, radius)
                 return Vector.Zero
             end
         end
-        ____cond6 = ____cond6 or (____switch6 == Direction.LEFT)
+        ____cond6 = ____cond6 or ____switch6 == Direction.LEFT
         if ____cond6 then
             do
                 return Vector(-radius, 0)
             end
         end
-        ____cond6 = ____cond6 or (____switch6 == Direction.UP)
+        ____cond6 = ____cond6 or ____switch6 == Direction.UP
         if ____cond6 then
             do
                 return Vector(0, -radius)
             end
         end
-        ____cond6 = ____cond6 or (____switch6 == Direction.RIGHT)
+        ____cond6 = ____cond6 or ____switch6 == Direction.RIGHT
         if ____cond6 then
             do
                 return Vector(radius, 0)
             end
         end
-        ____cond6 = ____cond6 or (____switch6 == Direction.DOWN)
+        ____cond6 = ____cond6 or ____switch6 == Direction.DOWN
         if ____cond6 then
             do
                 return Vector(0, radius)
@@ -47,7 +47,7 @@ function getCircleInitialPosition(self, direction, radius)
 end
 function ____exports.getAngleDifference(self, angle1, angle2)
     local subtractedAngle = angle1 - angle2
-    return ((subtractedAngle + 180) % 360) - 180
+    return (subtractedAngle + 180) % 360 - 180
 end
 function ____exports.getCircleDiscretizedPoints(self, centerPos, radius, numPoints, xMultiplier, yMultiplier, initialDirection)
     if xMultiplier == nil then
@@ -64,7 +64,7 @@ function ____exports.getCircleDiscretizedPoints(self, centerPos, radius, numPoin
     do
         local i = 0
         while i < numPoints do
-            local rotatedPosition = initialPosition:Rotated((i * 360) / numPoints)
+            local rotatedPosition = initialPosition:Rotated(i * 360 / numPoints)
             rotatedPosition.X = rotatedPosition.X * xMultiplier
             rotatedPosition.Y = rotatedPosition.Y * yMultiplier
             local positionFromCenter = centerPos + rotatedPosition
@@ -75,28 +75,26 @@ function ____exports.getCircleDiscretizedPoints(self, centerPos, radius, numPoin
     return positions
 end
 function ____exports.isEven(self, num)
-    return (num & 1) == 0
+    return num & 1 == 0
 end
 function ____exports.isOdd(self, num)
-    return (num & 1) == 1
+    return num & 1 == 1
 end
 function ____exports.lerp(self, a, b, pos)
-    return a + ((b - a) * pos)
+    return a + (b - a) * pos
 end
 function ____exports.lerpAngleDegrees(self, aStart, aEnd, percent)
-    return aStart + (____exports.getAngleDifference(nil, aStart, aEnd) * percent)
+    return aStart + ____exports.getAngleDifference(nil, aStart, aEnd) * percent
 end
 function ____exports.round(self, num, numDecimalPlaces)
     if numDecimalPlaces == nil then
         numDecimalPlaces = 0
     end
-    local roundedNum = tonumber(
-        string.format(
-            ("%." .. tostring(numDecimalPlaces)) .. "f",
-            num
-        )
-    )
-    return ((roundedNum == nil) and 0) or roundedNum
+    local roundedNum = tonumber(string.format(
+        ("%." .. tostring(numDecimalPlaces)) .. "f",
+        num
+    ))
+    return roundedNum == nil and 0 or roundedNum
 end
 function ____exports.tanh(self, x)
     return (math.exp(x) - math.exp(-x)) / (math.exp(x) + math.exp(-x))

package/dist/functions/npc.lua

@@ -8,9 +8,7 @@ local ____entity = require("functions.entity")
 local getEntities = ____entity.getEntities
 function ____exports.getBosses(self)
     local bosses = {}
-    for ____, npc in ipairs(
-        ____exports.getNPCs(nil)
-    ) do
+    for ____, npc in ipairs(____exports.getNPCs(nil)) do
         if npc:IsBoss() then
             __TS__ArrayPush(bosses, npc)
         end
@@ -21,7 +19,13 @@ function ____exports.getNPCs(self, matchingEntityType, matchingVariant, matching
     if ignoreFriendly == nil then
         ignoreFriendly = false
     end
-    local entities = getEntities(nil, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
+    local entities = getEntities(
+        nil,
+        matchingEntityType,
+        matchingVariant,
+        matchingSubType,
+        ignoreFriendly
+    )
     local npcs = {}
     for ____, entity in ipairs(entities) do
         local npc = entity:ToNPC()
@@ -49,10 +53,10 @@ function ____exports.isAliveExceptionNPC(self, npc)
     return false
 end
 function ____exports.isDyingEggyWithNoSpidersLeft(self, npc)
-    return (npc.State == NpcState.STATE_SUICIDE) and (npc.StateFrame >= EGGY_STATE_FRAME_OF_FINAL_SPIDER)
+    return npc.State == NpcState.STATE_SUICIDE and npc.StateFrame >= EGGY_STATE_FRAME_OF_FINAL_SPIDER
 end
 function ____exports.isRaglingDeathPatch(self, npc)
-    return ((npc.Type == EntityType.ENTITY_RAGLING) and (npc.Variant == 1)) and (npc.State == NpcState.STATE_SPECIAL)
+    return npc.Type == EntityType.ENTITY_RAGLING and npc.Variant == 1 and npc.State == NpcState.STATE_SPECIAL
 end
 NON_ALIVE_NPCS_TYPE_VARIANT = __TS__New(
     Set,
@@ -70,16 +74,12 @@ NON_ALIVE_NPCS_TYPE_VARIANT = __TS__New(
 )
 NON_ALIVE_NPCS_TYPE_VARIANT_SUBTYPE = __TS__New(
     Set,
-    {
-        (((tostring(EntityType.ENTITY_CHARGER) .. ".") .. 0) .. ".") .. 1
-    }
+    {(((tostring(EntityType.ENTITY_CHARGER) .. ".") .. 0) .. ".") .. 1}
 )
 function ____exports.getAliveBosses(self)
     local aliveBosses = {}
-    for ____, boss in ipairs(
-        ____exports.getBosses(nil)
-    ) do
-        if (not boss:IsDead()) and (not ____exports.isAliveExceptionNPC(nil, boss)) then
+    for ____, boss in ipairs(____exports.getBosses(nil)) do
+        if not boss:IsDead() and not ____exports.isAliveExceptionNPC(nil, boss) then
             __TS__ArrayPush(aliveBosses, boss)
         end
     end
@@ -87,10 +87,8 @@ function ____exports.getAliveBosses(self)
 end
 function ____exports.getAliveNPCs(self)
     local aliveNPCs = {}
-    for ____, npc in ipairs(
-        ____exports.getNPCs(nil)
-    ) do
-        if (not npc:IsDead()) and (not ____exports.isAliveExceptionNPC(nil, npc)) then
+    for ____, npc in ipairs(____exports.getNPCs(nil)) do
+        if not npc:IsDead() and not ____exports.isAliveExceptionNPC(nil, npc) then
             __TS__ArrayPush(aliveNPCs, npc)
         end
     end

package/dist/functions/pickups.d.ts

@@ -1,4 +1,9 @@
 /// <reference types="isaac-typescript-definitions" />
-/** Has an equal chance of returning any value in the `HeartSubType` enum. */
-export declare function getRandomHeartSubType(seed?: number): HeartSubType;
+/**
+ * Has as an equal chance of returning any value in the `HeartSubType` enum. Useful for spawning a random type of heart.
+ *
+ * @param seed Optional. The seed with which to select the random sub-type. `Random()` by default.
+ * @param exceptions Optional. An array of sub-types to not select.
+ */
+export declare function getRandomHeartSubType(seed?: number, exceptions?: HeartSubType[]): HeartSubType;
 export declare function isChest(pickup: EntityPickup): boolean;

package/dist/functions/pickups.lua

@@ -5,14 +5,30 @@ local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
 local ____util = require("functions.util")
 local getEnumValues = ____util.getEnumValues
-function ____exports.getRandomHeartSubType(self, seed)
+function ____exports.getRandomHeartSubType(self, seed, exceptions)
     if seed == nil then
         seed = Random()
     end
+    if exceptions == nil then
+        exceptions = {}
+    end
     local heartSubTypes = getEnumValues(nil, HeartSubType)
-    return getRandomArrayElement(nil, heartSubTypes, seed)
+    return getRandomArrayElement(nil, heartSubTypes, seed, exceptions)
 end
-local CHEST_PICKUP_VARIANTS = __TS__New(Set, {PickupVariant.PICKUP_CHEST, PickupVariant.PICKUP_BOMBCHEST, PickupVariant.PICKUP_SPIKEDCHEST, PickupVariant.PICKUP_ETERNALCHEST, PickupVariant.PICKUP_MIMICCHEST, PickupVariant.PICKUP_OLDCHEST, PickupVariant.PICKUP_WOODENCHEST, PickupVariant.PICKUP_MEGACHEST, PickupVariant.PICKUP_HAUNTEDCHEST, PickupVariant.PICKUP_LOCKEDCHEST, PickupVariant.PICKUP_REDCHEST, PickupVariant.PICKUP_MOMSCHEST})
+local CHEST_PICKUP_VARIANTS = __TS__New(Set, {
+    PickupVariant.PICKUP_CHEST,
+    PickupVariant.PICKUP_BOMBCHEST,
+    PickupVariant.PICKUP_SPIKEDCHEST,
+    PickupVariant.PICKUP_ETERNALCHEST,
+    PickupVariant.PICKUP_MIMICCHEST,
+    PickupVariant.PICKUP_OLDCHEST,
+    PickupVariant.PICKUP_WOODENCHEST,
+    PickupVariant.PICKUP_MEGACHEST,
+    PickupVariant.PICKUP_HAUNTEDCHEST,
+    PickupVariant.PICKUP_LOCKEDCHEST,
+    PickupVariant.PICKUP_REDCHEST,
+    PickupVariant.PICKUP_MOMSCHEST
+})
 function ____exports.isChest(self, pickup)
     return CHEST_PICKUP_VARIANTS:has(pickup.Variant)
 end