isaacscript-common 2.3.0 → 2.3.1

package/functions/rooms.lua

@@ -0,0 +1,382 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__Spread = ____lualib.__TS__Spread
+local Map = ____lualib.Map
+local __TS__StringIncludes = ____lualib.__TS__StringIncludes
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local AngelRoomSubType = ____isaac_2Dtypescript_2Ddefinitions.AngelRoomSubType
+local Dimension = ____isaac_2Dtypescript_2Ddefinitions.Dimension
+local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
+local DoorSlot = ____isaac_2Dtypescript_2Ddefinitions.DoorSlot
+local DungeonSubType = ____isaac_2Dtypescript_2Ddefinitions.DungeonSubType
+local GridRoom = ____isaac_2Dtypescript_2Ddefinitions.GridRoom
+local HomeRoomSubType = ____isaac_2Dtypescript_2Ddefinitions.HomeRoomSubType
+local RoomDescriptorFlag = ____isaac_2Dtypescript_2Ddefinitions.RoomDescriptorFlag
+local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local RoomTransitionAnim = ____isaac_2Dtypescript_2Ddefinitions.RoomTransitionAnim
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
+local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
+local ____constants = require("constants")
+local LEVEL_GRID_ROW_WIDTH = ____constants.LEVEL_GRID_ROW_WIDTH
+local MAX_LEVEL_GRID_INDEX = ____constants.MAX_LEVEL_GRID_INDEX
+local NUM_DIMENSIONS = ____constants.NUM_DIMENSIONS
+local ____roomShapeToDoorSlotsToGridIndexDelta = require("objects.roomShapeToDoorSlotsToGridIndexDelta")
+local ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA = ____roomShapeToDoorSlotsToGridIndexDelta.ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA
+local ____roomTypeNames = require("objects.roomTypeNames")
+local DEFAULT_ROOM_TYPE_NAME = ____roomTypeNames.DEFAULT_ROOM_TYPE_NAME
+local ROOM_TYPE_NAMES = ____roomTypeNames.ROOM_TYPE_NAMES
+local ____mineShaftRoomSubTypesSet = require("sets.mineShaftRoomSubTypesSet")
+local MINE_SHAFT_ROOM_SUB_TYPE_SET = ____mineShaftRoomSubTypesSet.MINE_SHAFT_ROOM_SUB_TYPE_SET
+local ____doors = require("functions.doors")
+local closeAllDoors = ____doors.closeAllDoors
+local getDoors = ____doors.getDoors
+local isHiddenSecretRoomDoor = ____doors.isHiddenSecretRoomDoor
+local openDoorFast = ____doors.openDoorFast
+local ____entity = require("functions.entity")
+local getEntities = ____entity.getEntities
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____positionVelocity = require("functions.positionVelocity")
+local getEntityPositions = ____positionVelocity.getEntityPositions
+local getEntityVelocities = ____positionVelocity.getEntityVelocities
+local setEntityPositions = ____positionVelocity.setEntityPositions
+local setEntityVelocities = ____positionVelocity.setEntityVelocities
+local ____roomData = require("functions.roomData")
+local getCurrentRoomDescriptorReadOnly = ____roomData.getCurrentRoomDescriptorReadOnly
+local getRoomAllowedDoors = ____roomData.getRoomAllowedDoors
+local getRoomData = ____roomData.getRoomData
+local getRoomDescriptor = ____roomData.getRoomDescriptor
+local getRoomGridIndex = ____roomData.getRoomGridIndex
+local getRoomName = ____roomData.getRoomName
+local getRoomShape = ____roomData.getRoomShape
+local getRoomStageID = ____roomData.getRoomStageID
+local getRoomSubType = ____roomData.getRoomSubType
+local ____roomShape = require("functions.roomShape")
+local getGridIndexDelta = ____roomShape.getGridIndexDelta
+local ____utils = require("functions.utils")
+local erange = ____utils.erange
+local irange = ____utils.irange
+function ____exports.getRoomShapeNeighborGridIndexDeltas(self, roomShape)
+    return {__TS__Spread(ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA[roomShape]:values())}
+end
+function ____exports.getRooms(self, includeExtraDimensionalRooms)
+    if includeExtraDimensionalRooms == nil then
+        includeExtraDimensionalRooms = false
+    end
+    local level = game:GetLevel()
+    local roomList = level:GetRooms()
+    local roomsMap = __TS__New(Map)
+    if includeExtraDimensionalRooms then
+        do
+            local i = 0
+            while i < roomList.Size do
+                local roomDescriptor = roomList:Get(i)
+                if roomDescriptor ~= nil and roomDescriptor.Data ~= nil then
+                    roomsMap:set(roomDescriptor.ListIndex, roomDescriptor)
+                end
+                i = i + 1
+            end
+        end
+    else
+        for ____, roomGridIndex in ipairs(irange(nil, MAX_LEVEL_GRID_INDEX)) do
+            local roomDescriptor = level:GetRoomByIdx(roomGridIndex)
+            if roomDescriptor.Data ~= nil then
+                roomsMap:set(roomDescriptor.ListIndex, roomDescriptor)
+            end
+        end
+    end
+    return {__TS__Spread(roomsMap:values())}
+end
+function ____exports.inDeathCertificateArea(self)
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return roomStageID == StageID.HOME and (roomSubType == HomeRoomSubType.DEATH_CERTIFICATE_ENTRANCE or roomSubType == HomeRoomSubType.DEATH_CERTIFICATE_ITEMS)
+end
+function ____exports.roomExists(self, roomGridIndex)
+    local roomData = getRoomData(nil, roomGridIndex)
+    return roomData ~= nil
+end
+function ____exports.changeRoom(self, roomGridIndex)
+    local level = game:GetLevel()
+    local roomData = getRoomData(nil, roomGridIndex)
+    if roomData == nil then
+        error(("Failed to change the room to grid index " .. tostring(roomGridIndex)) .. " because that room does not exist.")
+    end
+    level.LeaveDoor = DoorSlot.NO_DOOR_SLOT
+    game:ChangeRoom(roomGridIndex)
+end
+function ____exports.getAllDimensions(self)
+    return erange(nil, NUM_DIMENSIONS)
+end
+function ____exports.getAllRoomGridIndexes(self)
+    local rooms = ____exports.getRooms(nil)
+    return __TS__ArrayMap(
+        rooms,
+        function(____, roomDescriptor) return roomDescriptor.SafeGridIndex end
+    )
+end
+function ____exports.getCurrentDimension(self)
+    local level = game:GetLevel()
+    if ____exports.inDeathCertificateArea(nil) then
+        return Dimension.DEATH_CERTIFICATE
+    end
+    local startingRoomGridIndex = level:GetStartingRoomIndex()
+    local startingRoomDescription = level:GetRoomByIdx(startingRoomGridIndex, Dimension.CURRENT)
+    local startingRoomHash = GetPtrHash(startingRoomDescription)
+    for ____, dimension in ipairs(____exports.getAllDimensions(nil)) do
+        local dimensionRoomDescription = level:GetRoomByIdx(startingRoomGridIndex, dimension)
+        local dimensionRoomHash = GetPtrHash(dimensionRoomDescription)
+        if dimensionRoomHash == startingRoomHash then
+            return dimension
+        end
+    end
+    return error("Failed to get the current dimension using the starting room index of: " .. tostring(startingRoomGridIndex))
+end
+function ____exports.getNumRooms(self)
+    local rooms = ____exports.getRooms(nil)
+    return #rooms
+end
+function ____exports.getRoomGridIndexesForType(self, ...)
+    local roomTypesSet = __TS__New(Set, {...})
+    local rooms = ____exports.getRooms(nil)
+    local matchingRooms = __TS__ArrayFilter(
+        rooms,
+        function(____, roomDescriptor) return roomDescriptor.Data ~= nil and roomTypesSet:has(roomDescriptor.Data.Type) end
+    )
+    return __TS__ArrayMap(
+        matchingRooms,
+        function(____, roomDescriptor) return roomDescriptor.SafeGridIndex end
+    )
+end
+function ____exports.getRoomItemPoolType(self)
+    local itemPool = game:GetItemPool()
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomSeed = room:GetSpawnSeed()
+    return itemPool:GetPoolForRoom(roomType, roomSeed)
+end
+function ____exports.getRoomNeighbors(self, roomGridIndex)
+    local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
+    if roomDescriptor.SafeGridIndex < 0 or roomDescriptor.SafeGridIndex > MAX_LEVEL_GRID_INDEX then
+        return {}
+    end
+    local roomData = roomDescriptor.Data
+    if roomData == nil then
+        return {}
+    end
+    local roomShape = roomData.Shape
+    local gridIndexDeltas = ____exports.getRoomShapeNeighborGridIndexDeltas(nil, roomShape)
+    local gridIndexes = __TS__ArrayMap(
+        gridIndexDeltas,
+        function(____, gridIndexDelta) return roomDescriptor.SafeGridIndex + gridIndexDelta end
+    )
+    return __TS__ArrayFilter(
+        gridIndexes,
+        function(____, gridIndex) return ____exports.roomExists(nil, gridIndex) end
+    )
+end
+function ____exports.getRoomTypeName(self, roomType)
+    local roomTypeName = ROOM_TYPE_NAMES[roomType]
+    return roomTypeName == nil and DEFAULT_ROOM_TYPE_NAME or roomTypeName
+end
+function ____exports.getRoomsOfDimension(self, dimension)
+    local level = game:GetLevel()
+    local roomsMap = __TS__New(Map)
+    for ____, roomGridIndex in ipairs(irange(nil, MAX_LEVEL_GRID_INDEX)) do
+        local roomDescriptor = level:GetRoomByIdx(roomGridIndex, dimension)
+        if roomDescriptor.Data ~= nil then
+            roomsMap:set(roomDescriptor.ListIndex, roomDescriptor)
+        end
+    end
+    return {__TS__Spread(roomsMap:values())}
+end
+function ____exports.in2x1Room(self)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    return roomShape == RoomShape.SHAPE_1x2 or roomShape == RoomShape.SHAPE_2x1
+end
+function ____exports.inAngelShop(self)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.ANGEL and roomSubType == AngelRoomSubType.SHOP
+end
+function ____exports.inBeastRoom(self)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.DUNGEON and roomSubType == DungeonSubType.BEAST_ROOM
+end
+function ____exports.inBossRoomOf(self, bossID)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.BOSS and roomStageID == StageID.SPECIAL_ROOMS and roomSubType == bossID
+end
+function ____exports.inCrawlspace(self)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.DUNGEON and roomSubType == DungeonSubType.NORMAL
+end
+function ____exports.inDevilsCrownTreasureRoom(self)
+    local roomDescriptor = getCurrentRoomDescriptorReadOnly(nil)
+    return hasFlag(nil, roomDescriptor.Flags, RoomDescriptorFlag.DEVIL_TREASURE)
+end
+function ____exports.inDimension(self, dimension)
+    return dimension == ____exports.getCurrentDimension(nil)
+end
+function ____exports.inDoubleTrouble(self)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomName = getRoomName(nil)
+    return roomType == RoomType.BOSS and __TS__StringIncludes(roomName, "Double Trouble")
+end
+function ____exports.inGenesisRoom(self)
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == GridRoom.GENESIS
+end
+function ____exports.inLRoom(self)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    return roomShape == RoomShape.LTL or roomShape == RoomShape.LTR or roomShape == RoomShape.LBL or roomShape == RoomShape.LBR
+end
+function ____exports.inMegaSatanRoom(self)
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == GridRoom.MEGA_SATAN
+end
+function ____exports.inMineShaft(self)
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return (roomStageID == StageID.MINES or roomStageID == StageID.ASHPIT) and MINE_SHAFT_ROOM_SUB_TYPE_SET:has(roomSubType)
+end
+function ____exports.inMinibossRoomOf(self, minibossID)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.MINI_BOSS and roomStageID == StageID.SPECIAL_ROOMS and roomSubType == minibossID
+end
+function ____exports.inSecretShop(self)
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == GridRoom.SECRET_SHOP
+end
+function ____exports.inStartingRoom(self)
+    local level = game:GetLevel()
+    local startingRoomGridIndex = level:GetStartingRoomIndex()
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == startingRoomGridIndex and ____exports.inDimension(nil, Dimension.MAIN)
+end
+function ____exports.isAllRoomsClear(self, onlyCheckRoomTypes)
+    local ____temp_0
+    if onlyCheckRoomTypes == nil then
+        ____temp_0 = nil
+    else
+        ____temp_0 = __TS__New(Set, onlyCheckRoomTypes)
+    end
+    local roomTypeWhitelist = ____temp_0
+    local rooms = ____exports.getRooms(nil)
+    local matchingRooms = roomTypeWhitelist == nil and rooms or __TS__ArrayFilter(
+        rooms,
+        function(____, roomDescriptor) return roomDescriptor.Data ~= nil and roomTypeWhitelist:has(roomDescriptor.Data.Type) end
+    )
+    return __TS__ArrayEvery(
+        matchingRooms,
+        function(____, roomDescriptor) return roomDescriptor.Clear end
+    )
+end
+function ____exports.isDoorSlotValidAtGridIndex(self, doorSlot, roomGridIndex)
+    local allowedDoors = getRoomAllowedDoors(nil, roomGridIndex)
+    return allowedDoors:has(doorSlot)
+end
+function ____exports.isDoorSlotValidAtGridIndexForRedRoom(self, doorSlot, roomGridIndex)
+    local doorSlotValidAtGridIndex = ____exports.isDoorSlotValidAtGridIndex(nil, doorSlot, roomGridIndex)
+    if not doorSlotValidAtGridIndex then
+        return false
+    end
+    local roomShape = getRoomShape(nil, roomGridIndex)
+    if roomShape == nil then
+        return false
+    end
+    local delta = getGridIndexDelta(nil, roomShape, doorSlot)
+    if delta == nil then
+        return false
+    end
+    local redRoomGridIndex = roomGridIndex + delta
+    return not ____exports.roomExists(nil, redRoomGridIndex) and redRoomGridIndex >= 0 and redRoomGridIndex <= MAX_LEVEL_GRID_INDEX
+end
+function ____exports.isRedKeyRoom(self, roomGridIndex)
+    local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
+    return hasFlag(nil, roomDescriptor.Flags, RoomDescriptorFlag.RED_ROOM)
+end
+function ____exports.isRoomInsideMap(self, roomGridIndex)
+    if roomGridIndex == nil then
+        roomGridIndex = getRoomGridIndex(nil)
+    end
+    return roomGridIndex >= 0
+end
+function ____exports.roomGridIndexToXY(self, roomGridIndex)
+    local x = roomGridIndex % LEVEL_GRID_ROW_WIDTH
+    local y = math.floor(roomGridIndex / LEVEL_GRID_ROW_WIDTH)
+    return {x, y}
+end
+function ____exports.roomUpdateSafe(self)
+    local room = game:GetRoom()
+    local entities = getEntities(nil)
+    local entityPositions = getEntityPositions(nil, entities)
+    local entityVelocities = getEntityVelocities(nil, entities)
+    room:Update()
+    setEntityPositions(nil, entityPositions, entities)
+    setEntityVelocities(nil, entityVelocities, entities)
+end
+function ____exports.setRoomCleared(self)
+    local room = game:GetRoom()
+    local roomClear = room:IsClear()
+    if roomClear then
+        return
+    end
+    room:SetClear(true)
+    for ____, door in ipairs(getDoors(nil)) do
+        do
+            if isHiddenSecretRoomDoor(nil, door) then
+                goto __continue68
+            end
+            openDoorFast(nil, door)
+            door.ExtraVisible = false
+        end
+        ::__continue68::
+    end
+    sfxManager:Stop(SoundEffect.DOOR_HEAVY_OPEN)
+    game:ShakeScreen(0)
+end
+function ____exports.setRoomUncleared(self)
+    local room = game:GetRoom()
+    room:SetClear(false)
+    closeAllDoors(nil)
+end
+function ____exports.teleport(self, roomGridIndex, direction, roomTransitionAnim)
+    if direction == nil then
+        direction = Direction.NO_DIRECTION
+    end
+    if roomTransitionAnim == nil then
+        roomTransitionAnim = RoomTransitionAnim.TELEPORT
+    end
+    local level = game:GetLevel()
+    local roomData = getRoomData(nil, roomGridIndex)
+    if roomData == nil then
+        error(("Failed to change the room to grid index " .. tostring(roomGridIndex)) .. " because that room does not exist.")
+    end
+    level.LeaveDoor = DoorSlot.NO_DOOR_SLOT
+    game:StartRoomTransition(roomGridIndex, direction, roomTransitionAnim)
+end
+return ____exports

package/functions/run.d.ts

@@ -0,0 +1,12 @@
+import { PlayerType } from "isaac-typescript-definitions";
+/**
+ * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
+ * pressing tab on the character selection screen). When the player resets the game on a set seed,
+ * the game will not switch to a different seed.
+ */
+export declare function onSetSeed(): boolean;
+/**
+ * Helper function to restart the game using the console command of "restart". You can optionally
+ * specify a `PlayerType` to restart the game as that character.
+ */
+export declare function restart(character?: PlayerType): void;

package/functions/run.lua

@@ -0,0 +1,28 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____constantsFirstLast = require("constantsFirstLast")
+local FIRST_CHARACTER = ____constantsFirstLast.FIRST_CHARACTER
+local ____log = require("functions.log")
+local log = ____log.log
+function ____exports.onSetSeed(self)
+    local seeds = game:GetSeeds()
+    local customRun = seeds:IsCustomRun()
+    local challenge = Isaac.GetChallenge()
+    return challenge == Challenge.NULL and customRun
+end
+function ____exports.restart(self, character)
+    if character == nil then
+        log("Restarting.")
+        Isaac.ExecuteCommand("restart")
+        return
+    end
+    if character < FIRST_CHARACTER then
+        error(("Restarting as a character of " .. tostring(character)) .. " would crash the game.")
+    end
+    log("Restarting as character: " .. tostring(character))
+    Isaac.ExecuteCommand("restart " .. tostring(character))
+end
+return ____exports

package/functions/seeds.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="isaac-typescript-definitions" />
+/** Alias for the `Seeds.GetStartSeedString` method. */
+export declare function getStartSeedString(): string;
+/**
+ * Helper function to get the next seed value.
+ *
+ * This function is useful when you are working with seed values directly over RNG objects.
+ */
+export declare function nextSeed(seed: Seed): Seed;

package/functions/seeds.lua

@@ -0,0 +1,15 @@
+local ____exports = {}
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
+function ____exports.getStartSeedString(self)
+    local seeds = game:GetSeeds()
+    return seeds:GetStartSeedString()
+end
+function ____exports.nextSeed(self, seed)
+    local rng = newRNG(nil, seed)
+    rng:Next()
+    return rng:GetSeed()
+end
+return ____exports

package/functions/serialization.d.ts

@@ -0,0 +1,11 @@
+import { SerializationType } from "../enums/SerializationType";
+import { SerializedIsaacAPIClass } from "../types/private/SerializedIsaacAPIClass";
+export declare function copyIsaacAPIClass(isaacAPIClass: unknown, serializationType: SerializationType): unknown;
+/**
+ * Deserialization is a special case, so we make a dedicated function for this.
+ *
+ * There is no need for a corresponding "serializeIsaacAPIClass" function because the
+ * "copyIsaacAPIClass" function can handles all serialization types.
+ */
+export declare function deserializeIsaacAPIClass(serializedIsaacAPIClass: SerializedIsaacAPIClass): unknown;
+export declare function isSerializedIsaacAPIClass(object: unknown): object is SerializedIsaacAPIClass;

package/functions/serialization.lua

@@ -0,0 +1,65 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
+local __TS__ObjectValues = ____lualib.__TS__ObjectValues
+local __TS__ArraySome = ____lualib.__TS__ArraySome
+local ____exports = {}
+local getSerializedTableType
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____isaacAPIClassTypeToBrand = require("objects.isaacAPIClassTypeToBrand")
+local ISAAC_API_CLASS_TYPE_TO_BRAND = ____isaacAPIClassTypeToBrand.ISAAC_API_CLASS_TYPE_TO_BRAND
+local ____isaacAPIClassTypeToCopyFunction = require("objects.isaacAPIClassTypeToCopyFunction")
+local ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION = ____isaacAPIClassTypeToCopyFunction.ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION
+local ____serializedIsaacAPIClassTypeToIdentityFunction = require("objects.serializedIsaacAPIClassTypeToIdentityFunction")
+local SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION = ____serializedIsaacAPIClassTypeToIdentityFunction.SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION
+local ____isaacAPIClass = require("functions.isaacAPIClass")
+local getIsaacAPIClassType = ____isaacAPIClass.getIsaacAPIClassType
+function getSerializedTableType(self, serializedIsaacAPIClass)
+    for ____, ____value in ipairs(__TS__ObjectEntries(ISAAC_API_CLASS_TYPE_TO_BRAND)) do
+        local copyableIsaacAPIClassType = ____value[1]
+        local serializationBrand = ____value[2]
+        if serializedIsaacAPIClass[serializationBrand] ~= nil then
+            return copyableIsaacAPIClassType
+        end
+    end
+    return nil
+end
+function ____exports.copyIsaacAPIClass(self, isaacAPIClass, serializationType)
+    local objectType = type(isaacAPIClass)
+    if objectType ~= "userdata" then
+        error("Failed to copy an Isaac API class since the provided object was of type: " .. objectType)
+    end
+    local isaacAPIClassType = getIsaacAPIClassType(nil, isaacAPIClass)
+    if isaacAPIClassType == nil then
+        error("Failed to copy an Isaac API class since it does not have a class type.")
+    end
+    local copyableIsaacAPIClassType = isaacAPIClassType
+    local copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[copyableIsaacAPIClassType]
+    if copyFunction == nil then
+        error(("Failed to copy Isaac API class \"" .. copyableIsaacAPIClassType) .. "\" since there is not a defined copy function for this class type.")
+    end
+    return copyFunction(nil, isaacAPIClass, serializationType)
+end
+function ____exports.deserializeIsaacAPIClass(self, serializedIsaacAPIClass)
+    local objectType = type(serializedIsaacAPIClass)
+    if objectType ~= "table" then
+        error("Failed to deserialize an Isaac API class since the provided object was of type: " .. objectType)
+    end
+    local copyableIsaacAPIClassType = getSerializedTableType(nil, serializedIsaacAPIClass)
+    if copyableIsaacAPIClassType == nil then
+        error("Failed to deserialize an API class since a valid class type brand was not found.")
+    end
+    local copyFunction = ISAAC_API_CLASS_TYPE_TO_COPY_FUNCTION[copyableIsaacAPIClassType]
+    if copyFunction == nil then
+        error(("Failed to deserialize Isaac API class \"" .. copyableIsaacAPIClassType) .. "\" since there is not a defined copy function for this class type.")
+    end
+    return copyFunction(nil, serializedIsaacAPIClass, SerializationType.DESERIALIZE)
+end
+function ____exports.isSerializedIsaacAPIClass(self, object)
+    local identityFunctions = __TS__ObjectValues(SERIALIZED_ISAAC_API_CLASS_TYPE_TO_IDENTITY_FUNCTION)
+    return __TS__ArraySome(
+        identityFunctions,
+        function(____, identityFunction) return identityFunction(nil, object) end
+    )
+end
+return ____exports

package/functions/set.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to add all of the values in one set to another set. The first set passed will be
+ * modified in place.
+ *
+ * This function is variadic, meaning that you can specify N sets to add to the first set.
+ */
+export declare function addSetsToSet<T>(mainSet: Set<T>, ...setsToAdd: Array<Set<T> | ReadonlySet<T>>): void;
+/**
+ * Helper function to create a new set that is the composition of two or more sets.
+ *
+ * This function is variadic, meaning that you can specify N sets.
+ */
+export declare function combineSets<T>(...sets: Array<Set<T> | ReadonlySet<T>>): Set<T>;
+/** Helper function to copy a set. (You can also use a Set constructor to accomplish this task.) */
+export declare function copySet<T>(oldSet: Set<T> | ReadonlySet<T>): Set<T>;
+/**
+ * Helper function to delete all of the values in one set from another set. The first set passed
+ * will be modified in place.
+ *
+ * This function is variadic, meaning that you can specify N sets to remove from the first set.
+ */
+export declare function deleteSetsFromSet<T>(mainSet: Set<T>, ...setsToRemove: Array<Set<T> | ReadonlySet<T>>): void;
+/**
+ * Helper function to get a random element from the provided set.
+ *
+ * @param set The set to get an element from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, seedOrRNG?: Seed | RNG, exceptions?: T[] | readonly T[]): T;
+/**
+ * Helper function to get a sorted array based on the contents of a set.
+ *
+ * Normally, set values are returned in a random order, so use this function when the ordering of
+ * the contents is important.
+ */
+export declare function getSortedSetValues<T>(set: Set<T> | ReadonlySet<T>): T[];

package/functions/set.lua

@@ -0,0 +1,61 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__New = ____lualib.__TS__New
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArraySort = ____lualib.__TS__ArraySort
+local ____exports = {}
+local ____array = require("functions.array")
+local getRandomArrayElement = ____array.getRandomArrayElement
+local ____rng = require("functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+function ____exports.getSortedSetValues(self, set)
+    local values = set:values()
+    local array = {__TS__Spread(values)}
+    __TS__ArraySort(array)
+    return array
+end
+function ____exports.addSetsToSet(self, mainSet, ...)
+    local setsToAdd = {...}
+    for ____, set in ipairs(setsToAdd) do
+        for ____, value in __TS__Iterator(set:values()) do
+            mainSet:add(value)
+        end
+    end
+end
+function ____exports.combineSets(self, ...)
+    local sets = {...}
+    local newSet = __TS__New(Set)
+    for ____, set in ipairs(sets) do
+        for ____, value in __TS__Iterator(set:values()) do
+            newSet:add(value)
+        end
+    end
+    return newSet
+end
+function ____exports.copySet(self, oldSet)
+    local newSet = __TS__New(Set)
+    for ____, value in __TS__Iterator(oldSet:values()) do
+        newSet:add(value)
+    end
+    return newSet
+end
+function ____exports.deleteSetsFromSet(self, mainSet, ...)
+    local setsToRemove = {...}
+    for ____, set in ipairs(setsToRemove) do
+        for ____, value in __TS__Iterator(set:values()) do
+            mainSet:delete(value)
+        end
+    end
+end
+function ____exports.getRandomSetElement(self, set, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if exceptions == nil then
+        exceptions = {}
+    end
+    local array = ____exports.getSortedSetValues(nil, set)
+    return getRandomArrayElement(nil, array, seedOrRNG, exceptions)
+end
+return ____exports

package/functions/sound.d.ts

@@ -0,0 +1 @@
+export declare function stopAllSoundEffects(): void;

package/functions/sound.lua

@@ -0,0 +1,13 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
+local ____cachedClasses = require("cachedClasses")
+local sfxManager = ____cachedClasses.sfxManager
+local ____enums = require("functions.enums")
+local getEnumValues = ____enums.getEnumValues
+function ____exports.stopAllSoundEffects(self)
+    for ____, soundEffect in ipairs(getEnumValues(nil, SoundEffect)) do
+        sfxManager:Stop(soundEffect)
+    end
+end
+return ____exports