isaacscript-common 6.6.1-dev.2 → 6.6.1

package/dist/functions/gridEntity.lua

@@ -0,0 +1,491 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local Map = ____lualib.Map
+local ____exports = {}
+local getAllGridEntities
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local PoopGridEntityVariant = ____isaac_2Dtypescript_2Ddefinitions.PoopGridEntityVariant
+local StatueVariant = ____isaac_2Dtypescript_2Ddefinitions.StatueVariant
+local TrapdoorVariant = ____isaac_2Dtypescript_2Ddefinitions.TrapdoorVariant
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____constants = require("constants")
+local DISTANCE_OF_GRID_TILE = ____constants.DISTANCE_OF_GRID_TILE
+local ____RockAltType = require("enums.RockAltType")
+local RockAltType = ____RockAltType.RockAltType
+local ____gridEntityTypeToBrokenStateMap = require("maps.gridEntityTypeToBrokenStateMap")
+local GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP = ____gridEntityTypeToBrokenStateMap.GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP
+local ____gridEntityXMLMap = require("maps.gridEntityXMLMap")
+local GRID_ENTITY_XML_MAP = ____gridEntityXMLMap.GRID_ENTITY_XML_MAP
+local ____roomShapeToTopLeftWallGridIndexMap = require("maps.roomShapeToTopLeftWallGridIndexMap")
+local DEFAULT_TOP_LEFT_WALL_GRID_INDEX = ____roomShapeToTopLeftWallGridIndexMap.DEFAULT_TOP_LEFT_WALL_GRID_INDEX
+local ROOM_SHAPE_TO_TOP_LEFT_WALL_GRID_INDEX_MAP = ____roomShapeToTopLeftWallGridIndexMap.ROOM_SHAPE_TO_TOP_LEFT_WALL_GRID_INDEX_MAP
+local ____backdropTypeToRockAltType = require("objects.backdropTypeToRockAltType")
+local BACKDROP_TYPE_TO_ROCK_ALT_TYPE = ____backdropTypeToRockAltType.BACKDROP_TYPE_TO_ROCK_ALT_TYPE
+local ____math = require("functions.math")
+local isCircleIntersectingRectangle = ____math.isCircleIntersectingRectangle
+local ____rng = require("functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+local ____rooms = require("functions.rooms")
+local roomUpdateSafe = ____rooms.roomUpdateSafe
+local ____sprite = require("functions.sprite")
+local clearSprite = ____sprite.clearSprite
+local ____utils = require("functions.utils")
+local erange = ____utils.erange
+local ____vector = require("functions.vector")
+local isVector = ____vector.isVector
+--- Helper function to get every legal grid index for the current room.
+-- 
+-- Under the hood, this uses the `Room.GetGridSize` method.
+function ____exports.getAllGridIndexes(self)
+    local room = game:GetRoom()
+    local gridSize = room:GetGridSize()
+    return erange(nil, gridSize)
+end
+function getAllGridEntities(self)
+    local room = game:GetRoom()
+    local gridEntities = {}
+    for ____, gridIndex in ipairs(____exports.getAllGridIndexes(nil)) do
+        local gridEntity = room:GetGridEntity(gridIndex)
+        if gridEntity ~= nil then
+            gridEntities[#gridEntities + 1] = gridEntity
+        end
+    end
+    return gridEntities
+end
+--- Helper function to get the grid index of the top left wall. (This will depend on what the current
+-- room shape is.)
+function ____exports.getTopLeftWallGridIndex(self)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local topLeftWallGridIndex = ROOM_SHAPE_TO_TOP_LEFT_WALL_GRID_INDEX_MAP:get(roomShape)
+    return topLeftWallGridIndex == nil and DEFAULT_TOP_LEFT_WALL_GRID_INDEX or topLeftWallGridIndex
+end
+--- Helper function to remove a grid entity simply by providing the grid entity object. By default,
+-- this will also update the room.
+-- 
+-- @param gridEntityOrGridIndex The grid entity or grid index to remove.
+-- @param updateRoom Optional. Whether or not to update the room after the grid entity is removed.
+-- Default is true. This is generally a good idea because if the room is not
+-- updated, you will be unable to spawn another grid entity on the same tile until
+-- a frame has passed. However, doing this is expensive, since it involves a call
+-- to `Isaac.GetRoomEntities`, so set it to false if you need to invoke this
+-- function multiple times.
+function ____exports.removeGrid(self, gridEntityOrGridIndex, updateRoom)
+    if updateRoom == nil then
+        updateRoom = true
+    end
+    local room = game:GetRoom()
+    local gridIndex = gridEntityOrGridIndex:GetGridIndex()
+    room:RemoveGridEntity(gridIndex, 0, false)
+    if updateRoom then
+        roomUpdateSafe(nil)
+    end
+end
+--- Helper function to spawn a grid entity with a specific variant.
+-- 
+-- Use this instead of the `Isaac.GridSpawn` method since it:
+-- - handles giving pits collision
+-- - removes existing grid entities on the same tile, if any
+-- - allows you to specify the grid index or the position
+function ____exports.spawnGridWithVariant(self, gridEntityType, variant, gridIndexOrPosition)
+    local room = game:GetRoom()
+    local ____isVector_result_0
+    if isVector(nil, gridIndexOrPosition) then
+        ____isVector_result_0 = room:GetGridEntityFromPos(gridIndexOrPosition)
+    else
+        ____isVector_result_0 = room:GetGridEntity(gridIndexOrPosition)
+    end
+    local existingGridEntity = ____isVector_result_0
+    if existingGridEntity ~= nil then
+        ____exports.removeGrid(nil, existingGridEntity)
+    end
+    local position = isVector(nil, gridIndexOrPosition) and gridIndexOrPosition or room:GetGridPosition(gridIndexOrPosition)
+    local gridEntity = Isaac.GridSpawn(gridEntityType, variant, position)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    if gridEntityType == GridEntityType.PIT then
+        local pit = gridEntity:ToPit()
+        if pit ~= nil then
+            pit:UpdateCollision()
+        end
+    elseif gridEntityType == GridEntityType.WALL then
+        gridEntity.CollisionClass = GridCollisionClass.WALL
+    end
+    return gridEntity
+end
+local BREAKABLE_GRID_ENTITY_TYPES_BY_EXPLOSIONS = __TS__New(Set, {
+    GridEntityType.ROCK,
+    GridEntityType.ROCK_TINTED,
+    GridEntityType.ROCK_BOMB,
+    GridEntityType.ROCK_ALT,
+    GridEntityType.SPIDER_WEB,
+    GridEntityType.TNT,
+    GridEntityType.POOP,
+    GridEntityType.ROCK_SUPER_SPECIAL,
+    GridEntityType.ROCK_SPIKED,
+    GridEntityType.ROCK_ALT_2,
+    GridEntityType.ROCK_GOLD
+})
+local BREAKABLE_GRID_ENTITY_TYPES_VARIANTS_BY_EXPLOSIONS = __TS__New(
+    Set,
+    {(tostring(GridEntityType.STATUE) .. ".") .. tostring(StatueVariant.ANGEL)}
+)
+--- Helper function to convert the grid entity type found in a room XML file to the corresponding
+-- grid entity type and variant normally used by the game. For example, a rock is represented as
+-- 1000.0 in a room XML file, but `GridEntityType.ROCK` is equal to 2.
+function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntityXMLVariant)
+    local gridEntityArray = GRID_ENTITY_XML_MAP:get(gridEntityXMLType)
+    if gridEntityArray == nil then
+        error("Failed to find an entry in the grid entity map for XML entity type: " .. tostring(gridEntityXMLType))
+    end
+    local gridEntityType = gridEntityArray[1]
+    local gridEntityVariant = gridEntityArray[2]
+    if gridEntityType == GridEntityType.SPIKES_ON_OFF or gridEntityType == GridEntityType.PRESSURE_PLATE or gridEntityType == GridEntityType.TELEPORTER then
+        gridEntityVariant = gridEntityXMLVariant
+    end
+    return {gridEntityType, gridEntityVariant}
+end
+--- Gets the entities that have a hitbox that overlaps with any part of the square that the grid
+-- entity is on.
+-- 
+-- Note that this function will not work properly in the PostNewRoom callback, since entities do not
+-- have collision yet in that callback.
+function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
+    local gridEntityCollisionTopLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
+    local gridEntityCollisionBottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
+    local closeEntities = Isaac.FindInRadius(gridEntity.Position, DISTANCE_OF_GRID_TILE * 2)
+    return __TS__ArrayFilter(
+        closeEntities,
+        function(____, entity) return entity:CollidesWithGrid() and isCircleIntersectingRectangle(
+            nil,
+            entity.Position,
+            entity.Size + 0.1,
+            gridEntityCollisionTopLeft,
+            gridEntityCollisionBottomRight
+        ) end
+    )
+end
+--- Helper function to get every grid entity in the current room.
+-- 
+-- Use this function with no arguments to get every grid entity, or specify a variadic amount of
+-- arguments to match specific grid entity types.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- for (const gridEntity of getGridEntities()) {
+--   print(gridEntity.GetType())
+-- }
+-- ```
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const rocks = getGridEntities(
+--   GridEntityType.ROCK,
+--   GridEntityType.BLOCK,
+--   GridEntityType.ROCK_TINTED,
+-- );
+-- ```
+function ____exports.getGridEntities(self, ...)
+    local gridEntityTypes = {...}
+    local gridEntities = getAllGridEntities(nil)
+    if #gridEntityTypes == 0 then
+        return gridEntities
+    end
+    local gridEntityTypesSet = __TS__New(Set, gridEntityTypes)
+    return __TS__ArrayFilter(
+        gridEntities,
+        function(____, gridEntity)
+            local gridEntityType = gridEntity:GetType()
+            return gridEntityTypesSet:has(gridEntityType)
+        end
+    )
+end
+--- Helper function to get every grid entity in the current room except for certain specific types.
+-- 
+-- This function is variadic, meaning that you can specify as many grid entity types as you want to
+-- exclude.
+function ____exports.getGridEntitiesExcept(self, ...)
+    local gridEntityTypes = {...}
+    local gridEntities = getAllGridEntities(nil)
+    if #gridEntityTypes == 0 then
+        return gridEntities
+    end
+    local gridEntityTypesSet = __TS__New(Set, gridEntityTypes)
+    return __TS__ArrayFilter(
+        gridEntities,
+        function(____, gridEntity)
+            local gridEntityType = gridEntity:GetType()
+            return not gridEntityTypesSet:has(gridEntityType)
+        end
+    )
+end
+--- Helper function to get a map of every grid entity in the current room. The indexes of the map are
+-- equal to the grid index. The values of the map are equal to the grid entities.
+-- 
+-- Use this function with no arguments to get every grid entity, or specify a variadic amount of
+-- arguments to match specific grid entity types.
+function ____exports.getGridEntitiesMap(self, ...)
+    local gridEntities = ____exports.getGridEntities(nil, ...)
+    local gridEntityMap = __TS__New(Map)
+    for ____, gridEntity in ipairs(gridEntities) do
+        local gridIndex = gridEntity:GetGridIndex()
+        gridEntityMap:set(gridIndex, gridEntity)
+    end
+    return gridEntityMap
+end
+--- Helper function to return a string containing the grid entity's type and variant.
+function ____exports.getGridEntityID(self, gridEntity)
+    local gridEntityType = gridEntity:GetType()
+    local variant = gridEntity:GetVariant()
+    return (tostring(gridEntityType) .. ".") .. tostring(variant)
+end
+--- Helper function to return a formatted string in the format returned by the `getGridEntityID`
+-- function.
+function ____exports.getGridEntityIDFromConstituents(self, gridEntityType, variant)
+    return (tostring(gridEntityType) .. ".") .. tostring(variant)
+end
+--- Helper function to get all of the grid entities in the room that specifically match the type and
+-- variant provided.
+function ____exports.getMatchingGridEntities(self, gridEntityType, variant)
+    local gridEntities = ____exports.getGridEntities(nil, gridEntityType)
+    return __TS__ArrayFilter(
+        gridEntities,
+        function(____, gridEntity) return gridEntity:GetVariant() == variant end
+    )
+end
+--- Helper function to get the alternate rock type (i.e. urn, mushroom, etc.) that the current room
+-- will have.
+-- 
+-- The rock type is based on the backdrop of the room.
+-- 
+-- For example, if you change the backdrop of the starting room of the run to `BackdropType.CAVES`,
+-- and then spawn `GridEntityType.ROCK_ALT`, it will be a mushroom instead of an urn. Additionally,
+-- if it is destroyed, it will generate mushroom-appropriate rewards.
+-- 
+-- On the other hand, if an urn is spawned first before the backdrop is changed to
+-- `BackdropType.CAVES`, the graphic of the urn will not switch to a mushroom. However, when
+-- destroyed, the urn will still generate mushroom-appropriate rewards.
+function ____exports.getRockAltType(self)
+    local room = game:GetRoom()
+    local backdropType = room:GetBackdropType()
+    return BACKDROP_TYPE_TO_ROCK_ALT_TYPE[backdropType]
+end
+function ____exports.getSurroundingGridEntities(self, gridEntity)
+    local room = game:GetRoom()
+    local gridWidth = room:GetGridWidth()
+    local gridIndex = gridEntity:GetGridIndex()
+    local surroundingGridIndexes = {
+        gridIndex - 1,
+        gridIndex + 1,
+        gridIndex - gridWidth - 1,
+        gridIndex - gridWidth,
+        gridIndex - gridWidth + 1,
+        gridIndex + gridWidth - 1,
+        gridIndex + gridWidth,
+        gridIndex + gridWidth + 1
+    }
+    local surroundingGridEntities = {}
+    for ____, surroundingGridIndex in ipairs(surroundingGridIndexes) do
+        local surroundingGridEntity = room:GetGridEntity(surroundingGridIndex)
+        if surroundingGridEntity ~= nil then
+            surroundingGridEntities[#surroundingGridEntities + 1] = surroundingGridEntity
+        end
+    end
+    return surroundingGridEntities
+end
+function ____exports.getTopLeftWall(self)
+    local room = game:GetRoom()
+    local topLeftWallGridIndex = ____exports.getTopLeftWallGridIndex(nil)
+    return room:GetGridEntity(topLeftWallGridIndex)
+end
+function ____exports.isGridEntityBreakableByExplosion(self, gridEntity)
+    local gridEntityType = gridEntity:GetType()
+    local gridEntityVariant = gridEntity:GetVariant()
+    local gridEntityTypeVariant = (tostring(gridEntityType) .. ".") .. tostring(gridEntityVariant)
+    return BREAKABLE_GRID_ENTITY_TYPES_BY_EXPLOSIONS:has(gridEntityType) or BREAKABLE_GRID_ENTITY_TYPES_VARIANTS_BY_EXPLOSIONS:has(gridEntityTypeVariant)
+end
+--- Helper function to see if the provided gridEntity is in its respective broken state. See the
+-- `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
+-- 
+-- Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
+-- the actual collision for the entity is removed.
+function ____exports.isGridEntityBroken(self, gridEntity)
+    local gridEntityType = gridEntity:GetType()
+    local brokenState = GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP:get(gridEntityType)
+    return gridEntity.State == brokenState
+end
+--- Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
+-- defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
+-- at the VarData of the entity.)
+function ____exports.isPostBossVoidPortal(self, gridEntity)
+    local saveState = gridEntity:GetSaveState()
+    return saveState.VarData == 1
+end
+--- Helper function to all grid entities in the room except for ones matching the grid entity types
+-- provided.
+-- 
+-- Note that this function will automatically update the room. (This means that you can spawn new
+-- grid entities on the same tile on the same frame, if needed.)
+-- 
+-- For example:
+-- 
+-- ```ts
+-- removeAllGridEntitiesExceptFor(
+--   GridEntityType.WALL,
+--   GridEntityType.DOOR,
+-- );
+-- ```
+-- 
+-- @returns True if one or more grid entities were removed, false otherwise.
+function ____exports.removeAllGridExcept(self, ...)
+    local gridEntityTypes = {...}
+    local gridEntityTypeExceptions = __TS__New(Set, gridEntityTypes)
+    local gridEntities = ____exports.getGridEntities(nil)
+    local removedGridEntities = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local gridEntityType = gridEntity:GetType()
+        if not gridEntityTypeExceptions:has(gridEntityType) then
+            ____exports.removeGrid(nil, gridEntity, false)
+            removedGridEntities[#removedGridEntities + 1] = gridEntity
+        end
+    end
+    if #removedGridEntities > 0 then
+        roomUpdateSafe(nil)
+    end
+    return removedGridEntities
+end
+--- Helper function to remove all of the grid entities in the room that match the grid entity types
+-- provided.
+-- 
+-- Note that this function will automatically update the room. (This means that you can spawn new
+-- grid entities on the same tile on the same frame, if needed.)
+-- 
+-- For example:
+-- 
+-- ```ts
+-- removeAllMatchingGridEntities(
+--   GridEntityType.ROCK,
+--   GridEntityType.BLOCK,
+--   GridEntityType.ROCK_TINTED,
+-- );
+-- ```
+-- 
+-- @returns An array of the grid entities removed.
+function ____exports.removeAllMatchingGridEntities(self, ...)
+    local gridEntities = ____exports.getGridEntities(nil, ...)
+    if #gridEntities == 0 then
+        return {}
+    end
+    for ____, gridEntity in ipairs(gridEntities) do
+        ____exports.removeGrid(nil, gridEntity, false)
+    end
+    roomUpdateSafe(nil)
+    return gridEntities
+end
+--- Helper function to make a grid entity invisible. This is accomplished by setting its sprite to an
+-- empty/missing PNG file.
+-- 
+-- For more information, see the documentation for the `clearSprite` helper function.
+function ____exports.setGridEntityInvisible(self, gridEntity)
+    local sprite = gridEntity:GetSprite()
+    clearSprite(nil, sprite)
+end
+--- Helper function to spawn a giant poop. This is performed by spawning each of the four quadrant
+-- grid entities in the appropriate positions.
+function ____exports.spawnGiantPoop(self, topLeftGridIndex)
+    local room = game:GetRoom()
+    local gridWidth = room:GetGridWidth()
+    local topRightGridIndex = topLeftGridIndex + 1
+    local bottomLeftGridIndex = topLeftGridIndex + gridWidth
+    local bottomRightGridIndex = bottomLeftGridIndex + 1
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_TOP_LEFT, topLeftGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_TOP_RIGHT, topRightGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_BOTTOM_LEFT, bottomLeftGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_BOTTOM_RIGHT, bottomRightGridIndex)
+end
+--- Helper function to spawn a grid entity.
+-- 
+-- This function assumes you want to give the grid entity a variant of 0. If you want to specify a
+-- variant, use the `spawnGridWithVariant` helper function instead.
+-- 
+-- Use this instead of the `Isaac.GridSpawn` method since it:
+-- - handles giving pits collision
+-- - removes existing grid entities on the same tile, if any
+-- - allows you to specify either the grid index or the position
+function ____exports.spawnGrid(self, gridEntityType, gridIndexOrPosition)
+    return ____exports.spawnGridWithVariant(nil, gridEntityType, 0, gridIndexOrPosition)
+end
+--- Helper function for emulating what happens when a vanilla `GridEntityType.ROCK_ALT` grid entity
+-- breaks.
+-- 
+-- Note that most of the time, this function will do nothing, similar to how most of the time, when
+-- an individual urn is destroyed, nothing will spawn.
+-- 
+-- The logic in this function is based on the rewards listed on the wiki:
+-- https://bindingofisaacrebirth.fandom.com/wiki/Rocks
+-- 
+-- @param rockAltType The type of reward to spawn. For example, `RockAltType.URN` will have a chance
+-- at spawning coins and spiders.
+-- @param _seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
+-- the `RNG.Next` method will be called. Default is `getRandomSeed()`. Normally,
+-- you should pass the `InitSeed` of the grid entity that was broken.
+-- @returns Whether or not this function spawned something.
+function ____exports.spawnRockAltReward(self, rockAltType, _seedOrRNG)
+    if _seedOrRNG == nil then
+        _seedOrRNG = getRandomSeed(nil)
+    end
+    repeat
+        local ____switch56 = rockAltType
+        local ____cond56 = ____switch56 == RockAltType.URN
+        if ____cond56 then
+            do
+                return false
+            end
+        end
+        ____cond56 = ____cond56 or ____switch56 == RockAltType.MUSHROOM
+        if ____cond56 then
+            do
+                return false
+            end
+        end
+        ____cond56 = ____cond56 or ____switch56 == RockAltType.SKULL
+        if ____cond56 then
+            do
+                return false
+            end
+        end
+        ____cond56 = ____cond56 or ____switch56 == RockAltType.POLYP
+        if ____cond56 then
+            do
+                return false
+            end
+        end
+        ____cond56 = ____cond56 or ____switch56 == RockAltType.BUCKET
+        if ____cond56 then
+            do
+                return false
+            end
+        end
+    until true
+end
+--- Helper function to spawn a Void Portal. This is more complicated than simply spawning a trapdoor
+-- with the appropriate variant, as the game does not give it the correct sprite automatically.
+function ____exports.spawnVoidPortal(self, gridIndex)
+    local voidPortal = ____exports.spawnGridWithVariant(nil, GridEntityType.TRAPDOOR, TrapdoorVariant.VOID_PORTAL, gridIndex)
+    if voidPortal == nil then
+        return voidPortal
+    end
+    voidPortal.VarData = 1
+    local sprite = voidPortal:GetSprite()
+    sprite:Load("gfx/grid/voidtrapdoor.anm2", true)
+    return voidPortal
+end
+return ____exports

package/dist/functions/gridEntitySpecific.d.ts

@@ -0,0 +1,29 @@
+import { CrawlSpaceState, TrapdoorVariant } from "isaac-typescript-definitions";
+/**
+ * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
+ * Specify a specific trapdoor variant to select only trapdoors of that variant.
+ */
+export declare function getCrawlSpaces(crawlSpaceVariant?: CrawlSpaceState): GridEntity[];
+/** Helper function to get all of the `GridEntityPit` in the room. */
+export declare function getPits(): GridEntityPit[];
+/** Helper function to get all of the `GridEntityPoop` in the room. */
+export declare function getPoops(): GridEntityPoop[];
+/** Helper function to get all of the `GridEntityPressurePlate` in the room. */
+export declare function getPressurePlates(): GridEntityPressurePlate[];
+/** Helper function to get all of the `GridEntityRock` in the room. */
+export declare function getRocks(): GridEntityRock[];
+/** Helper function to get all of the `GridEntitySpikes` in the room. */
+export declare function getSpikes(): GridEntitySpikes[];
+/** Helper function to get all of the `GridEntityTNT` in the room. */
+export declare function getTNT(): GridEntityTNT[];
+/**
+ * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
+ * Specify a specific trapdoor variant to select only trapdoors of that variant.
+ */
+export declare function getTrapdoors(trapdoorVariant?: TrapdoorVariant): GridEntity[];
+/**
+ * Helper function to determine if all of the pressure plates in the current room are pushed.
+ * Returns true if there are no pressure plates in the room.
+ */
+export declare function isAllPressurePlatesPushed(): boolean;
+//# sourceMappingURL=gridEntitySpecific.d.ts.map

package/dist/functions/gridEntitySpecific.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridEntitySpecific.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/functions/gridEntitySpecific.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGf,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAItC;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,iBAAiB,CAAC,EAAE,eAAe,GAClC,UAAU,EAAE,CAMd;AAED,qEAAqE;AACrE,wBAAgB,OAAO,IAAI,aAAa,EAAE,CAYzC;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,IAAI,cAAc,EAAE,CAY3C;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,uBAAuB,EAAE,CAY7D;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,IAAI,cAAc,EAAE,CAY3C;AAED,wEAAwE;AACxE,wBAAgB,SAAS,IAAI,gBAAgB,EAAE,CAY9C;AAED,qEAAqE;AACrE,wBAAgB,MAAM,IAAI,aAAa,EAAE,CAYxC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,UAAU,EAAE,CAM5E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAanD"}

package/dist/functions/gridEntitySpecific.lua

@@ -0,0 +1,114 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local PressurePlateState = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateState
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____gridEntity = require("functions.gridEntity")
+local getGridEntities = ____gridEntity.getGridEntities
+local getMatchingGridEntities = ____gridEntity.getMatchingGridEntities
+--- Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
+-- Specify a specific trapdoor variant to select only trapdoors of that variant.
+function ____exports.getCrawlSpaces(self, crawlSpaceVariant)
+    if crawlSpaceVariant == nil then
+        return getGridEntities(nil, GridEntityType.CRAWL_SPACE)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.CRAWL_SPACE, crawlSpaceVariant)
+end
+--- Helper function to get all of the `GridEntityPit` in the room.
+function ____exports.getPits(self)
+    local gridEntities = getGridEntities(nil)
+    local pits = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pit = gridEntity:ToPit()
+        if pit ~= nil then
+            pits[#pits + 1] = pit
+        end
+    end
+    return pits
+end
+--- Helper function to get all of the `GridEntityPoop` in the room.
+function ____exports.getPoops(self)
+    local gridEntities = getGridEntities(nil)
+    local poops = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local poop = gridEntity:ToPoop()
+        if poop ~= nil then
+            poops[#poops + 1] = poop
+        end
+    end
+    return poops
+end
+--- Helper function to get all of the `GridEntityPressurePlate` in the room.
+function ____exports.getPressurePlates(self)
+    local gridEntities = getGridEntities(nil)
+    local pressurePlates = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pressurePlate = gridEntity:ToPressurePlate()
+        if pressurePlate ~= nil then
+            pressurePlates[#pressurePlates + 1] = pressurePlate
+        end
+    end
+    return pressurePlates
+end
+--- Helper function to get all of the `GridEntityRock` in the room.
+function ____exports.getRocks(self)
+    local gridEntities = getGridEntities(nil)
+    local rocks = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local rock = gridEntity:ToRock()
+        if rock ~= nil then
+            rocks[#rocks + 1] = rock
+        end
+    end
+    return rocks
+end
+--- Helper function to get all of the `GridEntitySpikes` in the room.
+function ____exports.getSpikes(self)
+    local gridEntities = getGridEntities(nil)
+    local spikes = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local spike = gridEntity:ToSpikes()
+        if spike ~= nil then
+            spikes[#spikes + 1] = spike
+        end
+    end
+    return spikes
+end
+--- Helper function to get all of the `GridEntityTNT` in the room.
+function ____exports.getTNT(self)
+    local gridEntities = getGridEntities(nil)
+    local tntArray = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local tnt = gridEntity:ToTNT()
+        if tnt ~= nil then
+            tntArray[#tntArray + 1] = tnt
+        end
+    end
+    return tntArray
+end
+--- Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
+-- Specify a specific trapdoor variant to select only trapdoors of that variant.
+function ____exports.getTrapdoors(self, trapdoorVariant)
+    if trapdoorVariant == nil then
+        return getGridEntities(nil, GridEntityType.TRAPDOOR)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.TRAPDOOR, trapdoorVariant)
+end
+--- Helper function to determine if all of the pressure plates in the current room are pushed.
+-- Returns true if there are no pressure plates in the room.
+function ____exports.isAllPressurePlatesPushed(self)
+    local room = game:GetRoom()
+    local hasPressurePlates = room:HasTriggerPressurePlates()
+    if not hasPressurePlates then
+        return true
+    end
+    local pressurePlates = ____exports.getPressurePlates(nil)
+    return __TS__ArrayEvery(
+        pressurePlates,
+        function(____, pressurePlate) return pressurePlate.State == PressurePlateState.PRESSURE_PLATE_PRESSED end
+    )
+end
+return ____exports

package/dist/functions/input.d.ts

@@ -0,0 +1,33 @@
+import { ButtonAction, Controller, Keyboard } from "isaac-typescript-definitions";
+/** Helper function to get the enum name for the specified `Controller` value. */
+export declare function controllerToString(controller: Controller): string;
+export declare function getMoveActions(): Set<ButtonAction>;
+export declare function getShootActions(): Set<ButtonAction>;
+/** Iterates over all inputs to determine if a particular button is pressed (i.e. held down). */
+export declare function isActionPressedOnAnyInput(buttonAction: ButtonAction): boolean;
+/**
+ * Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
+ * then released).
+ */
+export declare function isActionTriggeredOnAnyInput(buttonAction: ButtonAction): boolean;
+/**
+ * Helper function to see if a particular keyboard key is being pressed down by the player.
+ *
+ * This function is variadic, meaning you can pass as many keyboard values as you want to check for.
+ * This function will return true if any of the values are pressed.
+ */
+export declare function isKeyboardPressed(...keys: Keyboard[]): boolean;
+/**
+ * Helper function to check if one or more modifier keys are being pressed down on the keyboard.
+ *
+ * A modifier key is defined as shift, control, alt, or Windows.
+ */
+export declare function isModifierKeyPressed(): boolean;
+export declare function isMoveAction(buttonAction: ButtonAction): boolean;
+export declare function isMoveActionPressedOnAnyInput(): boolean;
+export declare function isMoveActionTriggeredOnAnyInput(): boolean;
+export declare function isShootAction(buttonAction: ButtonAction): boolean;
+export declare function isShootActionPressedOnAnyInput(): boolean;
+export declare function isShootActionTriggeredOnAnyInput(): boolean;
+export declare function keyboardToString(keyboard: Keyboard): string;
+//# sourceMappingURL=input.d.ts.map

package/dist/functions/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../../packages/isaacscript-common/src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EAEV,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAuCtC,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAOjE;AAED,wBAAgB,cAAc,IAAI,GAAG,CAAC,YAAY,CAAC,CAElD;AAED,wBAAgB,eAAe,IAAI,GAAG,CAAC,YAAY,CAAC,CAEnD;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAK7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,GACzB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE3D"}