isaacscript-common 1.2.228 → 1.2.231

package/dist/features/deployJSONRoom.lua

@@ -38,8 +38,9 @@ local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
+local ____roomGrid = require("functions.roomGrid")
+local gridCoordinatesToWorldPosition = ____roomGrid.gridCoordinatesToWorldPosition
 local ____rooms = require("functions.rooms")
-local gridToPos = ____rooms.gridToPos
 local setRoomCleared = ____rooms.setRoomCleared
 local setRoomUncleared = ____rooms.setRoomUncleared
 local ____spawnCollectible = require("functions.spawnCollectible")
@@ -122,7 +123,7 @@ function fillRoomWithDecorations(self)
     local gridSize = room:GetGridSize()
     local roomListIndex = getRoomListIndex(nil)
     local decorationGridIndexes = v.level.roomToDecorationGridIndexesMap:getAndSetDefault(roomListIndex)
-    for ____, gridIndex in ipairs(range(nil, 0, gridSize - 1)) do
+    for ____, gridIndex in ipairs(range(nil, gridSize - 1)) do
         do
             local existingGridEntity = room:GetGridEntity(gridIndex)
             if existingGridEntity ~= nil then
@@ -219,7 +220,7 @@ function spawnGridEntityForJSONRoom(self, xmlEntityType, xmlEntityVariant, x, y)
         return nil
     end
     local gridEntityType, variant = table.unpack(gridEntityTuple)
-    local position = gridToPos(nil, x, y)
+    local position = gridCoordinatesToWorldPosition(nil, x, y)
     local gridIndex = room:GetGridIndex(position)
     local gridEntity = spawnGridEntityWithVariant(nil, gridEntityType, variant, gridIndex)
     if gridEntity == nil then
@@ -235,7 +236,7 @@ end
 function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y, rng)
     local room = game:GetRoom()
     local roomType = room:GetType()
-    local position = gridToPos(nil, x, y)
+    local position = gridCoordinatesToWorldPosition(nil, x, y)
     local seed = rng:Next()
     local entity
     if entityType == EntityType.ENTITY_PICKUP and variant == 100 then

package/dist/features/extraConsoleCommands/commands.lua

@@ -41,10 +41,11 @@ local getPlayers = ____playerIndex.getPlayers
 local ____roomData = require("functions.roomData")
 local getRoomData = ____roomData.getRoomData
 local getRoomDescriptor = ____roomData.getRoomDescriptor
+local ____roomGrid = require("functions.roomGrid")
+local gridCoordinatesToWorldPosition = ____roomGrid.gridCoordinatesToWorldPosition
 local ____rooms = require("functions.rooms")
 local changeRoom = ____rooms.changeRoom
 local getRoomGridIndexesForType = ____rooms.getRoomGridIndexesForType
-local gridToPos = ____rooms.gridToPos
 local ____run = require("functions.run")
 local restart = ____run.restart
 local ____utils = require("functions.utils")
@@ -373,7 +374,7 @@ function ____exports.cards(self)
                     if cardType == Card.NUM_CARDS then
                         return
                     end
-                    local position = gridToPos(nil, x, y)
+                    local position = gridCoordinatesToWorldPosition(nil, x, y)
                     Isaac.Spawn(
                         EntityType.ENTITY_PICKUP,
                         300,
@@ -655,7 +656,7 @@ function ____exports.pills(self)
                     end
                     local horsePillColor = pillColor + PILL_GIANT_FLAG
                     local subType = horse and horsePillColor or pillColor
-                    local position = gridToPos(nil, x, y)
+                    local position = gridCoordinatesToWorldPosition(nil, x, y)
                     Isaac.Spawn(
                         EntityType.ENTITY_PICKUP,
                         70,

package/dist/functions/benchmark.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to benchmark the performance of a function.
+ *
+ * - If one function is supplied, it will simply report the average run time of the function.
+ * - If two functions are supplied, it will compare the average run times of the functions.
+ */
+export declare function benchmark(numTrials: int, function1: () => void, function2?: () => void): int[];

package/dist/functions/benchmark.lua

@@ -0,0 +1,38 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
+local ____exports = {}
+local ____log = require("functions.log")
+local log = ____log.log
+function ____exports.benchmark(self, numTrials, function1, function2)
+    local numFunctions = function2 == nil and 1 or 2
+    local functionsText = numFunctions == 1 and "1 function" or "2 functions"
+    log(((("Benchmarking " .. functionsText) .. " with ") .. tostring(numTrials)) .. " trials.")
+    local averages = {}
+    do
+        local i = 1
+        while i <= numFunctions do
+            local functionToUse = i == 1 and function1 or function2
+            if functionToUse == nil then
+                error("Failed to find the benchmarking function to use.")
+            end
+            local totalTimeMilliseconds = 0
+            do
+                local j = 0
+                while j < numTrials do
+                    local startTimeMilliseconds = Isaac.GetTime()
+                    functionToUse(nil)
+                    local endTimeMilliseconds = Isaac.GetTime()
+                    local elapsedTimeMilliseconds = endTimeMilliseconds - startTimeMilliseconds
+                    totalTimeMilliseconds = totalTimeMilliseconds + elapsedTimeMilliseconds
+                    j = j + 1
+                end
+            end
+            local averageTimeMilliseconds = totalTimeMilliseconds / numTrials
+            log(((("The average time of function " .. tostring(i)) .. " is: ") .. tostring(averageTimeMilliseconds)) .. " milliseconds")
+            __TS__ArrayPush(averages, averageTimeMilliseconds)
+            i = i + 1
+        end
+    end
+    return averages
+end
+return ____exports

package/dist/functions/chargeBar.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="isaac-typescript-definitions" />
+/** A collection of the four sprites necessary in order to render a charge bar. */
+export interface ChargeBarSprites {
+    back: Sprite;
+    meter: Sprite;
+    meterBattery: Sprite;
+    lines: Sprite;
+    maxCharges: int;
+}
+/**
+ * Constructor for a `ChargeBarSprites` object. For more information, see the `renderChargeBar`
+ * helper function.
+ */
+export declare function newChargeBarSprites(maxCharges: int): ChargeBarSprites;
+/**
+ * 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.
+ */
+export declare function renderChargeBar(sprites: ChargeBarSprites, position: Vector, normalCharges: int, batteryCharges: int): void;

package/dist/functions/chargeBar.lua

@@ -0,0 +1,42 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local getChargeBarClamp
+function getChargeBarClamp(self, charges, maxCharges)
+    local meterMultiplier = 24 / maxCharges
+    local meterClip = 26 - charges * meterMultiplier
+    return Vector(0, meterClip)
+end
+local CHARGE_BAR_ANM2 = "gfx/ui/ui_chargebar.anm2"
+function ____exports.newChargeBarSprites(self, maxCharges)
+    local back = Sprite()
+    back:Load(CHARGE_BAR_ANM2, true)
+    back:Play("BarEmpty", true)
+    local meter = Sprite()
+    meter:Load(CHARGE_BAR_ANM2, true)
+    meter:Play("BarFull", true)
+    local meterBattery = Sprite()
+    meterBattery:Load(CHARGE_BAR_ANM2, true)
+    meterBattery:Play("BarFull", true)
+    local lines = Sprite()
+    lines:Load(CHARGE_BAR_ANM2, true)
+    lines:Play(
+        "BarOverlay" .. tostring(maxCharges),
+        true
+    )
+    return {
+        back = back,
+        meter = meter,
+        meterBattery = meterBattery,
+        lines = lines,
+        maxCharges = maxCharges
+    }
+end
+function ____exports.renderChargeBar(self, sprites, position, normalCharges, batteryCharges)
+    sprites.back:Render(position, Vector.Zero, Vector.Zero)
+    local normalChargesClamp = getChargeBarClamp(nil, normalCharges, sprites.maxCharges)
+    sprites.meter:Render(position, normalChargesClamp, Vector.Zero)
+    local batteryChargesClamp = getChargeBarClamp(nil, batteryCharges, sprites.maxCharges)
+    sprites.meterBattery:Render(position, batteryChargesClamp, Vector.Zero)
+    sprites.lines:Render(position, Vector.Zero, Vector.Zero)
+end
+return ____exports

package/dist/functions/gridEntity.lua

@@ -29,7 +29,7 @@ function getAllGridEntities(self)
     local room = game:GetRoom()
     local gridSize = room:GetGridSize()
     local gridEntities = {}
-    for ____, gridIndex in ipairs(range(nil, 0, gridSize - 1)) do
+    for ____, gridIndex in ipairs(range(nil, gridSize - 1)) do
         local gridEntity = room:GetGridEntity(gridIndex)
         if gridEntity ~= nil then
             __TS__ArrayPush(gridEntities, gridEntity)

package/dist/functions/input.lua

@@ -84,14 +84,14 @@ function ____exports.getShootActions(self)
     return copySet(nil, SHOOTING_ACTIONS_SET)
 end
 function ____exports.isActionPressedOnAnyInput(self, buttonAction)
-    local validInputs = range(nil, 0, MAX_NUM_INPUTS - 1)
+    local validInputs = range(nil, MAX_NUM_INPUTS - 1)
     return __TS__ArraySome(
         validInputs,
         function(____, input) return Input.IsActionPressed(buttonAction, input) end
     )
 end
 function ____exports.isActionTriggeredOnAnyInput(self, buttonAction)
-    local validInputs = range(nil, 0, MAX_NUM_INPUTS - 1)
+    local validInputs = range(nil, MAX_NUM_INPUTS - 1)
     return __TS__ArraySome(
         validInputs,
         function(____, input) return Input.IsActionTriggered(buttonAction, input) end

package/dist/functions/log.lua

@@ -380,7 +380,7 @@ function ____exports.logSet(set)
     ____exports.log("The size of the set was: " .. tostring(set.size))
 end
 function ____exports.logSounds()
-    for ____, soundEffect in ipairs(range(nil, 0, SoundEffect.NUM_SOUND_EFFECTS - 1)) do
+    for ____, soundEffect in ipairs(range(nil, SoundEffect.NUM_SOUND_EFFECTS - 1)) do
         if sfxManager:IsPlaying(soundEffect) then
             ____exports.log("Currently playing sound effect: " .. tostring(soundEffect))
         end

package/dist/functions/math.d.ts

@@ -15,8 +15,10 @@ export declare function getAngleDifference(angle1: float, angle2: float): float;
  */
 export declare function getCircleDiscretizedPoints(centerPos: Vector, radius: float, numPoints: int, xMultiplier?: number, yMultiplier?: number, initialDirection?: Direction): Vector[];
 /**
- * Helper function to check if a given position is within a given rectangle. This is an inclusive
- * check, meaning that it will return true if the position is on the border of the rectangle.
+ * Helper function to check if a given position is within a given rectangle.
+ *
+ * This is an inclusive check, meaning that it will return true if the position is on the border of
+ * the rectangle.
  */
 export declare function inRectangle(position: Vector, topLeft: Vector, bottomRight: Vector): boolean;
 /**
@@ -27,8 +29,12 @@ export declare function isEven(num: int): boolean;
 export declare function isOdd(num: int): boolean;
 export declare function lerp(a: number, b: number, pos: float): number;
 export declare function lerpAngleDegrees(aStart: number, aEnd: number, percent: float): number;
-/** Helper function to return an array with the elements from start to end, inclusive. */
-export declare function range(start: int, end: int): int[];
+/**
+ * Helper function to return an array with the elements from start to end, inclusive.
+ *
+ * If only one argument is specified, then it will assume that the start is 0.
+ */
+export declare function range(start: int, end?: int): int[];
 /**
  * If rounding fails, this function returns 0.
  * From: http://lua-users.org/wiki/SimpleRound

package/dist/functions/math.lua

@@ -67,6 +67,10 @@ function ____exports.lerpAngleDegrees(self, aStart, aEnd, percent)
     return aStart + ____exports.getAngleDifference(nil, aStart, aEnd) * percent
 end
 function ____exports.range(self, start, ____end)
+    if ____end == nil then
+        ____end = start
+        start = 0
+    end
     local array = {}
     do
         local i = start

package/dist/functions/pocketItems.lua

@@ -20,7 +20,7 @@ function ____exports.getPocketItems(self, player)
     local pocketItems = {}
     local pocketItemIdentified = false
     local pocketItem2Identified = false
-    for ____, slot in ipairs(range(nil, 0, MAX_PLAYER_POCKET_ITEM_SLOTS - 1)) do
+    for ____, slot in ipairs(range(nil, MAX_PLAYER_POCKET_ITEM_SLOTS - 1)) do
         local card = player:GetCard(slot)
         local pillColor = player:GetPill(slot)
         if card ~= Card.CARD_NULL then

package/dist/functions/roomGrid.d.ts

@@ -0,0 +1,40 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to convert grid coordinates to a world position `Vector`.
+ *
+ * For example, the coordinates of (0, 0) are equal to `Vector(80, 160)`.
+ */
+export declare function gridCoordinatesToWorldPosition(x: int, y: int): Vector;
+/**
+ * Helper function to convert a grid index to a grid position.
+ *
+ * For example, in a 1x1 room, grid index 0 is equal to "Vector(-1, -1) and grid index 16 is equal
+ * to "Vector(0, 0)".
+ */
+export declare function gridIndexToGridPosition(gridIndex: int, roomShape: RoomShape): Vector;
+/**
+ * Helper function to convert a grid position `Vector` to a world position `Vector`.
+ *
+ * For example, the coordinates of (0, 0) are equal to `Vector(80, 160)`.
+ */
+export declare function gridPositionToWorldPosition(gridPosition: Vector): Vector;
+/**
+ * Test if a grid position is actually in the given `RoomShape`
+ *
+ * In this context, the grid position of the top-left wall is "Vector(-1, -1)".
+ */
+export declare function isValidGridPosition(gridPosition: Vector, roomShape: RoomShape): boolean;
+/**
+ * Helper function to convert a world position `Vector` to a grid position `Vector`.
+ *
+ * In this context, the grid position of the top-left wall is "Vector(-1, -1)".
+ */
+export declare function worldPositionToGridPosition(worldPos: Vector): Vector;
+/**
+ * Helper function to convert a world position `Vector` to a grid position `Vector`.
+ *
+ * In this context, the grid position of the top-left wall is "Vector(-1, -1)".
+ *
+ * This is similar to the `worldPositionToGridPosition` function, but the values are not rounded.
+ */
+export declare function worldPositionToGridPositionFast(worldPos: Vector): Vector;

package/dist/functions/roomGrid.lua

@@ -0,0 +1,59 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local isValidGridPositionNormal, isValidGridPositionLRoom
+local ____LRoomShapeToRectangles = require("objects.LRoomShapeToRectangles")
+local L_ROOM_SHAPE_TO_RECTANGLES = ____LRoomShapeToRectangles.L_ROOM_SHAPE_TO_RECTANGLES
+local ____math = require("functions.math")
+local inRectangle = ____math.inRectangle
+local ____roomShape = require("functions.roomShape")
+local getRoomShapeTopLeftPosition = ____roomShape.getRoomShapeTopLeftPosition
+local getRoomShapeWidth = ____roomShape.getRoomShapeWidth
+local isLRoom = ____roomShape.isLRoom
+function ____exports.gridPositionToWorldPosition(self, gridPosition)
+    local x = (gridPosition.X + 2) * 40
+    local y = (gridPosition.Y + 4) * 40
+    return Vector(x, y)
+end
+function isValidGridPositionNormal(self, gridPosition, roomShape)
+    local topLeft = getRoomShapeTopLeftPosition(nil, roomShape)
+    local bottomRight = getRoomShapeTopLeftPosition(nil, roomShape)
+    return inRectangle(nil, gridPosition, topLeft, bottomRight)
+end
+function isValidGridPositionLRoom(self, gridPosition, roomShape)
+    local rectangles = L_ROOM_SHAPE_TO_RECTANGLES[roomShape]
+    if rectangles == nil then
+        return false
+    end
+    local verticalTopLeft, verticalBottomRight, horizontalTopLeft, horizontalBottomRight = table.unpack(rectangles)
+    return inRectangle(nil, gridPosition, verticalTopLeft, verticalBottomRight) and inRectangle(nil, gridPosition, horizontalTopLeft, horizontalBottomRight)
+end
+function ____exports.gridCoordinatesToWorldPosition(self, x, y)
+    local gridPosition = Vector(x, y)
+    return ____exports.gridPositionToWorldPosition(nil, gridPosition)
+end
+function ____exports.gridIndexToGridPosition(self, gridIndex, roomShape)
+    local gridWidth = getRoomShapeWidth(nil, roomShape)
+    local x = gridIndex % gridWidth - 1
+    local y = math.floor(gridIndex / gridWidth) - 1
+    return Vector(x, y)
+end
+function ____exports.isValidGridPosition(self, gridPosition, roomShape)
+    local ____isLRoom_result_0
+    if isLRoom(nil, roomShape) then
+        ____isLRoom_result_0 = isValidGridPositionLRoom(nil, gridPosition, roomShape)
+    else
+        ____isLRoom_result_0 = isValidGridPositionNormal(nil, gridPosition, roomShape)
+    end
+    return ____isLRoom_result_0
+end
+function ____exports.worldPositionToGridPosition(self, worldPos)
+    local x = math.floor(worldPos.X / 40 - 2 + 0.5)
+    local y = math.floor(worldPos.Y / 40 - 4 + 0.5)
+    return Vector(x, y)
+end
+function ____exports.worldPositionToGridPositionFast(self, worldPos)
+    local x = worldPos.X / 40 - 2
+    local y = worldPos.Y / 40 - 4
+    return Vector(x, y)
+end
+return ____exports

package/dist/functions/roomShape.d.ts

@@ -39,3 +39,5 @@ export declare function getRoomShapeTopLeftPosition(roomShape: RoomShape): Vecto
  * (This cannot be directly calculated from the bounds since L rooms are a special case.)
  */
 export declare function getRoomShapeVolume(roomShape: RoomShape): int;
+export declare function getRoomShapeWidth(roomShape: RoomShape): int;
+export declare function isLRoom(roomShape: RoomShape): boolean;

package/dist/functions/roomShape.lua

@@ -7,17 +7,18 @@ local ____roomShapeLayoutSizes = require("objects.roomShapeLayoutSizes")
 local ROOM_SHAPE_LAYOUT_SIZES = ____roomShapeLayoutSizes.ROOM_SHAPE_LAYOUT_SIZES
 local ____roomShapeToBottomRightPosition = require("objects.roomShapeToBottomRightPosition")
 local ROOM_SHAPE_TO_BOTTOM_RIGHT_POSITION = ____roomShapeToBottomRightPosition.ROOM_SHAPE_TO_BOTTOM_RIGHT_POSITION
-local ____roomShapeToGridIndexDelta = require("objects.roomShapeToGridIndexDelta")
-local ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA = ____roomShapeToGridIndexDelta.ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA
+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 ____roomShapeToGridWidth = require("objects.roomShapeToGridWidth")
+local ROOM_SHAPE_TO_GRID_WIDTH = ____roomShapeToGridWidth.ROOM_SHAPE_TO_GRID_WIDTH
 local ____roomShapeToTopLeftPosition = require("objects.roomShapeToTopLeftPosition")
 local ROOM_SHAPE_TO_TOP_LEFT_POSITION = ____roomShapeToTopLeftPosition.ROOM_SHAPE_TO_TOP_LEFT_POSITION
 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
 function ____exports.getGridIndexDelta(self, roomShape, doorSlot)
     local doorSlotToGridIndexMap = ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA[roomShape]
-    if doorSlotToGridIndexMap == nil then
-        return nil
-    end
     return doorSlotToGridIndexMap:get(doorSlot)
 end
 function ____exports.getRoomShapeBottomRightPosition(self, roomShape)
@@ -35,4 +36,10 @@ end
 function ____exports.getRoomShapeVolume(self, roomShape)
     return ROOM_SHAPE_VOLUMES[roomShape]
 end
+function ____exports.getRoomShapeWidth(self, roomShape)
+    return ROOM_SHAPE_TO_GRID_WIDTH[roomShape]
+end
+function ____exports.isLRoom(self, roomShape)
+    return L_ROOM_SHAPES_SET:has(roomShape)
+end
 return ____exports

package/dist/functions/rooms.d.ts

@@ -39,11 +39,6 @@ export declare function getRoomItemPoolType(): ItemPoolType;
  * `RoomList`. Default is false.
  */
 export declare function getRooms(includeExtraDimensionalRooms?: boolean): RoomDescriptor[];
-/**
- * Converts a room X and Y coordinate to a position. For example, the coordinates of 0, 0 are
- * equal to `Vector(80, 160)`.
- */
-export declare function gridToPos(x: int, y: int): Vector;
 /**
  * Helper function to determine if the current room shape is equal to `RoomShape.ROOMSHAPE_1x2` or
  * `RoomShape.ROOMSHAPE_2x1`.

package/dist/functions/rooms.lua

@@ -105,7 +105,7 @@ function ____exports.getCurrentDimension(self)
     local startingRoomGridIndex = level:GetStartingRoomIndex()
     local startingRoomDescription = level:GetRoomByIdx(startingRoomGridIndex, -1)
     local startingRoomHash = GetPtrHash(startingRoomDescription)
-    for ____, dimension in ipairs(range(nil, 0, NUM_DIMENSIONS - 1)) do
+    for ____, dimension in ipairs(range(nil, NUM_DIMENSIONS - 1)) do
         local dimensionRoomDescription = level:GetRoomByIdx(startingRoomGridIndex, dimension)
         local dimensionRoomHash = GetPtrHash(dimensionRoomDescription)
         if dimensionRoomHash == startingRoomHash then
@@ -133,13 +133,6 @@ function ____exports.getRoomItemPoolType(self)
     local roomSeed = room:GetSpawnSeed()
     return itemPool:GetPoolForRoom(roomType, roomSeed)
 end
-function ____exports.gridToPos(self, x, y)
-    local room = game:GetRoom()
-    x = x + 1
-    y = y + 1
-    local gridIndex = y * room:GetGridWidth() + x
-    return room:GetGridPosition(gridIndex)
-end
 function ____exports.in2x1Room(self)
     local room = game:GetRoom()
     local roomShape = room:GetRoomShape()
@@ -274,12 +267,12 @@ function ____exports.setRoomCleared(self)
     for ____, door in ipairs(getDoors(nil)) do
         do
             if isHiddenSecretRoomDoor(nil, door) then
-                goto __continue52
+                goto __continue51
             end
             openDoorFast(nil, door)
             door.ExtraVisible = false
         end
-        ::__continue52::
+        ::__continue51::
     end
     sfxManager:Stop(SoundEffect.SOUND_DOOR_HEAVY_OPEN)
     game:ShakeScreen(0)

package/dist/functions/sprite.lua

@@ -15,7 +15,7 @@ function ____exports.clearSprite(self, sprite, ...)
     local layerIDs = {...}
     if #layerIDs == 0 then
         local numLayers = sprite:GetLayerCount()
-        layerIDs = range(nil, 0, numLayers - 1)
+        layerIDs = range(nil, numLayers - 1)
     end
     for ____, layerID in ipairs(layerIDs) do
         sprite:ReplaceSpritesheet(layerID, EMPTY_PNG_PATH)

package/dist/index.d.ts

@@ -29,12 +29,14 @@ export * from "./features/saveDataManager/exports";
 export { hasSirenStolenFamiliar, setFamiliarNoSirenSteal, } from "./features/sirenHelpers";
 export { getTaintedLazarusSubPlayer } from "./features/taintedLazarusPlayers";
 export * from "./functions/array";
+export * from "./functions/benchmark";
 export * from "./functions/bitwise";
 export * from "./functions/cacheFlag";
 export * from "./functions/cards";
 export * from "./functions/challenges";
 export * from "./functions/character";
 export * from "./functions/charge";
+export * from "./functions/chargeBar";
 export * from "./functions/collectibleCacheFlag";
 export * from "./functions/collectibles";
 export * from "./functions/collectibleSet";
@@ -73,6 +75,7 @@ export * from "./functions/random";
 export * from "./functions/revive";
 export * from "./functions/rng";
 export * from "./functions/roomData";
+export * from "./functions/roomGrid";
 export * from "./functions/rooms";
 export * from "./functions/roomShape";
 export * from "./functions/run";

package/dist/index.lua

@@ -241,6 +241,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.benchmark")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.bitwise")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -289,6 +297,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.chargeBar")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.collectibleCacheFlag")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -584,6 +600,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.roomGrid")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.rooms")
     for ____exportKey, ____exportValue in pairs(____export) do

package/dist/objects/LRoomShapeToRectangles.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * "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 const L_ROOM_SHAPE_TO_RECTANGLES: {
+    [key in RoomShape]?: [
+        verticalTopLeft: Vector,
+        verticalBottomRight: Vector,
+        horizontalTopLeft: Vector,
+        horizontalBottomRight: Vector
+    ];
+};

package/dist/objects/LRoomShapeToRectangles.lua

@@ -0,0 +1,30 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local TWO_BY_TWO_BOTTOM_RIGHT = Vector(25, 13)
+____exports.L_ROOM_SHAPE_TO_RECTANGLES = {
+    [RoomShape.ROOMSHAPE_LTL] = {
+        Vector(13, 0),
+        Vector(25, 13),
+        Vector(0, 7),
+        TWO_BY_TWO_BOTTOM_RIGHT
+    },
+    [RoomShape.ROOMSHAPE_LTR] = {
+        Vector.Zero,
+        Vector(12, 13),
+        Vector(0, 7),
+        TWO_BY_TWO_BOTTOM_RIGHT
+    },
+    [RoomShape.ROOMSHAPE_LBL] = {
+        Vector.Zero,
+        Vector(25, 6),
+        Vector(13, 0),
+        TWO_BY_TWO_BOTTOM_RIGHT
+    },
+    [RoomShape.ROOMSHAPE_LBR] = {
+        Vector.Zero,
+        Vector(25, 6),
+        Vector.Zero,
+        Vector(12, 13)
+    }
+}
+return ____exports

package/dist/objects/roomShapeToDoorSlotsToGridIndexDelta.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Deltas are considered to be from the safe grid index of the room (i.e. the top left corner, or
+ * top right corner in the case of `RoomShape.ROOMSHAPE_LTL`).
+ */
+export declare const ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA: {
+    readonly [key in RoomShape]: Map<DoorSlot, int>;
+};

package/dist/objects/roomShapeToDoorSlotsToGridIndexDelta.lua

@@ -0,0 +1,85 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____constants = require("constants")
+local LEVEL_GRID_ROW_LENGTH = ____constants.LEVEL_GRID_ROW_LENGTH
+local LEFT = -1
+local UP = -LEVEL_GRID_ROW_LENGTH
+local RIGHT = 1
+local DOWN = LEVEL_GRID_ROW_LENGTH
+____exports.ROOM_SHAPE_TO_DOOR_SLOTS_TO_GRID_INDEX_DELTA = {
+    [RoomShape.ROOMSHAPE_1x1] = __TS__New(Map, {{DoorSlot.LEFT0, LEFT}, {DoorSlot.UP0, UP}, {DoorSlot.RIGHT0, RIGHT}, {DoorSlot.DOWN0, DOWN}}),
+    [RoomShape.ROOMSHAPE_IH] = __TS__New(Map, {{DoorSlot.LEFT0, LEFT}, {DoorSlot.RIGHT0, RIGHT}}),
+    [RoomShape.ROOMSHAPE_IV] = __TS__New(Map, {{DoorSlot.UP0, UP}, {DoorSlot.DOWN0, DOWN}}),
+    [RoomShape.ROOMSHAPE_1x2] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, UP},
+        {DoorSlot.RIGHT0, RIGHT},
+        {DoorSlot.DOWN0, DOWN + DOWN},
+        {DoorSlot.LEFT1, DOWN + LEFT},
+        {DoorSlot.RIGHT1, DOWN + RIGHT}
+    }),
+    [RoomShape.ROOMSHAPE_IIV] = __TS__New(Map, {{DoorSlot.UP0, UP}, {DoorSlot.DOWN0, DOWN + DOWN}}),
+    [RoomShape.ROOMSHAPE_2x1] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, UP},
+        {DoorSlot.RIGHT0, RIGHT + RIGHT},
+        {DoorSlot.DOWN0, DOWN},
+        {DoorSlot.UP1, RIGHT + UP},
+        {DoorSlot.DOWN1, RIGHT + DOWN}
+    }),
+    [RoomShape.ROOMSHAPE_IIH] = __TS__New(Map, {{DoorSlot.LEFT0, LEFT}, {DoorSlot.RIGHT0, RIGHT + RIGHT}}),
+    [RoomShape.ROOMSHAPE_2x2] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, UP},
+        {DoorSlot.RIGHT0, RIGHT + RIGHT},
+        {DoorSlot.DOWN0, DOWN + DOWN},
+        {DoorSlot.LEFT1, DOWN + LEFT},
+        {DoorSlot.UP1, RIGHT + UP},
+        {DoorSlot.RIGHT1, RIGHT + DOWN + RIGHT},
+        {DoorSlot.DOWN1, RIGHT + DOWN + DOWN}
+    }),
+    [RoomShape.ROOMSHAPE_LTL] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, DOWN + LEFT + UP},
+        {DoorSlot.RIGHT0, RIGHT},
+        {DoorSlot.DOWN0, DOWN + LEFT + DOWN},
+        {DoorSlot.LEFT1, DOWN + LEFT + LEFT},
+        {DoorSlot.UP1, UP},
+        {DoorSlot.RIGHT1, DOWN + RIGHT},
+        {DoorSlot.DOWN1, DOWN + DOWN}
+    }),
+    [RoomShape.ROOMSHAPE_LTR] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, UP},
+        {DoorSlot.RIGHT0, RIGHT},
+        {DoorSlot.DOWN0, DOWN + DOWN},
+        {DoorSlot.LEFT1, DOWN + LEFT},
+        {DoorSlot.UP1, DOWN + RIGHT + UP},
+        {DoorSlot.RIGHT1, DOWN + RIGHT + RIGHT},
+        {DoorSlot.DOWN1, DOWN + RIGHT + DOWN}
+    }),
+    [RoomShape.ROOMSHAPE_LBL] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, UP},
+        {DoorSlot.RIGHT0, RIGHT + RIGHT},
+        {DoorSlot.DOWN0, DOWN},
+        {DoorSlot.LEFT1, RIGHT + DOWN + LEFT},
+        {DoorSlot.UP1, RIGHT + UP},
+        {DoorSlot.RIGHT1, RIGHT + DOWN + RIGHT},
+        {DoorSlot.DOWN1, RIGHT + DOWN + DOWN}
+    }),
+    [RoomShape.ROOMSHAPE_LBR] = __TS__New(Map, {
+        {DoorSlot.LEFT0, LEFT},
+        {DoorSlot.UP0, UP},
+        {DoorSlot.RIGHT0, RIGHT + RIGHT},
+        {DoorSlot.DOWN0, DOWN + DOWN},
+        {DoorSlot.LEFT1, DOWN + LEFT},
+        {DoorSlot.UP1, RIGHT + UP},
+        {DoorSlot.RIGHT1, DOWN + RIGHT},
+        {DoorSlot.DOWN1, RIGHT + DOWN}
+    }),
+    [RoomShape.NUM_ROOMSHAPES] = __TS__New(Map)
+}
+return ____exports

package/dist/objects/roomShapeToGridWidth.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare const ROOM_SHAPE_TO_GRID_WIDTH: {
+    readonly [key in RoomShape]: int;
+};

package/dist/objects/roomShapeToGridWidth.lua

@@ -0,0 +1,20 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ONE_BY_ONE_WIDTH = 15
+local TWO_BY_ONE_WIDTH = 28
+____exports.ROOM_SHAPE_TO_GRID_WIDTH = {
+    [RoomShape.ROOMSHAPE_1x1] = ONE_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_IH] = ONE_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_IV] = ONE_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_1x2] = ONE_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_IIV] = ONE_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_2x1] = TWO_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_IIH] = TWO_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_2x2] = TWO_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_LTL] = TWO_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_LTR] = TWO_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_LBL] = TWO_BY_ONE_WIDTH,
+    [RoomShape.ROOMSHAPE_LBR] = TWO_BY_ONE_WIDTH,
+    [RoomShape.NUM_ROOMSHAPES] = 0
+}
+return ____exports

package/dist/sets/LRoomShapesSet.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare const L_ROOM_SHAPES_SET: ReadonlySet<RoomShape>;

package/dist/sets/LRoomShapesSet.lua

@@ -0,0 +1,6 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+____exports.L_ROOM_SHAPES_SET = __TS__New(Set, {RoomShape.ROOMSHAPE_LTL, RoomShape.ROOMSHAPE_LTR, RoomShape.ROOMSHAPE_LBL, RoomShape.ROOMSHAPE_LBR})
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.228",
+  "version": "1.2.231",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,7 +25,7 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.384",
+    "isaac-typescript-definitions": "^1.0.385",
     "isaacscript-lint": "^1.0.95",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.13",