isaacscript-common 9.18.4 → 9.19.2

package/dist/src/functions/rooms.lua

@@ -0,0 +1,436 @@
+local ____lualib = require("lualib_bundle")
+local __TS__SparseArrayNew = ____lualib.__TS__SparseArrayNew
+local __TS__SparseArrayPush = ____lualib.__TS__SparseArrayPush
+local __TS__SparseArraySpread = ____lualib.__TS__SparseArraySpread
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__StringIncludes = ____lualib.__TS__StringIncludes
+local Set = ____lualib.Set
+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 DoorSlot = ____isaac_2Dtypescript_2Ddefinitions.DoorSlot
+local DownpourRoomSubType = ____isaac_2Dtypescript_2Ddefinitions.DownpourRoomSubType
+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 RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
+local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
+local ____constants = require("src.core.constants")
+local MAX_LEVEL_GRID_INDEX = ____constants.MAX_LEVEL_GRID_INDEX
+local ____roomTypeNames = require("src.objects.roomTypeNames")
+local ROOM_TYPE_NAMES = ____roomTypeNames.ROOM_TYPE_NAMES
+local ____mineShaftRoomSubTypesSet = require("src.sets.mineShaftRoomSubTypesSet")
+local MINE_SHAFT_ROOM_SUB_TYPE_SET = ____mineShaftRoomSubTypesSet.MINE_SHAFT_ROOM_SUB_TYPE_SET
+local ____dimensions = require("src.functions.dimensions")
+local getAllDimensions = ____dimensions.getAllDimensions
+local inDimension = ____dimensions.inDimension
+local ____doors = require("src.functions.doors")
+local closeAllDoors = ____doors.closeAllDoors
+local getDoors = ____doors.getDoors
+local isHiddenSecretRoomDoor = ____doors.isHiddenSecretRoomDoor
+local openDoorFast = ____doors.openDoorFast
+local ____entities = require("src.functions.entities")
+local getEntities = ____entities.getEntities
+local ____flag = require("src.functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____positionVelocity = require("src.functions.positionVelocity")
+local getEntityPositions = ____positionVelocity.getEntityPositions
+local getEntityVelocities = ____positionVelocity.getEntityVelocities
+local setEntityPositions = ____positionVelocity.setEntityPositions
+local setEntityVelocities = ____positionVelocity.setEntityVelocities
+local ____roomData = require("src.functions.roomData")
+local getRoomData = ____roomData.getRoomData
+local getRoomDescriptor = ____roomData.getRoomDescriptor
+local getRoomDescriptorReadOnly = ____roomData.getRoomDescriptorReadOnly
+local getRoomGridIndex = ____roomData.getRoomGridIndex
+local getRoomName = ____roomData.getRoomName
+local getRoomStageID = ____roomData.getRoomStageID
+local getRoomSubType = ____roomData.getRoomSubType
+local ____roomTransition = require("src.functions.roomTransition")
+local reloadRoom = ____roomTransition.reloadRoom
+local ____stage = require("src.functions.stage")
+local getGotoCommand = ____stage.getGotoCommand
+local ____types = require("src.functions.types")
+local asNumber = ____types.asNumber
+local ____utils = require("src.functions.utils")
+local irange = ____utils.irange
+--- Helper function to get a read-only copy of the room descriptor for every room on the level. This
+-- includes off-grid rooms, such as the Devil Room, and extra-dimensional rooms, if they are
+-- generated and exist.
+-- 
+-- Room descriptors without any data are assumed to be non-existent and are not included.
+-- 
+-- Under the hood, this is performed by iterating over the `RoomList` from the `Level.GetRooms`
+-- method. This is the best way to see if off-grid rooms have been initialized, since it is possible
+-- for mods to insert room data at non-official negative room grid indexes.
+function ____exports.getReadOnlyRooms(self)
+    local level = game:GetLevel()
+    local roomList = level:GetRooms()
+    local readOnlyRoomDescriptors = {}
+    do
+        local i = 0
+        while i < roomList.Size do
+            local readOnlyRoomDescriptor = roomList:Get(i)
+            if readOnlyRoomDescriptor ~= nil and readOnlyRoomDescriptor.Data ~= nil then
+                readOnlyRoomDescriptors[#readOnlyRoomDescriptors + 1] = readOnlyRoomDescriptor
+            end
+            i = i + 1
+        end
+    end
+    return readOnlyRoomDescriptors
+end
+--- Helper function to get the room descriptor for every room on the level that is on the grid. (For
+-- example, Devil Rooms are excluded.)
+-- 
+-- Room descriptors without any data are assumed to be non-existent and are not included.
+-- 
+-- @param includeExtraDimensionalRooms Optional. On some floors (e.g. Downpour 2, Mines 2),
+-- extra-dimensional rooms are automatically be generated. Default
+-- is false.
+function ____exports.getRoomsInsideGrid(self, includeExtraDimensionalRooms)
+    if includeExtraDimensionalRooms == nil then
+        includeExtraDimensionalRooms = false
+    end
+    local level = game:GetLevel()
+    local dimensions = includeExtraDimensionalRooms and getAllDimensions(nil) or ({Dimension.CURRENT})
+    --- We use a map instead of an array because room shapes occupy more than one room grid index.
+    local roomDescriptorMap = __TS__New(Map)
+    for ____, dimension in ipairs(dimensions) do
+        for ____, roomGridIndex in ipairs(irange(nil, MAX_LEVEL_GRID_INDEX)) do
+            local roomDescriptor = level:GetRoomByIdx(roomGridIndex, dimension)
+            if roomDescriptor.Data ~= nil then
+                local ptrHash = GetPtrHash(roomDescriptor)
+                roomDescriptorMap:set(ptrHash, roomDescriptor)
+            end
+        end
+    end
+    return {__TS__Spread(roomDescriptorMap:values())}
+end
+--- Helper function to get the room descriptor for every room on the level that is outside of the
+-- grid (like a Devil Room).
+-- 
+-- Room descriptors without any data are assumed to be non-existent and are not included.
+function ____exports.getRoomsOutsideGrid(self)
+    local readOnlyRooms = ____exports.getReadOnlyRooms(nil)
+    local readOnlyRoomsOffGrid = __TS__ArrayFilter(
+        readOnlyRooms,
+        function(____, readOnlyRoomDescriptor) return readOnlyRoomDescriptor.SafeGridIndex < 0 end
+    )
+    return __TS__ArrayMap(
+        readOnlyRoomsOffGrid,
+        function(____, readOnlyRoomDescriptor) return getRoomDescriptor(nil, readOnlyRoomDescriptor.SafeGridIndex) end
+    )
+end
+--- Helper function for quickly switching to a new room without playing a particular animation. Use
+-- this helper function over invoking the `Game.ChangeRoom` method directly to ensure that you do
+-- not forget to set the `LeaveDoor` field and to prevent crashing on invalid room grid indexes.
+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
+--- Helper function to get the number of rooms that are currently on the floor layout. This does not
+-- include off-grid rooms, like the Devil Room.
+function ____exports.getNumRooms(self)
+    local rooms = ____exports.getRoomsInsideGrid(nil)
+    return #rooms
+end
+--- Helper function to get the room data for a specific room type and variant combination. This is
+-- accomplished by using the "goto" console command to load the specified room into the
+-- `GridRoom.DEBUG` slot.
+-- 
+-- Returns undefined if the provided room type and variant combination were not found. (A warning
+-- message will also appear on the console, since the "goto" command will fail.)
+-- 
+-- Note that the side effect of using the "goto" console command is that it will trigger a room
+-- transition after a short delay. By default, this function cancels the incoming room transition by
+-- using the `Game.StartRoomTransition` method to travel to the same room.
+-- 
+-- @param roomType The type of room to retrieve.
+-- @param roomVariant The room variant to retrieve. (The room variant is the "ID" of the room in
+-- Basement Renovator.)
+-- @param cancelRoomTransition Optional. Whether to cancel the room transition by using the
+-- `Game.StartRoomTransition` method to travel to the same room. Default
+-- is true. Set this to false if you are getting the data for many rooms
+-- at the same time, and then use the `teleport` helper function when
+-- you are finished.
+function ____exports.getRoomDataForTypeVariant(self, roomType, roomVariant, cancelRoomTransition)
+    if cancelRoomTransition == nil then
+        cancelRoomTransition = true
+    end
+    local command = getGotoCommand(nil, roomType, roomVariant)
+    Isaac.ExecuteCommand(command)
+    local newRoomData = getRoomData(nil, GridRoom.DEBUG)
+    if cancelRoomTransition then
+        reloadRoom(nil)
+    end
+    return newRoomData
+end
+--- Helper function to get the item pool type for the current room. For example, this returns
+-- `ItemPoolType.ItemPoolType.POOL_ANGEL` if you are in an Angel Room.
+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
+--- Helper function to get the proper name of a room type.
+-- 
+-- For example, `RoomType.TREASURE` will return "Treasure Room".
+function ____exports.getRoomTypeName(self, roomType)
+    return ROOM_TYPE_NAMES[roomType]
+end
+--- Helper function to get the room descriptor for every room on the level. This includes off-grid
+-- rooms, such as the Devil Room.
+-- 
+-- Room descriptors without any data are assumed to be non-existent and are not included.
+-- 
+-- - If you want just the rooms inside of the grid, use the `getRoomsInGrid` helper function.
+-- - If you want just the rooms outside of the grid, use the `getRoomsOutsideGrid` helper function.
+-- 
+-- @param includeExtraDimensionalRooms Optional. On some floors (e.g. Downpour 2, Mines 2),
+-- extra-dimensional rooms are automatically generated. Default is
+-- false.
+function ____exports.getRooms(self, includeExtraDimensionalRooms)
+    if includeExtraDimensionalRooms == nil then
+        includeExtraDimensionalRooms = false
+    end
+    local roomsInGrid = ____exports.getRoomsInsideGrid(nil, includeExtraDimensionalRooms)
+    local roomsOutsideGrid = ____exports.getRoomsOutsideGrid(nil)
+    local ____array_0 = __TS__SparseArrayNew(table.unpack(roomsInGrid))
+    __TS__SparseArrayPush(
+        ____array_0,
+        table.unpack(roomsOutsideGrid)
+    )
+    return {__TS__SparseArraySpread(____array_0)}
+end
+--- Helper function to get the room descriptor for every room on the level in a specific dimension.
+-- This will not include any off-grid rooms, such as the Devil Room.
+-- 
+-- Room descriptors without any data are assumed to be non-existent and are not included.
+function ____exports.getRoomsOfDimension(self, dimension)
+    local level = game:GetLevel()
+    --- We use a map instead of an array because room shapes occupy more than one room grid index.
+    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
+            local ptrHash = GetPtrHash(roomDescriptor)
+            roomsMap:set(ptrHash, roomDescriptor)
+        end
+    end
+    return {__TS__Spread(roomsMap:values())}
+end
+--- Helper function to determine if the current room shape is equal to `RoomShape.1x2` or
+-- `RoomShape.2x1`.
+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 == asNumber(nil, 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 == asNumber(nil, DungeonSubType.BEAST_ROOM)
+end
+--- Helper function to check if the current room is a boss room for a particular boss. This will only
+-- work for bosses that have dedicated boss rooms in the "00.special rooms.stb" file.
+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 == asNumber(nil, bossID)
+end
+--- Helper function for determining whether the current room is a crawl space. Use this function over
+-- comparing to `RoomType.DUNGEON` or `GridRoom.DUNGEON_IDX` since there is a special case of the
+-- player being in a boss fight that take place in a dungeon.
+function ____exports.inCrawlSpace(self)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.DUNGEON and roomSubType == asNumber(nil, DungeonSubType.NORMAL)
+end
+--- Helper function to detect if the current room is one of the room in the Death Certificate area.
+function ____exports.inDeathCertificateArea(self)
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return roomStageID == StageID.HOME and (roomSubType == asNumber(nil, HomeRoomSubType.DEATH_CERTIFICATE_ENTRANCE) or roomSubType == asNumber(nil, HomeRoomSubType.DEATH_CERTIFICATE_ITEMS))
+end
+--- Helper function to detect if the current room is a Treasure Room created when entering with a
+-- Devil's Crown trinket.
+-- 
+-- Under the hood, this checks for `RoomDescriptorFlag.DEVIL_TREASURE`.
+function ____exports.inDevilsCrownTreasureRoom(self)
+    local roomDescriptor = getRoomDescriptorReadOnly(nil)
+    return hasFlag(nil, roomDescriptor.Flags, RoomDescriptorFlag.DEVIL_TREASURE)
+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 == asNumber(nil, GridRoom.GENESIS)
+end
+--- Helper function to determine if the current room shape is one of the four L room shapes.
+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
+--- Helper function to determine if the current room index is equal to `GridRoom.MEGA_SATAN`.
+function ____exports.inMegaSatanRoom(self)
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == asNumber(nil, GridRoom.MEGA_SATAN)
+end
+--- Helper function to determine if the current room is part of the Repentance "escape sequence" in
+-- the Mines/Ashpit.
+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
+--- Helper function to check if the current room is a miniboss room for a particular miniboss. This
+-- will only work for mini-bosses that have dedicated boss rooms in the "00.special rooms.stb" file.
+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 == asNumber(nil, minibossID)
+end
+--- Helper function to check if the current room is a "mirror room" in Downpour or Dross. (These
+-- rooms are marked with a specific sub-type.)
+function ____exports.inMirrorRoom(self)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return roomType == RoomType.DEFAULT and (roomStageID == StageID.DOWNPOUR or roomStageID == StageID.DROSS) and roomSubType == asNumber(nil, DownpourRoomSubType.MIRROR)
+end
+--- Helper function for checking if the current room is a secret exit that leads to a Repentance
+-- floor.
+function ____exports.inSecretExit(self)
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == asNumber(nil, GridRoom.SECRET_EXIT)
+end
+--- Helper function for checking if the current room is a secret shop (from the Member Card
+-- collectible).
+-- 
+-- Secret shops are simply copies of normal shops, but with the backdrop of a secret room. In other
+-- words, they will have the same room type, room variant, and room sub-type of a normal shop. Thus,
+-- the only way to detect them is by using the grid index.
+function ____exports.inSecretShop(self)
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == asNumber(nil, GridRoom.SECRET_SHOP)
+end
+--- Helper function to determine whether or not the current room is the starting room of a floor. It
+-- only returns true for the starting room of the primary dimension (meaning that being in the
+-- starting room of the mirror world does not count).
+function ____exports.inStartingRoom(self)
+    local level = game:GetLevel()
+    local startingRoomGridIndex = level:GetStartingRoomIndex()
+    local roomGridIndex = getRoomGridIndex(nil)
+    return roomGridIndex == startingRoomGridIndex and inDimension(nil, Dimension.MAIN)
+end
+--- Helper function to loop through every room on the floor and see if it has been cleared.
+-- 
+-- This function will only check rooms inside the gird and inside the current dimension.
+-- 
+-- @param onlyCheckRoomTypes Optional. A whitelist of room types. If specified, room types not in
+-- the array will be ignored. If not specified, then all rooms will be
+-- checked. Undefined by default.
+function ____exports.isAllRoomsClear(self, onlyCheckRoomTypes)
+    local ____temp_1
+    if onlyCheckRoomTypes == nil then
+        ____temp_1 = nil
+    else
+        ____temp_1 = __TS__New(Set, onlyCheckRoomTypes)
+    end
+    local roomTypeWhitelist = ____temp_1
+    local rooms = ____exports.getRoomsInsideGrid(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
+--- If the `Room.Update` method is called in a `POST_NEW_ROOM` callback, then some entities will
+-- slide around (such as the player). Since those entity velocities are already at zero, setting
+-- them to zero will have no effect. Thus, a generic solution is to record all of the entity
+-- positions/velocities before updating the room, and then restore those positions/velocities.
+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
+--- Helper function to set the backdrop of the current room.
+function ____exports.setBackdrop(self, backdropType)
+    game:ShowHallucination(0, backdropType)
+    sfxManager:Stop(SoundEffect.DEATH_CARD)
+end
+--- Helper function to convert an uncleared room to a cleared room in the `POST_NEW_ROOM` callback.
+-- This is useful because if enemies are removed in this callback, a room drop will be awarded and
+-- the doors will start closed and then open.
+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 __continue50
+            end
+            openDoorFast(nil, door)
+            door.ExtraVisible = false
+        end
+        ::__continue50::
+    end
+    sfxManager:Stop(SoundEffect.DOOR_HEAVY_OPEN)
+    game:ShakeScreen(0)
+end
+--- Helper function to emulate what happens when you bomb an Angel Statue or push a Reward Plate that
+-- spawns an NPC.
+function ____exports.setRoomUncleared(self)
+    local room = game:GetRoom()
+    room:SetClear(false)
+    closeAllDoors(nil)
+end
+return ____exports

package/dist/src/functions/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAQtC;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/src/functions/run.lua

@@ -0,0 +1,79 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local SlotVariant = ____isaac_2Dtypescript_2Ddefinitions.SlotVariant
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____constants = require("src.core.constants")
+local VectorZero = ____constants.VectorZero
+local ____constantsFirstLast = require("src.core.constantsFirstLast")
+local FIRST_CHARACTER = ____constantsFirstLast.FIRST_CHARACTER
+local ____runInNFrames = require("src.features.runInNFrames")
+local runNextRenderFrame = ____runInNFrames.runNextRenderFrame
+local ____entitiesSpecific = require("src.functions.entitiesSpecific")
+local spawnSlot = ____entitiesSpecific.spawnSlot
+local ____log = require("src.functions.log")
+local log = ____log.log
+--- Helper function to see if the current run can unlock achievements. For example, if playing on a
+-- set seed or in a victory lap, achievements are disabled.
+function ____exports.canRunUnlockAchievements(self)
+    local greedDonationMachine = spawnSlot(nil, SlotVariant.GREED_DONATION_MACHINE, 0, VectorZero)
+    local canUnlockAchievements = greedDonationMachine:Exists()
+    greedDonationMachine:Remove()
+    return canUnlockAchievements
+end
+--- 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.
+function ____exports.onSetSeed(self)
+    local seeds = game:GetSeeds()
+    local customRun = seeds:IsCustomRun()
+    local challenge = Isaac.GetChallenge()
+    return challenge == Challenge.NULL and customRun
+end
+--- Helper function to restart the run using the console command of "restart". If the player is
+-- playing a seeded run, then it will restart the game to the beginning of the seed. Otherwise, it
+-- will put the player on a run with an entirely new seed.
+-- 
+-- You can optionally specify a `PlayerType` to restart the game as that character.
+function ____exports.restart(self, character)
+    if character == nil then
+        local command = "restart"
+        log(nil, "Restarting the run with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
+        return
+    end
+    if character < FIRST_CHARACTER then
+        error(("Restarting as a character of " .. tostring(character)) .. " would crash the game.")
+    end
+    local command = "restart " .. tostring(character)
+    log(
+        nil,
+        (((("Restarting the run as PlayerType." .. tostring(PlayerType[character])) .. " (") .. tostring(character)) .. ") with a console command of: ") .. command
+    )
+    Isaac.ExecuteCommand(command)
+end
+--- Helper function to restart on the next render frame. Useful because it is impossible to restart
+-- the game inside of the `POST_NEW_ROOM`, `POST_NEW_LEVEL`, or `POST_GAME_STARTED` callbacks when a
+-- run is first starting.
+-- 
+-- You can optionally specify a `PlayerType` to restart the game as that character.
+function ____exports.restartNextRenderFrame(self, character)
+    runNextRenderFrame(
+        nil,
+        function()
+            ____exports.restart(nil, character)
+        end
+    )
+end
+--- Helper function to change the run status to that of an unseeded run with a new random seed.
+-- 
+-- This is useful to revert the behavior where playing on a set and restarting the game will not
+-- take you to a new seed.
+function ____exports.setUnseeded(self)
+    local seeds = game:GetSeeds()
+    seeds:Reset()
+    seeds:Restart(Challenge.NULL)
+end
+return ____exports

package/dist/src/functions/saveFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveFile.d.ts","sourceRoot":"","sources":["../../../src/functions/saveFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAI7E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO,CAMT"}

package/dist/src/functions/saveFile.lua

@@ -0,0 +1,24 @@
+local ____exports = {}
+local ____itemPool = require("src.functions.itemPool")
+local isCollectibleInItemPool = ____itemPool.isCollectibleInItemPool
+local ____players = require("src.functions.players")
+local anyPlayerHasCollectible = ____players.anyPlayerHasCollectible
+--- Helper function to see if the given collectible is unlocked on the current save file. This
+-- requires providing the corresponding item pool that the collectible is normally located in.
+-- 
+-- - If any player currently has the collectible, then it is assumed to be unlocked. (This is
+--   because in almost all cases, when a collectible is added to a player's inventory, it is
+--   subsequently removed from all pools.)
+-- - If the collectible is located in more than one item pool, then any item pool can be provided.
+-- - If the collectible is not located in any item pools, then this function will always return
+--   false.
+-- - If the collectible is non-offensive, any Tainted Losts will be temporarily changed to Isaac and
+--   then changed back. (This is because Tainted Lost is not able to retrieve non-offensive
+--   collectibles from item pools).
+function ____exports.isCollectibleUnlocked(self, collectibleType, itemPoolType)
+    if anyPlayerHasCollectible(nil, collectibleType) then
+        return true
+    end
+    return isCollectibleInItemPool(nil, collectibleType, itemPoolType)
+end
+return ____exports

package/dist/src/functions/seeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../../../src/functions/seeds.ts"],"names":[],"mappings":";AAGA,uDAAuD;AACvD,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAIzC"}

package/dist/src/functions/seeds.lua

@@ -0,0 +1,19 @@
+local ____exports = {}
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____rng = require("src.functions.rng")
+local newRNG = ____rng.newRNG
+--- Alias for the `Seeds.GetStartSeedString` method.
+function ____exports.getStartSeedString(self)
+    local seeds = game:GetSeeds()
+    return seeds:GetStartSeedString()
+end
+--- Helper function to get the next seed value.
+-- 
+-- This function is useful when you are working with seed values directly over RNG objects.
+function ____exports.nextSeed(self, seed)
+    local rng = newRNG(nil, seed)
+    rng:Next()
+    return rng:GetSeed()
+end
+return ____exports

package/dist/src/functions/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../src/functions/serialization.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAI3E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CA0BjE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,uBAAuB,EAAE,OAAO,GAC/B,OAAO,CA0BT;AAoBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,uBAAuB,CAQnC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CA0BtE"}