isaacscript-common 1.2.136 → 1.2.139

package/dist/featuresInitialized.d.ts

@@ -1 +1 @@
-export {};
+export declare function errorIfFeaturesNotInitialized(featureName: string): void;

package/dist/featuresInitialized.lua

@@ -7,4 +7,9 @@ end
 function ____exports.setFeaturesInitialized(self)
     featuresInitialized = true
 end
+function ____exports.errorIfFeaturesNotInitialized(self, featureName)
+    if not ____exports.areFeaturesInitialized(nil) then
+        error(("The " .. featureName) .. " is not initialized. You must first upgrade your mod object by calling the \"upgradeMod\" function.")
+    end
+end
 return ____exports

package/dist/functions/deepCopy.lua

@@ -7,8 +7,8 @@ local __TS__InstanceOf = ____lualib.__TS__InstanceOf
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
 local isTSTLClass, copyClass, getNewClassFromMetatable, deepCopyValue, copyVector, checkMetatable, validateValue, TSTL_CLASS_KEYS
-local ____debug = require("features.saveDataManager.debug")
-local SAVE_DATA_MANAGER_DEBUG = ____debug.SAVE_DATA_MANAGER_DEBUG
+local ____constants = require("features.saveDataManager.constants")
+local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local ____DefaultMap = require("types.DefaultMap")
 local DefaultMap = ____DefaultMap.DefaultMap
 local ____SerializationBrand = require("types.private.SerializationBrand")

package/dist/functions/log.d.ts

@@ -36,11 +36,15 @@ export declare function logAllUseFlags(this: void, _flags: int): void;
 export declare function logArray<T>(this: void, array: T[]): void;
 export declare function logColor(this: void, color: Color): void;
 export declare function logEntity(this: void, entity: Entity): void;
+export declare function logEntities(this: void, includeBackgroundEffects: boolean, entityTypeFilter?: EntityType | int): void;
+export declare function logGridEntities(this: void, includeWalls: boolean, gridEntityTypeFilter?: GridEntityType | int): void;
 export declare function logKColor(this: void, kColor: KColor): void;
 export declare function logMap(this: void, map: Map<AnyNotNil, unknown>): void;
 export declare function logPlayerHealth(this: void, player: EntityPlayer): void;
-/** Helper function for printing out information about the current room. */
+/** Helper function for logging information about the current room. */
 export declare function logRoom(this: void): void;
+/** Helper function for logging every sound effect that is currently playing. */
+export declare function logSounds(this: void): void;
 export declare function logTable(this: void, table: unknown, parentTables?: number): void;
 export declare function logTemporaryEffects(this: void, player: EntityPlayer): void;
 export declare function logSet(this: void, set: Set<AnyNotNil>): void;

package/dist/functions/log.lua

@@ -1,19 +1,28 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local Map = ____lualib.Map
 local __TS__Spread = ____lualib.__TS__Spread
 local __TS__ArraySort = ____lualib.__TS__ArraySort
-local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
-local Set = ____lualib.Set
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
 local ____array = require("functions.array")
 local arrayToString = ____array.arrayToString
 local ____collectibles = require("functions.collectibles")
 local getCollectibleName = ____collectibles.getCollectibleName
+local ____entity = require("functions.entity")
+local getEntities = ____entity.getEntities
+local getEntityID = ____entity.getEntityID
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+local ____gridEntity = require("functions.gridEntity")
+local getGridEntities = ____gridEntity.getGridEntities
+local ____math = require("functions.math")
+local range = ____math.range
 local ____player = require("functions.player")
 local getEffectsList = ____player.getEffectsList
 local getPlayerName = ____player.getPlayerName
@@ -65,6 +74,17 @@ function ____exports.logAllFlags(flags, flagEnum, description)
         ____exports.log("  n/a (no flags)")
     end
 end
+local IGNORE_EFFECT_VARIANTS = __TS__New(Set, {
+    EffectVariant.BLOOD_EXPLOSION,
+    EffectVariant.BLOOD_PARTICLE,
+    EffectVariant.TINY_BUG,
+    EffectVariant.TINY_FLY,
+    EffectVariant.WATER_DROPLET,
+    EffectVariant.WALL_BUG,
+    EffectVariant.FALLING_EMBER,
+    EffectVariant.LIGHT,
+    EffectVariant.TADPOLE
+})
 function ____exports.logAllDamageFlags(flags)
     ____exports.logAllFlags(flags, DamageFlag, "damage")
 end
@@ -120,6 +140,146 @@ end
 function ____exports.logEntity(entity)
     ____exports.log((((("Entity: " .. tostring(entity.Type)) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType))
 end
+function ____exports.logEntities(includeBackgroundEffects, entityTypeFilter)
+    local headerMsg = "Entities in the room"
+    if entityTypeFilter ~= nil then
+        headerMsg = headerMsg .. (" (filtered to entity type " .. tostring(entityTypeFilter)) .. ")"
+    end
+    if not includeBackgroundEffects then
+        headerMsg = headerMsg .. " (not excluding background effects)"
+    end
+    headerMsg = headerMsg .. ":"
+    ____exports.log(headerMsg)
+    local entities = getEntities(nil)
+    local numMatchedEntities = 0
+    __TS__ArrayForEach(
+        entities,
+        function(____, entity, i)
+            if entityTypeFilter ~= nil and entity.Type ~= entityTypeFilter then
+                return
+            end
+            if not includeBackgroundEffects and entity.Type == EntityType.ENTITY_EFFECT and IGNORE_EFFECT_VARIANTS:has(entity.Variant) then
+                return
+            end
+            local entityID = getEntityID(nil, entity)
+            local debugString = (tostring(i + 1) .. " - ") .. entityID
+            local bomb = entity:ToBomb()
+            if bomb ~= nil then
+                debugString = debugString .. " (bomb)"
+            end
+            local effect = entity:ToEffect()
+            if effect ~= nil then
+                debugString = debugString .. ("." .. tostring(effect.State)) .. " (effect)"
+            end
+            local familiar = entity:ToFamiliar()
+            if familiar ~= nil then
+                debugString = debugString .. ("." .. tostring(familiar.State)) .. " (familiar)"
+            end
+            local knife = entity:ToKnife()
+            if knife ~= nil then
+                debugString = debugString .. " (knife)"
+            end
+            local laser = entity:ToLaser()
+            if laser ~= nil then
+                debugString = debugString .. " (laser)"
+            end
+            local npc = entity:ToNPC()
+            if npc ~= nil then
+                debugString = debugString .. ((("." .. tostring(npc.State)) .. " (NPC) (CanShutDoors: ") .. tostring(npc.CanShutDoors)) .. ")"
+            end
+            local pickup = entity:ToPickup()
+            if pickup ~= nil then
+                debugString = debugString .. ("." .. tostring(pickup.State)) .. " (pickup)"
+            end
+            local player = entity:ToPlayer()
+            if player ~= nil then
+                debugString = debugString .. " (player)"
+            end
+            local projectile = entity:ToProjectile()
+            if projectile ~= nil then
+                debugString = debugString .. " (projectile)"
+            end
+            local tear = entity:ToTear()
+            if tear ~= nil then
+                debugString = debugString .. " (tear)"
+            end
+            debugString = debugString .. (" (InitSeed: " .. tostring(entity.InitSeed)) .. ")"
+            debugString = debugString .. (" (DropSeed: " .. tostring(entity.DropSeed)) .. ")"
+            debugString = debugString .. (((" (Position: " .. tostring(entity.Position.X)) .. ", ") .. tostring(entity.Position.Y)) .. ")"
+            debugString = debugString .. (((" (Velocity: " .. tostring(entity.Velocity.X)) .. ", ") .. tostring(entity.Velocity.Y)) .. ")"
+            debugString = debugString .. (((" (HP: " .. tostring(entity.HitPoints)) .. " / ") .. tostring(entity.MaxHitPoints)) .. ")"
+            ____exports.log(debugString)
+            numMatchedEntities = numMatchedEntities + 1
+        end
+    )
+    if numMatchedEntities == 0 then
+        ____exports.log("(no entities matched)")
+    end
+end
+function ____exports.logGridEntities(includeWalls, gridEntityTypeFilter)
+    local headerMsg = "Grid entities in the room"
+    if gridEntityTypeFilter ~= nil then
+        headerMsg = headerMsg .. (" (filtered to grid entity type " .. tostring(gridEntityTypeFilter)) .. ")"
+    end
+    if not includeWalls then
+        headerMsg = headerMsg .. " (not including walls)"
+    end
+    ____exports.log(headerMsg)
+    local gridEntities = getGridEntities(nil)
+    local numMatchedEntities = 0
+    __TS__ArrayForEach(
+        gridEntities,
+        function(____, gridEntity)
+            local gridEntityIndex = gridEntity:GetGridIndex()
+            local gridEntityType = gridEntity:GetType()
+            local gridEntityVariant = gridEntity:GetVariant()
+            local gridEntityDesc = gridEntity:GetSaveState()
+            if gridEntityTypeFilter ~= nil and gridEntityType ~= gridEntityTypeFilter then
+                return
+            end
+            if not includeWalls and gridEntityType == GridEntityType.GRID_WALL and gridEntityTypeFilter ~= GridEntityType.GRID_WALL then
+                return
+            end
+            local debugString = (((((tostring(gridEntityIndex) .. " - ") .. tostring(gridEntityType)) .. ".") .. tostring(gridEntityVariant)) .. ".") .. tostring(gridEntity.State)
+            local door = gridEntity:ToDoor()
+            if door ~= nil then
+                debugString = debugString .. (((((((" (door) (Slot: " .. tostring(door.Slot)) .. ", Direction: ") .. tostring(door.Direction)) .. ", TargetRoomIndex: ") .. tostring(door.TargetRoomIndex)) .. ", TargetRoomType: ") .. tostring(door.TargetRoomType)) .. ")"
+            end
+            local pit = gridEntity:ToPit()
+            if pit ~= nil then
+                debugString = debugString .. " (pit)"
+            end
+            local poop = gridEntity:ToPoop()
+            if poop ~= nil then
+                debugString = debugString .. " (poop)"
+            end
+            local pressurePlate = gridEntity:ToPressurePlate()
+            if pressurePlate ~= nil then
+                debugString = debugString .. " (pressurePlate)"
+            end
+            local rock = gridEntity:ToRock()
+            if rock ~= nil then
+                debugString = debugString .. " (rock)"
+            end
+            local spikes = gridEntity:ToSpikes()
+            if spikes ~= nil then
+                debugString = debugString .. " (spikes)"
+            end
+            local tnt = gridEntity:ToTNT()
+            if tnt ~= nil then
+                debugString = debugString .. " (TNT)"
+            end
+            debugString = debugString .. (" (VarData: " .. tostring(gridEntity.VarData)) .. ")"
+            debugString = debugString .. (((" (Position: " .. tostring(gridEntity.Position.X)) .. ", ") .. tostring(gridEntity.Position.Y)) .. ")"
+            debugString = debugString .. (((" (SpawnSeed: " .. tostring(gridEntityDesc.SpawnSeed)) .. ", VariableSeed: ") .. tostring(gridEntityDesc.VariableSeed)) .. ")"
+            ____exports.log(debugString)
+            numMatchedEntities = numMatchedEntities + 1
+        end
+    )
+    if numMatchedEntities == 0 then
+        ____exports.log("(no grid entities matched)")
+    end
+end
 function ____exports.logKColor(kColor)
     ____exports.log((((((("Color: R" .. tostring(kColor.Red)) .. ", G") .. tostring(kColor.Green)) .. ", B") .. tostring(kColor.Blue)) .. ", A") .. tostring(kColor.Alpha))
 end
@@ -156,11 +316,20 @@ function ____exports.logRoom()
     if roomData == nil then
         ____exports.log("Current room data is undefined.")
     else
+        ____exports.log("Current room stage ID: " .. tostring(roomData.StageID))
         ____exports.log((((("Current room type/variant/sub-type: " .. tostring(roomData.Type)) .. ".") .. tostring(roomData.Variant)) .. ".") .. tostring(roomData.Subtype))
+        ____exports.log("Current room name: " .. roomData.Name)
     end
     ____exports.log("Current room grid index: " .. tostring(roomGridIndex))
     ____exports.log("Current room list index: " .. tostring(roomListIndex))
 end
+function ____exports.logSounds()
+    for ____, soundEffect in ipairs(range(nil, 0, SoundEffect.NUM_SOUND_EFFECTS - 1)) do
+        if sfxManager:IsPlaying(soundEffect) then
+            ____exports.log("Currently playing sound effect: " .. tostring(soundEffect))
+        end
+    end
+end
 function ____exports.logTable(____table, parentTables)
     if parentTables == nil then
         parentTables = 0
@@ -233,11 +402,15 @@ function ____exports.setLogFunctionsGlobal(self)
     globals.logArray = ____exports.logArray
     globals.logColor = ____exports.logColor
     globals.logEntity = ____exports.logEntity
+    globals.logEntities = ____exports.logEntities
+    globals.logGridEntities = ____exports.logGridEntities
     globals.logKColor = ____exports.logKColor
     globals.logMap = ____exports.logMap
+    globals.logRoom = ____exports.logRoom
     globals.logTable = ____exports.logTable
     globals.logTemporaryEffects = ____exports.logTemporaryEffects
     globals.logSet = ____exports.logSet
+    globals.logSounds = ____exports.logSounds
     globals.logVector = ____exports.logVector
 end
 return ____exports

package/dist/functions/map.d.ts

@@ -7,6 +7,22 @@ export declare function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V>;
  * manually getting the current value, incrementing it, and then setting it.
  */
 export declare function defaultMapGetNextSeed<K, A extends unknown[]>(map: DefaultMap<K, Seed, A>, key: K, ...extraArgs: A): Seed;
+/**
+ * Helper function to get the closest value from a map based on partial search text. For the
+ * purposes of this function, both search text and map keys are converted to lowercase before
+ * attempting to find a match.
+ *
+ * Example:
+ * ```ts
+ * const map = new <string, number>Map([
+ *   ["foo", 123],
+ *   ["bar", 456],
+ * ]);
+ * const searchText = "f";
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ * ```
+ */
+export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyMap<string, T>): T | undefined;
 /**
  * Helper function to make using maps with `Seed` values easier. Use this instead of manually
  * getting the current value, incrementing it, and then setting it.

package/dist/functions/map.lua

@@ -3,6 +3,11 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArraySort = ____lualib.__TS__ArraySort
+local __TS__StringReplaceAll = ____lualib.__TS__StringReplaceAll
+local __TS__StringStartsWith = ____lualib.__TS__StringStartsWith
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local ____random = require("functions.random")
 local nextSeed = ____random.nextSeed
@@ -24,6 +29,25 @@ function ____exports.defaultMapGetNextSeed(self, map, key, ...)
     map:set(key, newSeed)
     return newSeed
 end
+function ____exports.getMapPartialMatch(self, searchText, map)
+    local keys = {__TS__Spread(map:keys())}
+    __TS__ArraySort(keys)
+    searchText = string.lower(searchText)
+    searchText = __TS__StringReplaceAll(searchText, " ", "")
+    local matchingKeys = __TS__ArrayFilter(
+        keys,
+        function(____, key) return __TS__StringStartsWith(
+            string.lower(key),
+            searchText
+        ) end
+    )
+    __TS__ArraySort(matchingKeys)
+    local matchingKey = matchingKeys[1]
+    if matchingKey == nil then
+        return nil
+    end
+    return map:get(matchingKey)
+end
 function ____exports.mapGetNextSeed(self, map, key)
     local seed = map:get(key)
     if seed == nil then

package/dist/functions/player.d.ts

@@ -101,8 +101,8 @@ export declare function getFinalPlayer(): EntityPlayer;
  */
 export declare function getHearts(player: EntityPlayer): int;
 /**
- * Helper function that returns the type of the rightmost heart, not including golden hearts since
- * they can't be damaged directly.
+ * Helper function that returns the type of the rightmost heart. This does not including golden
+ * hearts or broken hearts, since they cannot be damaged directly.
  */
 export declare function getLastHeart(player: EntityPlayer): HealthType;
 /**

package/dist/functions/playerHealth.d.ts

@@ -1,5 +1,7 @@
 /// <reference types="isaac-typescript-definitions" />
+import { HealthType } from "../types/HealthType";
 import { PlayerHealth } from "../types/PlayerHealth";
+export declare function addPlayerHealthType(player: EntityPlayer, healthType: HealthType, numHearts: int): void;
 /**
  * Helper function to get an inventory of the player's health. Use this in combination with the
  * `setPlayerHealth` function to restore the player's health back to a certain configuration at a
@@ -8,6 +10,7 @@ import { PlayerHealth } from "../types/PlayerHealth";
  * This is based on the `REVEL.StoreHealth` function in the Revelations mod.
  */
 export declare function getPlayerHealth(player: EntityPlayer): PlayerHealth;
+export declare function getPlayerHealthType(player: EntityPlayer, healthType: HealthType): int;
 /**
  * Helper function to set a player's health to a specific state. You can use this in combination
  * with the `getPlayerHealth` function to restore the player's health back to a certain

package/dist/functions/playerHealth.lua

@@ -5,9 +5,14 @@ local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local ____exports = {}
 local ____constants = require("constants")
 local MAX_PLAYER_HEART_CONTAINERS = ____constants.MAX_PLAYER_HEART_CONTAINERS
+local ____HealthType = require("types.HealthType")
+local HealthType = ____HealthType.HealthType
 local ____player = require("functions.player")
+local getBlackHearts = ____player.getBlackHearts
 local getHearts = ____player.getHearts
+local getSoulHearts = ____player.getSoulHearts
 local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
 local ____repeat = ____utils["repeat"]
 function ____exports.removeAllPlayerHealth(self, player)
     local character = player:GetPlayerType()
@@ -29,6 +34,79 @@ function ____exports.removeAllPlayerHealth(self, player)
         end
     end
 end
+function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
+    repeat
+        local ____switch3 = healthType
+        local ____cond3 = ____switch3 == HealthType.RED
+        if ____cond3 then
+            do
+                player:AddHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.SOUL
+        if ____cond3 then
+            do
+                player:AddSoulHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.ETERNAL
+        if ____cond3 then
+            do
+                player:AddEternalHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.BLACK
+        if ____cond3 then
+            do
+                player:AddBlackHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.GOLDEN
+        if ____cond3 then
+            do
+                player:AddGoldenHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.BONE
+        if ____cond3 then
+            do
+                player:AddBoneHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.ROTTEN
+        if ____cond3 then
+            do
+                player:AddRottenHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.BROKEN
+        if ____cond3 then
+            do
+                player:AddBrokenHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.MAX_HEARTS
+        if ____cond3 then
+            do
+                player:AddMaxHearts(numHearts, false)
+                return
+            end
+        end
+        do
+            do
+                ensureAllCases(nil, healthType)
+            end
+        end
+    until true
+end
 function ____exports.getPlayerHealth(self, player)
     local character = player:GetPlayerType()
     local soulHeartTypes = {}
@@ -91,6 +169,70 @@ function ____exports.getPlayerHealth(self, player)
         soulHeartTypes = soulHeartTypes
     }
 end
+function ____exports.getPlayerHealthType(self, player, healthType)
+    repeat
+        local ____switch25 = healthType
+        local ____cond25 = ____switch25 == HealthType.RED
+        if ____cond25 then
+            do
+                return getHearts(nil, player)
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.SOUL
+        if ____cond25 then
+            do
+                return getSoulHearts(nil, player)
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.ETERNAL
+        if ____cond25 then
+            do
+                return player:GetEternalHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.BLACK
+        if ____cond25 then
+            do
+                return getBlackHearts(nil, player)
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.GOLDEN
+        if ____cond25 then
+            do
+                return player:GetGoldenHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.BONE
+        if ____cond25 then
+            do
+                return player:GetBoneHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.ROTTEN
+        if ____cond25 then
+            do
+                return player:GetRottenHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.BROKEN
+        if ____cond25 then
+            do
+                return player:GetBrokenHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.MAX_HEARTS
+        if ____cond25 then
+            do
+                return player:GetMaxHearts()
+            end
+        end
+        do
+            do
+                return ensureAllCases(nil, healthType)
+            end
+        end
+    until true
+end
 function ____exports.setPlayerHealth(self, player, playerHealth)
     local character = player:GetPlayerType()
     local subPlayer = player:GetSubPlayer()

package/dist/functions/rooms.lua

@@ -221,10 +221,8 @@ function ____exports.inLRoom(self)
     return roomShape == RoomShape.ROOMSHAPE_LTL or roomShape == RoomShape.ROOMSHAPE_LTR or roomShape == RoomShape.ROOMSHAPE_LBL or roomShape == RoomShape.ROOMSHAPE_LBR
 end
 function ____exports.inGenesisRoom(self)
-    local room = game:GetRoom()
-    local roomType = room:GetType()
-    local roomSubType = ____exports.getRoomSubType(nil)
-    return roomType == RoomType.ROOM_ISAACS and roomSubType == 99
+    local roomGridIndex = ____exports.getRoomGridIndex(nil)
+    return roomGridIndex == GridRooms.ROOM_GENESIS_IDX
 end
 function ____exports.inMegaSatanRoom(self)
     local roomGridIndex = ____exports.getRoomGridIndex(nil)
@@ -238,7 +236,8 @@ function ____exports.inMinibossRoomOf(self, minibossID)
     return roomType == RoomType.ROOM_MINIBOSS and roomStageID == 0 and roomSubType == minibossID
 end
 function ____exports.inSecretShop(self)
-    return ____exports.getRoomGridIndex(nil) == GridRooms.ROOM_SECRET_SHOP_IDX
+    local roomGridIndex = ____exports.getRoomGridIndex(nil)
+    return roomGridIndex == GridRooms.ROOM_SECRET_SHOP_IDX
 end
 function ____exports.inStartingRoom(self)
     local level = game:GetLevel()

package/dist/functions/run.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="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/dist/functions/run.lua

@@ -0,0 +1,25 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+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.CHALLENGE_NULL and customRun
+end
+function ____exports.restart(self, character)
+    if character == nil then
+        log("Restarting.")
+        Isaac.ExecuteCommand("restart")
+        return
+    end
+    if character < 0 or character >= PlayerType.NUM_PLAYER_TYPES 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/dist/functions/utils.d.ts

@@ -71,12 +71,6 @@ export declare function hexToKColor(hexString: string, alpha: float): KColor;
  * is enabled or not.
  */
 export declare function isLuaDebugEnabled(): boolean;
-/**
- * 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 print something to the in-game console. Use this instead of invoking the
  * `Isaac.ConsoleOutput` method directly because it will automatically insert a newline at the end

package/dist/functions/utils.lua

@@ -5,8 +5,6 @@ local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__StringReplace = ____lualib.__TS__StringReplace
 local __TS__StringSubstr = ____lualib.__TS__StringSubstr
 local ____exports = {}
-local ____cachedClasses = require("cachedClasses")
-local game = ____cachedClasses.game
 local HEX_STRING_LENGTH = 6
 ____exports.ensureAllCases = function(____, obj) return obj end
 function ____exports.getEnumValues(self, transpiledEnum)
@@ -45,12 +43,6 @@ end
 function ____exports.isLuaDebugEnabled(self)
     return package ~= nil
 end
-function ____exports.onSetSeed(self)
-    local seeds = game:GetSeeds()
-    local customRun = seeds:IsCustomRun()
-    local challenge = Isaac.GetChallenge()
-    return challenge == Challenge.CHALLENGE_NULL and customRun
-end
 function ____exports.printConsole(self, msg)
     Isaac.ConsoleOutput(msg .. "\n")
 end

package/dist/functions/vector.lua

@@ -8,10 +8,10 @@ end
 function ____exports.directionToVector(self, direction)
     repeat
         local ____switch4 = direction
-        local ____cond4 = ____switch4 == Direction.DOWN
+        local ____cond4 = ____switch4 == Direction.NO_DIRECTION
         if ____cond4 then
             do
-                return Vector(0, 1)
+                return Vector.Zero
             end
         end
         ____cond4 = ____cond4 or ____switch4 == Direction.LEFT
@@ -20,22 +20,22 @@ function ____exports.directionToVector(self, direction)
                 return Vector(-1, 0)
             end
         end
-        ____cond4 = ____cond4 or ____switch4 == Direction.RIGHT
+        ____cond4 = ____cond4 or ____switch4 == Direction.UP
         if ____cond4 then
             do
-                return Vector(1, 0)
+                return Vector(0, -1)
             end
         end
-        ____cond4 = ____cond4 or ____switch4 == Direction.UP
+        ____cond4 = ____cond4 or ____switch4 == Direction.RIGHT
         if ____cond4 then
             do
-                return Vector(0, -1)
+                return Vector(1, 0)
             end
         end
-        ____cond4 = ____cond4 or ____switch4 == Direction.NO_DIRECTION
+        ____cond4 = ____cond4 or ____switch4 == Direction.DOWN
         if ____cond4 then
             do
-                return Vector.Zero
+                return Vector(0, 1)
             end
         end
         do