isaacscript-common 1.2.278 → 1.2.281

package/dist/functions/entity.d.ts

@@ -5,9 +5,9 @@ import { AnyEntity } from "../types/AnyEntity";
  * `Isaac.CountEntities` method to avoid having to specify a spawner and to handle ignoring charmed
  * enemies.
  *
- * @param entityType Default is -1.
- * @param variant Default is -1.
- * @param subType Default is -1.
+ * @param entityType Default is -1. -1 matches every entity type.
+ * @param variant Default is -1. -1 matches every variant.
+ * @param subType Default is -1. -1 matches every sub-type.
  * @param ignoreFriendly Default is false.
  */
 export declare function countEntities(entityType?: EntityType | int, variant?: number, subType?: number, ignoreFriendly?: boolean): int;
@@ -41,8 +41,10 @@ export declare function getClosestEntityTo<T extends AnyEntity>(referenceEntity:
  *
  * @param entityType Optional. If specified, will only return NPCs that match this entity
  * type.
- * @param variant Optional. If specified, will only return NPCs that match this variant.
- * @param subType Optional. If specified, will only return NPCs that match this sub-type.
+ * @param variant Optional. If specified, will only return NPCs that match this variant. Default is
+ * -1. -1 matches every variant.
+ * @param subType Optional. If specified, will only return NPCs that match this sub-type. Default is
+ * -1. -1 matches every sub-type.
  * @param ignoreFriendly Optional. If set to true, it will exclude friendly NPCs from being
  * returned. Default is false. Will only be taken into account if `matchingEntityType` is specified.
  */
@@ -89,10 +91,8 @@ export declare function parseEntityTypeVariantString(entityTypeVariantString: st
  * Helper function to remove all of the matching entities in the room.
  *
  * @param entityType The entity type to match.
- * @param entityVariant Optional. The variant to match. Default is -1 (which will match every
- * variant).
- * @param entitySubType Optional. The sub-type to match. Default is -1 (which will match every
- * sub-type).
+ * @param entityVariant Optional. The variant to match. Default is -1. -1 matches every variant.
+ * @param entitySubType Optional. The sub-type to match. Default is -1. -1 matches every sub-type.
  * @param cap Optional. If specified, will only remove the given amount of collectibles.
  * @returns True if one or more entities were removed, false otherwise.
  */

package/dist/functions/rooms.d.ts

@@ -32,13 +32,22 @@ export declare function getRoomGridIndexesForType(...roomTypes: RoomType[]): int
 export declare function getRoomItemPoolType(): ItemPoolType;
 /**
  * Helper function to get the room descriptor for every room on the level. Uses the `Level.GetRooms`
- * method to accomplish this.
+ * method to accomplish this. Rooms without data are assumed to be non-existent and are not added to
+ * the list.
  *
  * @param includeExtraDimensionalRooms Optional. On some floors (e.g. Downpour 2, Mines 2),
  * extra-dimensional rooms are automatically be generated and can be seen when you iterate over the
  * `RoomList`. Default is false.
  */
 export declare function getRooms(includeExtraDimensionalRooms?: boolean): RoomDescriptor[];
+/**
+ * Helper function to get the room descriptor for every room on the level in a specific dimension.
+ * Uses the `Level.GetRooms` method to accomplish this. Rooms without data are assumed to be
+ * non-existent and are not added to the list.
+ *
+ * @returns A map of room ListIndex to RoomDescriptor.
+ */
+export declare function getRoomsOfDimension(dimension: Dimension): RoomDescriptor[];
 /**
  * Helper function to determine if the current room shape is equal to `RoomShape.ROOMSHAPE_1x2` or
  * `RoomShape.ROOMSHAPE_2x1`.

package/dist/functions/rooms.lua

@@ -3,9 +3,10 @@ local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local Map = ____lualib.Map
+local __TS__Spread = ____lualib.__TS__Spread
 local __TS__StringIncludes = ____lualib.__TS__StringIncludes
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
-local Map = ____lualib.Map
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
@@ -47,14 +48,14 @@ function ____exports.getRooms(self, includeExtraDimensionalRooms)
     end
     local level = game:GetLevel()
     local roomList = level:GetRooms()
-    local rooms = {}
+    local roomsMap = __TS__New(Map)
     if includeExtraDimensionalRooms then
         do
             local i = 0
             while i < roomList.Size do
                 local roomDescriptor = roomList:Get(i)
-                if roomDescriptor ~= nil then
-                    rooms[#rooms + 1] = roomDescriptor
+                if roomDescriptor ~= nil and roomDescriptor.Data ~= nil then
+                    roomsMap:set(roomDescriptor.ListIndex, roomDescriptor)
                 end
                 i = i + 1
             end
@@ -64,14 +65,14 @@ function ____exports.getRooms(self, includeExtraDimensionalRooms)
             local i = 0
             while i <= MAX_ROOM_INDEX do
                 local roomDescriptor = level:GetRoomByIdx(i)
-                if roomDescriptor ~= nil then
-                    rooms[#rooms + 1] = roomDescriptor
+                if roomDescriptor.Data ~= nil then
+                    roomsMap:set(roomDescriptor.ListIndex, roomDescriptor)
                 end
                 i = i + 1
             end
         end
     end
-    return rooms
+    return {__TS__Spread(roomsMap:values())}
 end
 function ____exports.inDeathCertificateArea(self)
     local roomStageID = getRoomStageID(nil)
@@ -134,6 +135,21 @@ function ____exports.getRoomItemPoolType(self)
     local roomSeed = room:GetSpawnSeed()
     return itemPool:GetPoolForRoom(roomType, roomSeed)
 end
+function ____exports.getRoomsOfDimension(self, dimension)
+    local level = game:GetLevel()
+    local roomsMap = __TS__New(Map)
+    do
+        local i = 0
+        while i <= MAX_ROOM_INDEX do
+            local roomDescriptor = level:GetRoomByIdx(i, dimension)
+            if roomDescriptor.Data ~= nil then
+                roomsMap:set(roomDescriptor.ListIndex, roomDescriptor)
+            end
+            i = i + 1
+        end
+    end
+    return {__TS__Spread(roomsMap:values())}
+end
 function ____exports.in2x1Room(self)
     local room = game:GetRoom()
     local roomShape = room:GetRoomShape()
@@ -274,12 +290,12 @@ function ____exports.setRoomCleared(self)
     for ____, door in ipairs(getDoors(nil)) do
         do
             if isHiddenSecretRoomDoor(nil, door) then
-                goto __continue52
+                goto __continue55
             end
             openDoorFast(nil, door)
             door.ExtraVisible = false
         end
-        ::__continue52::
+        ::__continue55::
     end
     sfxManager:Stop(SoundEffect.SOUND_DOOR_HEAVY_OPEN)
     game:ShakeScreen(0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.278",
+  "version": "1.2.281",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,9 +25,9 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.392",
+    "isaac-typescript-definitions": "^1.0.393",
     "isaacscript-lint": "^1.0.99",
-    "isaacscript-tsconfig": "^1.1.8",
+    "isaacscript-tsconfig": "^1.1.9",
     "typedoc": "^0.22.15",
     "typescript": "4.6.3",
     "typescript-to-lua": "^1.4.3"