isaacscript-common 6.2.1 → 6.3.0

package/features/debugDisplay/v.lua

@@ -10,6 +10,15 @@ end
 function defaultGridEntityDisplayCallback(self, gridEntity)
     return getGridEntityID(nil, gridEntity)
 end
+local debugDisplayEnabled = false
+function ____exports.setDebugDisplayEnabled(self)
+    debugDisplayEnabled = true
+end
+function ____exports.errorIfDebugDisplayNotInitialized(self)
+    if not debugDisplayEnabled then
+        error("The \"debugDisplay\" feature is not initialized. You must run the \"enableExtraConsoleCommands\" function once at the beginning of your mod in order for this feature to work.")
+    end
+end
 local v = {run = {
     player = false,
     tear = false,

package/features/extraConsoleCommands/init.lua

@@ -1,7 +1,7 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local ____exports = {}
-local initMap, initCallbacks, postUpdate, evaluateCacheFireDelay, evaluateCacheSpeed, entityTakeDmgPlayer, postCurseEval, executeCmd, postFireTear
+local initMap, initCallbacks, postUpdate, evaluateCacheFireDelay, evaluateCacheSpeed, evaluateCacheFlying, entityTakeDmgPlayer, postCurseEval, executeCmd, postFireTear
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
@@ -72,6 +72,7 @@ function initMap(self)
     extraConsoleCommandsFunctionMap:set("eternalHearts", commands.eternalHearts)
     extraConsoleCommandsFunctionMap:set("familiarDisplay", commandsDisplay.familiarDisplay)
     extraConsoleCommandsFunctionMap:set("familiarsDisplay", commandsDisplay.familiarsDisplay)
+    extraConsoleCommandsFunctionMap:set("flight", commands.flight)
     extraConsoleCommandsFunctionMap:set("fool", commands.fool)
     extraConsoleCommandsFunctionMap:set("getPosition", commands.getPosition)
     extraConsoleCommandsFunctionMap:set("gigaBomb", commands.gigaBomb)
@@ -174,6 +175,7 @@ function initCallbacks(self, mod)
     mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheFireDelay, CacheFlag.FIRE_DELAY)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheSpeed, CacheFlag.SPEED)
+    mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheFlying, CacheFlag.FLYING)
     mod:AddCallback(ModCallback.ENTITY_TAKE_DMG, entityTakeDmgPlayer, EntityType.PLAYER)
     mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)
     mod:AddCallback(ModCallback.EXECUTE_CMD, executeCmd)
@@ -195,6 +197,11 @@ function evaluateCacheSpeed(self, player)
         player.MoveSpeed = MAX_SPEED_STAT
     end
 end
+function evaluateCacheFlying(self, player)
+    if v.run.flight then
+        player.CanFly = true
+    end
+end
 function entityTakeDmgPlayer(self)
     if v.run.spamBloodRights then
         return false

package/features/extraConsoleCommands/listCommands.d.ts

@@ -65,7 +65,10 @@ export declare function card(params: string): void;
 export declare function cards(): void;
 /** Alias for the "chaosCardTears" command. */
 export declare function cc(): void;
-/** Toggles Chaos Card tears. Useful for killing enemies very fast without using "debug 10". */
+/**
+ * Toggles Chaos Card tears for the player. Useful for killing enemies very fast without using
+ * "debug 10".
+ */
 export declare function chaosCardTears(): void;
 /**
  * Restart as the specified character. Accepts either the character sub-type or the partial name of
@@ -96,7 +99,7 @@ export declare function crawlSpace(): void;
 export declare function d20(): void;
 /** Uses the D6. */
 export declare function d6(): void;
-/** Toggles extremely high-damage tears. */
+/** Toggles extremely high-damage tears for the player. */
 export declare function damage(): void;
 /** Alias for the "devil" command. */
 export declare function dd(): void;
@@ -124,6 +127,8 @@ export declare function error(): void;
  * numbers to remove hearts.)
  */
 export declare function eternalHearts(params: string): void;
+/** Toggles flight for the player. */
+export declare function flight(params: string): void;
 /** Alias for the "startingRoom" command. */
 export declare function fool(): void;
 /** Prints the current position of all players. */
@@ -324,13 +329,16 @@ export declare function sounds(): void;
 export declare function spam(): void;
 /** Spawns a golden version of the specified trinket type. */
 export declare function spawnGoldenTrinket(params: string): void;
-/** Toggles maximum movement speed and flight. */
+/** Toggles maximum movement speed and flight for the player. */
 export declare function speed(): void;
 /** Warps to the starting room of the floor. */
 export declare function startingRoom(): void;
 /** Warps to the first Super Secret Room on the floor. */
 export declare function superSecret(): void;
-/** Toggles extremely high tears stat (e.g. fire rate), equivalent of that to soy milk. */
+/**
+ * Toggles an extremely high tears stat (e.g. fire rate) for the player, equivalent of that to soy
+ * milk.
+ */
 export declare function tears(): void;
 /** Creates a trapdoor next to the player. */
 export declare function trapdoorCommand(): void;

package/features/extraConsoleCommands/listCommands.lua

@@ -64,7 +64,9 @@ local spawnTrinket = ____pickups.spawnTrinket
 local ____pills = require("functions.pills")
 local getPillEffectName = ____pills.getPillEffectName
 local ____player = require("functions.player")
+local addCollectibleCostume = ____player.addCollectibleCostume
 local getPlayerName = ____player.getPlayerName
+local removeCollectibleCostume = ____player.removeCollectibleCostume
 local useActiveItemTemp = ____player.useActiveItemTemp
 local ____playerIndex = require("functions.playerIndex")
 local getPlayers = ____playerIndex.getPlayers
@@ -104,7 +106,8 @@ local v = ____v.default
 function ____exports.blackHearts(self, params)
     addHeart(nil, params, HealthType.BLACK)
 end
---- Toggles Chaos Card tears. Useful for killing enemies very fast without using "debug 10".
+--- Toggles Chaos Card tears for the player. Useful for killing enemies very fast without using
+-- "debug 10".
 function ____exports.chaosCardTears(self)
     v.run.chaosCardTears = not v.run.chaosCardTears
     printEnabled(nil, v.run.chaosCardTears, "Chaos Card tears")
@@ -480,7 +483,7 @@ function ____exports.d6(self)
     local player = Isaac.GetPlayer()
     useActiveItemTemp(nil, player, CollectibleType.D6)
 end
---- Toggles extremely high-damage tears.
+--- Toggles extremely high-damage tears for the player.
 function ____exports.damage(self)
     v.run.maxDamage = not v.run.maxDamage
     printEnabled(nil, v.run.maxDamage, "debug damage")
@@ -520,6 +523,25 @@ end
 function ____exports.error(self)
     ____exports.iAmError(nil)
 end
+--- Toggles flight for the player.
+function ____exports.flight(self, params)
+    local player = Isaac.GetPlayer()
+    v.run.flight = not v.run.flight
+    if params == "true" then
+        v.run.flight = true
+    elseif params == "false" then
+        v.run.flight = false
+    end
+    player:AddCacheFlags(CacheFlag.FLYING)
+    player:EvaluateItems()
+    local collectibleUsedToShowFlight = CollectibleType.FATE
+    if v.run.flight then
+        addCollectibleCostume(nil, player, collectibleUsedToShowFlight)
+    else
+        removeCollectibleCostume(nil, player, collectibleUsedToShowFlight)
+    end
+    printEnabled(nil, v.run.maxSpeed, "max speed")
+end
 --- Alias for the "startingRoom" command.
 function ____exports.fool(self)
     ____exports.startingRoom(nil)
@@ -1018,29 +1040,22 @@ function ____exports.spawnGoldenTrinket(self, params)
     local centerPos = room:GetCenterPos()
     spawnTrinket(nil, goldenTrinketType, centerPos)
 end
---- Toggles maximum movement speed and flight.
+--- Toggles maximum movement speed and flight for the player.
 function ____exports.speed(self)
     local player = Isaac.GetPlayer()
     v.run.maxSpeed = not v.run.maxSpeed
-    if v.run.maxSpeed and not player.CanFly then
-        local numEternalHearts = player:GetEternalHearts()
-        if numEternalHearts == 0 then
-            player:AddCollectible(CollectibleType.FATE)
-            player:AddEternalHearts(-1)
-        else
-            player:AddEternalHearts(-1)
-            player:AddCollectible(CollectibleType.FATE)
-        end
-    end
     player:AddCacheFlags(CacheFlag.SPEED)
     player:EvaluateItems()
-    printEnabled(nil, v.run.maxSpeed, "max speed")
+    local value = tostring(v.run.maxSpeed)
+    ____exports.flight(nil, value)
+    printEnabled(nil, v.run.maxSpeed, "max speed and flight")
 end
 --- Warps to the first Super Secret Room on the floor.
 function ____exports.superSecret(self)
     warpToRoomType(nil, RoomType.SUPER_SECRET)
 end
---- Toggles extremely high tears stat (e.g. fire rate), equivalent of that to soy milk.
+--- Toggles an extremely high tears stat (e.g. fire rate) for the player, equivalent of that to soy
+-- milk.
 function ____exports.tears(self)
     v.run.maxTears = not v.run.maxTears
     local player = Isaac.GetPlayer()

package/features/extraConsoleCommands/v.d.ts

@@ -8,6 +8,7 @@ declare const v: {
         maxDamage: boolean;
         maxSpeed: boolean;
         maxTears: boolean;
+        flight: boolean;
     };
 };
 export default v;

package/features/extraConsoleCommands/v.lua

@@ -7,7 +7,8 @@ local v = {persistent = {disableCurses = false}, run = {
     spamBloodRights = false,
     maxDamage = false,
     maxSpeed = false,
-    maxTears = false
+    maxTears = false,
+    flight = false
 }}
 ____exports.default = v
 --- The contents of the map are initialized in the "init.ts" file.

package/features/pause.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helper function to emulate what happens when the player pauses the game. Use the `unpause`
+ * function to return things back to normal.
+ *
+ * Under the hood, this function:
+ * - uses the Pause collectible on every game frame
+ * - disables any player inputs (except for `ButtonAction.MENU_CONFIRM`)
+ */
+export declare function pause(): void;
+/** Helper function to put things back to normal after the `pause` function was used. */
+export declare function unpause(): void;

package/features/pause.lua

@@ -0,0 +1,71 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postUpdate, inputActionGetActionValue, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local InputHook = ____isaac_2Dtypescript_2Ddefinitions.InputHook
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____log = require("functions.log")
+local logError = ____log.logError
+local ____player = require("functions.player")
+local useActiveItemTemp = ____player.useActiveItemTemp
+local ____disableInputs = require("features.disableInputs")
+local disableAllInputsExceptFor = ____disableInputs.disableAllInputsExceptFor
+local enableAllInputs = ____disableInputs.enableAllInputs
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postUpdate(self)
+    if not v.run.isPseudoPaused then
+        return
+    end
+    local player = Isaac.GetPlayer()
+    useActiveItemTemp(nil, player, CollectibleType.PAUSE)
+end
+function inputActionGetActionValue(self, _entity, _inputHook, buttonAction)
+    if buttonAction ~= ButtonAction.SHOOT_RIGHT then
+        return
+    end
+    if not v.run.shouldUnpause then
+        return
+    end
+    v.run.shouldUnpause = false
+    return 1
+end
+local FEATURE_NAME = "pause"
+v = {run = {isPseudoPaused = false, shouldUnpause = false}}
+---
+-- @internal
+function ____exports.pauseInit(self, mod)
+    saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
+    mod:AddCallback(ModCallback.INPUT_ACTION, inputActionGetActionValue, InputHook.GET_ACTION_VALUE)
+end
+--- Helper function to emulate what happens when the player pauses the game. Use the `unpause`
+-- function to return things back to normal.
+-- 
+-- Under the hood, this function:
+-- - uses the Pause collectible on every game frame
+-- - disables any player inputs (except for `ButtonAction.MENU_CONFIRM`)
+function ____exports.pause(self)
+    if v.run.isPseudoPaused then
+        logError("Failed to pseudo-pause the game, since it was already pseudo-paused.")
+        return
+    end
+    v.run.isPseudoPaused = true
+    local whitelist = __TS__New(Set, {ButtonAction.MENU_CONFIRM})
+    disableAllInputsExceptFor(nil, FEATURE_NAME, whitelist)
+end
+--- Helper function to put things back to normal after the `pause` function was used.
+function ____exports.unpause(self)
+    if not v.run.isPseudoPaused then
+        logError("Failed to pseudo-unpause the game, since it was not already pseudo-paused.")
+        return
+    end
+    v.run.isPseudoPaused = false
+    enableAllInputs(nil, FEATURE_NAME)
+    v.run.shouldUnpause = true
+end
+return ____exports

package/features/runNextRoom.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Supply a function to run on the next `POST_NEW_ROOM` callback.
+ *
+ * Note that this function will not handle saving and quitting. If a player saving and quitting
+ * before the deferred function fires would cause a bug in your mod, then you should handle deferred
+ * functions manually using serializable data.
+ */
+export declare function runNextRoom(func: () => void): void;

package/features/runNextRoom.lua

@@ -0,0 +1,40 @@
+local ____exports = {}
+local postNewRoomReordered, v
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____array = require("functions.array")
+local emptyArray = ____array.emptyArray
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postNewRoomReordered(self)
+    for ____, func in ipairs(v.run.queuedFunctions) do
+        func(nil)
+    end
+    emptyArray(nil, v.run.queuedFunctions)
+end
+local FEATURE_NAME = "runNextRoom"
+v = {run = {queuedFunctions = {}}}
+---
+-- @internal
+function ____exports.runNextRoomInit(self, mod)
+    saveDataManager(
+        nil,
+        FEATURE_NAME,
+        v,
+        function() return false end
+    )
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
+end
+--- Supply a function to run on the next `POST_NEW_ROOM` callback.
+-- 
+-- Note that this function will not handle saving and quitting. If a player saving and quitting
+-- before the deferred function fires would cause a bug in your mod, then you should handle deferred
+-- functions manually using serializable data.
+function ____exports.runNextRoom(self, func)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local ____v_run_queuedFunctions_0 = v.run.queuedFunctions
+    ____v_run_queuedFunctions_0[#____v_run_queuedFunctions_0 + 1] = func
+end
+return ____exports

package/functions/chargeBar.lua

@@ -1,7 +1,5 @@
 local ____exports = {}
 local getChargeBarClamp
-local ____constants = require("constants")
-local VectorZero = ____constants.VectorZero
 function getChargeBarClamp(self, charges, maxCharges)
     local meterMultiplier = 24 / maxCharges
     local meterClip = 26 - charges * meterMultiplier
@@ -37,11 +35,11 @@ end
 --- Helper function to render a charge bar on the screen. First, call the `newChargeBarSprites`
 -- function to initialize the sprites, and then call this function on every render frame.
 function ____exports.renderChargeBar(self, sprites, position, normalCharges, batteryCharges)
-    sprites.back:Render(position, VectorZero, VectorZero)
+    sprites.back:Render(position)
     local normalChargesClamp = getChargeBarClamp(nil, normalCharges, sprites.maxCharges)
-    sprites.meter:Render(position, normalChargesClamp, VectorZero)
+    sprites.meter:Render(position, normalChargesClamp)
     local batteryChargesClamp = getChargeBarClamp(nil, batteryCharges, sprites.maxCharges)
-    sprites.meterBattery:Render(position, batteryChargesClamp, VectorZero)
-    sprites.lines:Render(position, VectorZero, VectorZero)
+    sprites.meterBattery:Render(position, batteryChargesClamp)
+    sprites.lines:Render(position)
 end
 return ____exports

package/functions/direction.d.ts

@@ -8,5 +8,5 @@ import { Direction } from "isaac-typescript-definitions";
  */
 export declare function angleToDirection(angleDegrees: int): Direction;
 export declare function directionToDegrees(direction: Direction): int;
-export declare function directionToVector(direction: Direction): Vector;
+export declare function directionToVector(direction: Direction): Readonly<Vector>;
 export declare function getDirectionName(direction: Direction): string | undefined;

package/functions/doors.d.ts

@@ -22,7 +22,7 @@ export declare function getDevilRoomOrAngelRoomDoor(): GridEntityDoor | undefine
  * they would immediately collide with the loading zone. Instead, they are offset by a certain
  * amount of units.
  */
-export declare function getDoorEnterPosition(door: GridEntityDoor): Vector;
+export declare function getDoorEnterPosition(door: GridEntityDoor): Readonly<Vector>;
 /**
  * Helper function to get the offset from a door position that a player will enter a room at.
  *
@@ -30,7 +30,7 @@ export declare function getDoorEnterPosition(door: GridEntityDoor): Vector;
  * they would immediately collide with the loading zone. Instead, they are offset by a certain
  * amount of units.
  */
-export declare function getDoorSlotEnterPositionOffset(doorSlot: DoorSlot): Vector;
+export declare function getDoorSlotEnterPositionOffset(doorSlot: DoorSlot): Readonly<Vector>;
 /**
  * Helper function to convert an array of door slots or a set of door slots to the resulting bit
  * flag number.

package/functions/playerCenter.lua

@@ -4,6 +4,9 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local ____constants = require("constants")
+local NEW_FLOOR_STARTING_POSITION_GREED_MODE = ____constants.NEW_FLOOR_STARTING_POSITION_GREED_MODE
+local NEW_FLOOR_STARTING_POSITION_NORMAL_MODE = ____constants.NEW_FLOOR_STARTING_POSITION_NORMAL_MODE
 local ____familiars = require("functions.familiars")
 local getPlayerFamiliars = ____familiars.getPlayerFamiliars
 local ____math = require("functions.math")
@@ -17,10 +20,6 @@ function movePlayerAndTheirFamiliars(self, player, position)
         familiar.Position = position
     end
 end
---- This is in the center of the room.
-local NORMAL_MODE_NEW_FLOOR_STARTING_POSITION = Vector(320, 380)
---- This is near the top door.
-local GREED_MODE_NEW_FLOOR_STARTING_POSITION = Vector(320, 280)
 local CIRCLE_RADIUS_BETWEEN_PLAYERS = 50
 --- Helper function to move all of the players to where they would normally go when arriving at a new
 -- floor. (In normal mode, this is the center of the room. In Greed Mode, this is below the top
@@ -31,7 +30,7 @@ local CIRCLE_RADIUS_BETWEEN_PLAYERS = 50
 -- This function emulates what happens in the vanilla game when you travel to a new floor.
 function ____exports.movePlayersToCenter(self)
     local isGreedMode = game:IsGreedMode()
-    local startingPosition = isGreedMode and GREED_MODE_NEW_FLOOR_STARTING_POSITION or NORMAL_MODE_NEW_FLOOR_STARTING_POSITION
+    local startingPosition = isGreedMode and NEW_FLOOR_STARTING_POSITION_GREED_MODE or NEW_FLOOR_STARTING_POSITION_NORMAL_MODE
     local players = getPlayers(nil)
     local firstPlayer = players[1]
     if firstPlayer == nil then

package/functions/playerIndex.d.ts

@@ -44,6 +44,9 @@ export declare function getPlayerIndex(player: EntityPlayer, differentiateForgot
 /**
  * Helper function to return the index of this player with respect to the output of the
  * `Isaac.GetPlayer` method.
+ *
+ * Note that if you storing information about a player in a data structure, you never want to use
+ * this index; use the `getPlayerIndex` function instead.
  */
 export declare function getPlayerIndexVanilla(playerToFind: EntityPlayer): int | undefined;
 /**

package/functions/playerIndex.lua

@@ -155,6 +155,9 @@ function ____exports.getPlayerFromIndex(self, playerIndex)
 end
 --- Helper function to return the index of this player with respect to the output of the
 -- `Isaac.GetPlayer` method.
+-- 
+-- Note that if you storing information about a player in a data structure, you never want to use
+-- this index; use the `getPlayerIndex` function instead.
 function ____exports.getPlayerIndexVanilla(self, playerToFind)
     local numPlayers = game:GetNumPlayers()
     local playerToFindHash = GetPtrHash(playerToFind)

package/functions/roomShape.d.ts

@@ -1,4 +1,5 @@
 import { DoorSlot, RoomShape } from "isaac-typescript-definitions";
+import { Corner } from "../interfaces/Corner";
 /**
  * Helper function to get the grid index delta that a door out of the given room shape would lead
  * to. For example, if you went through the bottom door in a room of `RoomShape.SHAPE_1x2`, you
@@ -12,7 +13,7 @@ export declare function getGridIndexDelta(roomShape: RoomShape, doorSlot: DoorSl
  *
  * For example, `RoomShape.SHAPE_2x2` will return 2.
  */
-export declare function getRoomShapeBottomRightPosition(roomShape: RoomShape): Vector;
+export declare function getRoomShapeBottomRightPosition(roomShape: RoomShape): Readonly<Vector>;
 /**
  * Helper function to get the grid position of the bottom-right tile of a given room shape.
  *
@@ -21,10 +22,14 @@ export declare function getRoomShapeBottomRightPosition(roomShape: RoomShape): V
  */
 export declare function getRoomShapeBounds(roomShape: RoomShape): readonly [width: int, height: int];
 /**
- * Helper function to get the bounds of a room shape, which are a box representing its contents.
- * This does not include the tiles that the walls are on. L rooms use the same bounds as a 2x2 room.
+ * Helper function to get the number of charges that a given room shape will grant to a player upon
+ * clearing it.
+ *
+ * For example, `RoomShape.SHAPE_2x2` will return 2.
  */
 export declare function getRoomShapeCharges(roomShape: RoomShape): int;
+/** Helper function to get the corners that exist in the given room shape. */
+export declare function getRoomShapeCorners(roomShape: RoomShape): readonly Corner[];
 /**
  * Helper function to get the dimensions of a room shape's layout. This is NOT the size of the
  * room's actual contents! For that, use the `getRoomShapeBounds` function.
@@ -38,7 +43,7 @@ export declare function getRoomShapeLayoutSize(roomShape: RoomShape): readonly [
  * "Vector(0, 0)" corresponds to the top left tile of a room, not including the walls. (The top-left
  * wall would be at "Vector(-1, -1)".)
  */
-export declare function getRoomShapeTopLeftPosition(roomShape: RoomShape): Vector;
+export declare function getRoomShapeTopLeftPosition(roomShape: RoomShape): Readonly<Vector>;
 /**
  * Helper function to get the volume of a room shape, which is the amount of tiles that are inside
  * the room.
@@ -48,6 +53,7 @@ export declare function getRoomShapeTopLeftPosition(roomShape: RoomShape): Vecto
 export declare function getRoomShapeVolume(roomShape: RoomShape): int;
 export declare function getRoomShapeWidth(roomShape: RoomShape): int;
 export declare function isLRoom(roomShape: RoomShape): boolean;
+export declare function isNarrowRoom(roomShape: RoomShape): boolean;
 /**
  * Helper function to see if a given room shape will grant a single charge or a double charge to the
  * player's active item(s).

package/functions/roomShape.lua

@@ -5,6 +5,8 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
 local ____roomShapeBounds = require("objects.roomShapeBounds")
 local ROOM_SHAPE_BOUNDS = ____roomShapeBounds.ROOM_SHAPE_BOUNDS
+local ____roomShapeCorners = require("objects.roomShapeCorners")
+local ROOM_SHAPE_CORNERS = ____roomShapeCorners.ROOM_SHAPE_CORNERS
 local ____roomShapeLayoutSizes = require("objects.roomShapeLayoutSizes")
 local ROOM_SHAPE_LAYOUT_SIZES = ____roomShapeLayoutSizes.ROOM_SHAPE_LAYOUT_SIZES
 local ____roomShapeToBottomRightPosition = require("objects.roomShapeToBottomRightPosition")
@@ -19,6 +21,8 @@ local ____roomShapeVolumes = require("objects.roomShapeVolumes")
 local ROOM_SHAPE_VOLUMES = ____roomShapeVolumes.ROOM_SHAPE_VOLUMES
 local ____LRoomShapesSet = require("sets.LRoomShapesSet")
 local L_ROOM_SHAPES_SET = ____LRoomShapesSet.L_ROOM_SHAPES_SET
+local ____narrowRoomShapesSet = require("sets.narrowRoomShapesSet")
+local NARROW_ROOM_SHAPES_SET = ____narrowRoomShapesSet.NARROW_ROOM_SHAPES_SET
 --- Helper function to see if a given room shape will grant a single charge or a double charge to the
 -- player's active item(s).
 -- 
@@ -48,11 +52,17 @@ end
 function ____exports.getRoomShapeBounds(self, roomShape)
     return ROOM_SHAPE_BOUNDS[roomShape]
 end
---- Helper function to get the bounds of a room shape, which are a box representing its contents.
--- This does not include the tiles that the walls are on. L rooms use the same bounds as a 2x2 room.
+--- Helper function to get the number of charges that a given room shape will grant to a player upon
+-- clearing it.
+-- 
+-- For example, `RoomShape.SHAPE_2x2` will return 2.
 function ____exports.getRoomShapeCharges(self, roomShape)
     return ____exports.isRoomShapeDoubleCharge(nil, roomShape) and 2 or 1
 end
+--- Helper function to get the corners that exist in the given room shape.
+function ____exports.getRoomShapeCorners(self, roomShape)
+    return ROOM_SHAPE_CORNERS[roomShape]
+end
 --- Helper function to get the dimensions of a room shape's layout. This is NOT the size of the
 -- room's actual contents! For that, use the `getRoomShapeBounds` function.
 -- 
@@ -80,4 +90,7 @@ end
 function ____exports.isLRoom(self, roomShape)
     return L_ROOM_SHAPES_SET:has(roomShape)
 end
+function ____exports.isNarrowRoom(self, roomShape)
+    return NARROW_ROOM_SHAPES_SET:has(roomShape)
+end
 return ____exports

package/functions/sprite.d.ts

@@ -2,7 +2,7 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
 /**
- * Helper function to clear a specific layer from a sprite.
+ * Helper function to clear all layers or specific layers from a sprite.
  *
  * This function is variadic, so pass as many layer IDs as you want to clear. If no specific layers
  * are passed, it will clear every layer.

package/functions/sprite.lua

@@ -12,7 +12,7 @@ function ____exports.texelEquals(self, sprite1, sprite2, position, layerID)
     local kColor2 = sprite2:GetTexel(position, VectorZero, 1, layerID)
     return kColorEquals(nil, kColor1, kColor2)
 end
---- Helper function to clear a specific layer from a sprite.
+--- Helper function to clear all layers or specific layers from a sprite.
 -- 
 -- This function is variadic, so pass as many layer IDs as you want to clear. If no specific layers
 -- are passed, it will clear every layer.

package/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./cachedClasses";
 export { initCustomDoor, spawnCustomDoor, } from "./callbacks/postCustomDoorEnter";
-export { forceNewLevelCallback, forceNewRoomCallback, } from "./callbacks/reorderedCallbacks";
+export { forceNewLevelCallback, forceNewRoomCallback, reorderedCallbacksSetStage, } from "./callbacks/reorderedCallbacks";
 export * from "./classes/DefaultMap";
 export * from "./classes/ModUpgraded";
 export * from "./constants";

package/index.lua

@@ -18,8 +18,10 @@ do
     local ____reorderedCallbacks = require("callbacks.reorderedCallbacks")
     local forceNewLevelCallback = ____reorderedCallbacks.forceNewLevelCallback
     local forceNewRoomCallback = ____reorderedCallbacks.forceNewRoomCallback
+    local reorderedCallbacksSetStage = ____reorderedCallbacks.reorderedCallbacksSetStage
     ____exports.forceNewLevelCallback = forceNewLevelCallback
     ____exports.forceNewRoomCallback = forceNewRoomCallback
+    ____exports.reorderedCallbacksSetStage = reorderedCallbacksSetStage
 end
 do
     local ____export = require("classes.DefaultMap")

package/initFeatures.lua

@@ -21,6 +21,8 @@ local ____fastReset = require("features.fastReset")
 local fastResetInit = ____fastReset.fastResetInit
 local ____forgottenSwitch = require("features.forgottenSwitch")
 local forgottenSwitchInit = ____forgottenSwitch.forgottenSwitchInit
+local ____pause = require("features.pause")
+local pauseInit = ____pause.pauseInit
 local ____persistentEntities = require("features.persistentEntities")
 local persistentEntitiesInit = ____persistentEntities.persistentEntitiesInit
 local ____playerInventory = require("features.playerInventory")
@@ -35,6 +37,8 @@ local ____roomClearFrame = require("features.roomClearFrame")
 local roomClearFrameInit = ____roomClearFrame.roomClearFrameInit
 local ____runInNFrames = require("features.runInNFrames")
 local runInNFramesInit = ____runInNFrames.runInNFramesInit
+local ____runNextRoom = require("features.runNextRoom")
+local runNextRoomInit = ____runNextRoom.runNextRoomInit
 local ____sirenHelpers = require("features.sirenHelpers")
 local sirenHelpersInit = ____sirenHelpers.sirenHelpersInit
 local ____stageHistory = require("features.stageHistory")
@@ -42,7 +46,7 @@ local stageHistoryInit = ____stageHistory.stageHistoryInit
 local ____taintedLazarusPlayers = require("features.taintedLazarusPlayers")
 local taintedLazarusPlayersInit = ____taintedLazarusPlayers.taintedLazarusPlayersInit
 function ____exports.initFeaturesMajor(self, mod)
-    customStageInit(nil)
+    customStageInit(nil, mod)
     deployJSONRoomInit(nil, mod)
     runInNFramesInit(nil, mod)
     characterStatsInit(nil, mod)
@@ -56,12 +60,14 @@ function ____exports.initFeaturesMinor(self, mod)
     fastResetInit(nil, mod)
     forgottenSwitchInit(nil, mod)
     collectibleItemPoolTypeInit(nil, mod)
+    pauseInit(nil, mod)
     persistentEntitiesInit(nil, mod)
     playerInventoryInit(nil, mod)
     ponyDetectionInit(nil, mod)
     preventCollectibleRotationInit(nil, mod)
     registerHotkeyInit(nil, mod)
     roomClearFrameInit(nil, mod)
+    runNextRoomInit(nil, mod)
     sirenHelpersInit(nil, mod)
     stageHistoryInit(nil, mod)
     taintedLazarusPlayersInit(nil, mod)

package/interfaces/Corner.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="isaac-typescript-definitions" />
+import { CornerType } from "../enums/CornerType";
+export interface Corner {
+    readonly type: CornerType;
+    readonly position: Readonly<Vector>;
+}

package/interfaces/Corner.lua

@@ -0,0 +1,2 @@
+local ____exports = {}
+return ____exports